当前位置 博文首页 > go语言中的Carbon库时间处理技巧

    go语言中的Carbon库时间处理技巧

    作者:是阿凯啊 时间:2021-05-01 18:01

    go语言之Carbon库

    • carbon是一个时间扩展库,它提供了易于使用接口。
    • 简单示例:
    package main
    
    import (
    	"fmt"
    	"github.com/uniplaces/carbon"
    	"time"
    )
    
    func main() {
    	// 打印当前时间
    	now :=carbon.Now().DateTimeString()
    	fmt.Println("本地时间:", now)
    
    	Japantoday, _ := carbon.NowInLocation("Japan")
    	fmt.Println("日本时间:", Japantoday)
    	// 明天
    	tomorrow := carbon.Now().AddDay()
    	fmt.Println(tomorrow)
    	// 上周的今天
    	subweek := carbon.Now().SubWeek()
    	fmt.Println(subweek)
    	nextOlympics, _ := carbon.CreateFromDate(2016, time.August,5,"Europe/London")
    	fmt.Println("2016年奥林匹克运动会:",nextOlympics)
    	nextOlympics = nextOlympics.AddYears(4)
    	fmt.Println("下一次奥林匹克运动会:", nextOlympics.Year())
    	if carbon.Now().IsWeekend() {
    		fmt.Println("休息的一天")
    	} else {
    		fmt.Println("工作日")
    	}
    }

    carbon库非常便捷,它完全兼容time.Time类型,实际上它日期时间类型Carbon直接将time.Time内嵌到结构中,所以time.Time方法可直接调用。

    // The Carbon type represents a Time instance.
    // Provides a simple API extension for Time.
    type Carbon struct {
    	time.Time
    	weekStartsAt time.Weekday
    	weekEndsAt time.Weekday
    	weekendDays []time.Weekday
    	stringFormat string
    	Translator *Translator
    }

    其次,简化了创建操作。标准库time创建一个Time对象,如果不是本地或 UTC 时区,需要自己先调用LoadLocation加载对应时区。然后将该时区对象传给time.Date方法创建。carbon可以直接传时区名字。

    1.时区

    使用go语言time,创建时区需要先加载时区。

    loc, err := time.LoadLocation("Japan")
    if err != nil {
     log.Fatal("failed to load location:", err)
    }
    d := time.Date(2020, time.July,24,20,0,0,0,loc)
    fmt.Println(d) // 2020-07-24 20:00:00 +0900 JST

    使用carbon就简单很多

    loc, err := carbon.Create(2020,time.July,24,20,0,0,0,"Japan")
    if err != nil {
    	log.Fatal(err)
    }
    fmt.Println(loc)// 2020-07-24 20:00:00

    2.时间运算

    now := carbon.Now()
    fmt.Println(now)
    fmt.Println("1秒后:", now.AddSecond())
    fmt.Println("1分钟后:", now.AddMinute())
    fmt.Println("1小时后:", now.AddHour())
    fmt.Println("3分钟20秒后:", now.AddMinutes(3).AddSeconds(20))
    fmt.Println("2小时30分后:", now.AddHours(2).AddMinutes(30))
    fmt.Println("3天2小时后:",now.AddDays(3).AddHours(2))
    • 增加季度的方法:AddQuarters/AddQuarter,复数形式介绍一个表示倍数的参数,单数形式倍数为1;
    • 增加世纪的方法:AddCenturies/AddCentury
    • 增加工作日的方法:AddWeekdays/AddWeekday,这个方法会跳过非工作日;
    • 增加周的方法:AddWeeks/AddWeek

    其实给上面方法传入负数就表示减少,另外carbon也提供了对应的Sub*方法。

    3.时间比较

    carbon计算两个日期之间相差多少秒,份,小时,天:

    vancouver, _ := carbon.Today("Asia/Shanghai")
    london, _ := carbon.Today("Asia/Hong_Kong")
    // 相差秒数
    fmt.Println(vancouver.DiffInSeconds(london, true)) // 0
    ottawa, _ := carbon.CreateFromDate(2000, 1, 1, "America/Toronto")
    vancouver, _ = carbon.CreateFromDate(2000, 1, 1, "America/Vancouver")
    fmt.Println(ottawa.DiffInHours(vancouver, true)) // 3
    fmt.Println(ottawa.DiffInHours(vancouver, false)) // 3
    fmt.Println(vancouver.DiffInHours(ottawa, false)) // -3
    t, _ := carbon.CreateFromDate(2012, 1, 31, "UTC")
    fmt.Println(t.DiffInDays(t.AddMonth(), true)) // 31
    fmt.Println(t.DiffInDays(t.SubMonth(), false)) // -31
    
    t, _ = carbon.CreateFromDate(2012, 4, 30, "UTC")
    fmt.Println(t.DiffInDays(t.AddMonth(), true)) // 30
    fmt.Println(t.DiffInDays(t.AddWeek(), true)) // 7
    
    t, _ = carbon.CreateFromTime(10, 1, 1, 0, "UTC")
    fmt.Println(t.DiffInMinutes(t.AddSeconds(59), true)) // 0
    fmt.Println(t.DiffInMinutes(t.AddSeconds(60), true)) // 1
    fmt.Println(t.DiffInMinutes(t.AddSeconds(119), true)) // 1
    fmt.Println(t.DiffInMinutes(t.AddSeconds(120), true)) // 2

    4.格式化

    我们知道time.Time提供了一个Format方法,相比于其他编程语言使用格式化符来描述格式(需要记忆%d/%m/%h等的含义),Go 提供了一个一种更简单、直观的方式——使用 layout。即我们传入一个日期字符串,表示我们想要格式化成什么样子。Go 会用当前的时间替换字符串中的对应部分:

    package main
    
    import (
     "fmt"
     "time"
    )
    
    func main() {
     t := time.Now()
     fmt.Println(t.Format("2006-01-02 10:00:00"))
    }

    上面我们只需要传入一个2006-01-02 10:00:00表示我们想要的格式为yyyy-mm-dd hh:mm:ss,省去了我们需要记忆的麻烦

    为了使用方便,Go 内置了一些标准的时间格式:

    / src/time/format.go
    const (
     ANSIC  = "Mon Jan _2 15:04:05 2006"
     UnixDate = "Mon Jan _2 15:04:05 MST 2006"
     RubyDate = "Mon Jan 02 15:04:05 -0700 2006"
     RFC822  = "02 Jan 06 15:04 MST"
     RFC822Z  = "02 Jan 06 15:04 -0700"// RFC822 with numeric zone
     RFC850  = "Monday, 02-Jan-06 15:04:05 MST"
     RFC1123  = "Mon, 02 Jan 2006 15:04:05 MST"
     RFC1123Z = "Mon, 02 Jan 2006 15:04:05 -0700"// RFC1123 with numeric zone
     RFC3339  = "2006-01-02T15:04:05Z07:00"
     RFC3339Nano = "2006-01-02T15:04:05.999999999Z07:00"
     Kitchen  = "3:04PM"
     // Handy time stamps.
     Stamp  = "Jan _2 15:04:05"
     StampMilli = "Jan _2 15:04:05.000"
     StampMicro = "Jan _2 15:04:05.000000"
     StampNano = "Jan _2 15:04:05.000000000"
    )

    除了上面这些格式,carbon还提供了其他一些格式:

    const (
     DefaultFormat  = "2006-01-02 15:04:05"
     DateFormat   = "2006-01-02"
     FormattedDateFormat = "Jan 2, 2006"
     TimeFormat   = "15:04:05"
     HourMinuteFormat = "15:04"
     HourFormat   = "15"
     DayDateTimeFormat = "Mon, Aug 2, 2006 3:04 PM"
     CookieFormat  = "Monday, 02-Jan-2006 15:04:05 MST"
     RFC822Format  = "Mon, 02 Jan 06 15:04:05 -0700"
     RFC1036Format  = "Mon, 02 Jan 06 15:04:05 -0700"
     RFC2822Format  = "Mon, 02 Jan 2006 15:04:05 -0700"
     RSSFormat   = "Mon, 02 Jan 2006 15:04:05 -0700"
    )

    5.高级特性

    所谓修饰器(modifier)就是对一些特定的时间操作,获取开始和结束时间。如当天、月、季度、年、十年、世纪、周的开始和结束时间,还能获得上一个周二、下一个周一、下一个工作日的时间等等:

    t := carbon.Now()
    	fmt.Println("今天起始:", t.StartOfDay())
    	fmt.Println("今天终止:", t.EndOfDay())
    	fmt.Println("本月起始:", t.StartOfMonth())
    	fmt.Println("本月终止:", t.EndOfMonth())
    	fmt.Println("本年起始:", t.StartOfYear())
    	fmt.Println("本年终止:", t.EndOfYear())
    	fmt.Println("今年起始日期(年月日时分秒):", t.StartOfDecade())
    	fmt.Println("今年终止日期(年月日时分秒):", t.EndOfDecade())
    	fmt.Println("本世纪起始日期(年月日时分秒):", t.StartOfCentury())
    	fmt.Println("本世纪终止日期(年月日时分秒):", t.EndOfCentury())
    	fmt.Println("本周起始日期(年月日时分秒):", t.StartOfWeek())
    	fmt.Println("本周终止日期(年月日时分秒):", t.EndOfWeek())

    6.自定义工作日和周末

    func main() {
    	t, err := carbon.Create(2020, 02, 11, 0, 0, 0, 0, "Asia/Shanghai")
    	if err != nil {
    		log.Fatal(err)
    	}
    
    	t.SetWeekStartsAt(time.Sunday)
    	t.SetWeekEndsAt(time.Saturday)
    	t.SetWeekendDays([]time.Weekday{time.Monday, time.Tuesday, time.Wednesday})
    
    	fmt.Printf("今天是 %s, weekend? %t\n", t.Weekday(), t.IsWeekend())
    }
    js