golang package time 用法详解

在咱们编程过程当中，常常会用到与时间相关的各类务需求，下面来介绍 golang 中有关时间的一些基本用法,咱们从 time 的几种 type 来开始介绍。

时间可分为时间点与时间段，golang 也不例外，提供了如下两种基础类型

• 时间点(Time)
• 时间段(Duration)

除此以外 golang 也提供了如下类型，作一些特定的业务

• 时区(Location)
• Ticker
• Timer(定时器)

咱们将按以上顺序来介绍 time 包的使用。

时间点(Time)

咱们使用的全部与时间相关的业务都是基于点而延伸的，两点组成一个时间段，大多数应用也都是围绕这些点与面去作逻辑处理。

初始化

go 针对不一样的参数类型提供了如下初始化的方式

// func Now() Time
      fmt.Println(time.Now())

      // func Parse(layout, value string) (Time, error)
      time.Parse("2016-01-02 15:04:05", "2018-04-23 12:24:51")

      // func ParseInLocation(layout, value string, loc *Location) (Time, error) (layout已带时区时可直接用Parse)
      time.ParseInLocation("2006-01-02 15:04:05", "2017-05-11 14:06:06", time.Local)

      // func Unix(sec int64, nsec int64) Time
      time.Unix(1e9, 0)

      // func Date(year int, month Month, day, hour, min, sec, nsec int, loc *Location) Time
      time.Date(2018, 1, 2, 15, 30, 10, 0, time.Local)

      // func (t Time) In(loc *Location) Time 当前时间对应指定时区的时间
      loc, _ := time.LoadLocation("America/Los_Angeles")
      fmt.Println(time.Now().In(loc))

      // func (t Time) Local() Time
复制代码

获取到时间点以后为了知足业务和设计，须要转换成咱们须要的格式，也就是所谓的时间格式化。

格式化

to string

格式化为字符串咱们须要使用 time.Format 方法来转换成咱们想要的格式

fmt.Println(time.Now().Format("2006-01-02 15:04:05"))  // 2018-04-24 10:11:20
      fmt.Println(time.Now().Format(time.UnixDate))         // Tue Apr 24 09:59:02 CST 2018
复制代码

Format 函数中能够指定你想使用的格式，同时 time 包中也给了一些咱们经常使用的格式

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"
)     
复制代码

注意: galang 中指定的特定时间格式为 "2006-01-02 15:04:05 -0700 MST"， 为了记忆方便，按照美式时间格式 月日时分秒年 外加时区 排列起来依次是 01/02 03:04:05PM ‘06 -0700，刚开始使用时须要注意。

to time stamp

func (t Time) Unix() int64
      func (t Time) UnixNano() int64

      fmt.Println(time.Now().Unix())

      // 获取指定日期的时间戳
      dt, _ := time.Parse("2016-01-02 15:04:05", "2018-04-23 12:24:51")
      fmt.Println(dt.Unix())

      fmt.Println(time.Date(2018, 1,2,15,30,10,0, time.Local).Unix())
复制代码

其余

time 包还提供了一些经常使用的方法，基本覆盖了大多数业务，从方法名就能知道表明的含义就不一一说明了。

func (t Time) Date() (year int, month Month, day int) func (t Time) Clock() (hour, min, sec int) func (t Time) Year() int func (t Time) Month() Month func (t Time) Day() int func (t Time) Hour() int func (t Time) Minute() int func (t Time) Second() int func (t Time) Nanosecond() int func (t Time) YearDay() int func (t Time) Weekday() Weekday func (t Time) ISOWeek() (year, week int) func (t Time) IsZero() bool func (t Time) Local() Time func (t Time) Location() *Location func (t Time) Zone() (name string, offset int) func (t Time) Unix() int64 复制代码

时间段(Duartion)

介绍完了时间点，咱们再来介绍时间段，即 Duartion 类型， 咱们业务也是很经常使用的类型。

// func ParseDuration(s string) (Duration, error)
      tp, _ := time.ParseDuration("1.5s")
      fmt.Println(tp.Truncate(1000), tp.Seconds(), tp.Nanoseconds())

      func (d Duration) Hours() float64 func (d Duration) Minutes() float64 func (d Duration) Seconds() float64 func (d Duration) Nanoseconds() int64 func (d Duration) Round(m Duration) Duration // 四舍五入 func (d Duration) Truncate(m Duration) Duration // 向下取整 复制代码

时区(Location)

咱们在来介绍一下时区的相关的函数

// 默认UTC 
    loc, err := time.LoadLocation("") 
    // 服务器设定的时区，通常为CST
    loc, err := time.LoadLocation("Local")
    // 美国洛杉矶PDT
    loc, err := time.LoadLocation("America/Los_Angeles")

    // 获取指定时区的时间点
    local, _ := time.LoadLocation("America/Los_Angeles")
    fmt.Println(time.Date(2018,1,1,12,0,0,0, local))
复制代码

能够在 $GOROOT/lib/time/zoneinfo.zip 文件下看到全部时区。

时间运算

好了，基础的类型咱们介绍完，如今开始时间运算相关的函数，也是平常业务中咱们大量应用的。

// func Sleep(d Duration) 休眠多少时间，休眠时处于阻塞状态，后续程序没法执行
      time.Sleep(time.Duration(10) * time.Second)

      // func After(d Duration) <-chan Time 非阻塞,可用于延迟
      time.After(time.Duration(10) * time.Second)

      // func Since(t Time) Duration 两个时间点的间隔
      start := time.Now()
      fmt.Println(time.Since(start))   // 等价于 Now().Sub(t)， 可用来计算一段业务的消耗时间

      func Until(t Time) Duration // 等价于 t.Sub(Now())，t与当前时间的间隔 // func (t Time) Add(d Duration) Time fmt.Println(dt.Add(time.Duration(10) * time.Second)) // 加 func (t Time) Sub(u Time) Duration // 减 // func (t Time) AddDate(years int, months int, days int) Time fmt.Println(dt.AddDate(1, 1, 1)) // func (t Time) Before(u Time) bool // func (t Time) After(u Time) bool // func (t Time) Equal(u Time) bool 比较时间点时尽可能使用Equal函数 复制代码

咱们大概就介绍完了多数涉及时间点与时间段的函数，接下面咱们经过一些使用场景来作一些演示。

使用场景

日期时间差

dt1 := time.Date(2018, 1, 10, 0, 0, 1, 100, time.Local)
      dt2 := time.Date(2018, 1, 9, 23, 59, 22, 100, time.Local)
      // 不用关注时区，go会转换成时间戳进行计算
      fmt.Println(dt1.Sub(dt2))        
复制代码

基于当前时间的先后运算

now := time.Now()

      // 一年零一个月一天以后
      fmt.Println(now.Date(1,1,1))
      // 一段时间以后
      fmt.Println(now.Add(time.Duration(10)*time.Minute))

      // 计算两个时间点的相差天数
      dt1 = time.Date(dt1.Year(), dt1.Month(), dt1.Day(), 0, 0, 0, 0, time.Local)
      dt2 = time.Date(dt2.Year(), dt2.Month(), dt2.Day(), 0, 0, 0, 0, time.Local)
      fmt.Println(int(math.Ceil(dt1.Sub(dt2).Hours() / 24)))
复制代码

时区转换

// time.Local 用来表示当前服务器时区
      // 自定义地区时间
      secondsEastOfUTC := int((8 * time.Hour).Seconds())
      beijing := time.FixedZone("Beijing Time", secondsEastOfUTC)
      fmt.Println(time.Date(2018,1,2,0,0,0,0, beijing))  // 2018-01-02 00:00:00 +0800 Beijing Time 

      // 当前时间转为指定时区时间
      fmt.Println(time.Now().In(beijing))

      // 指定时间转换成指定时区对应的时间
      dt, err := time.ParseInLocation("2006-01-02 15:04:05", "2017-05-11 14:06:06", time.Local)

      // 当前时间在零时区年月日 时分秒 时区
      year, mon, day := time.Now().UTC().Date()     // 2018 April 24 
      hour, min, sec := time.Now().UTC().Clock()    // 3 47 15
      zone, _ := time.Now().UTC().Zone()            // UTC
复制代码

比较两个时间点

dt := time.Date(2018, 1, 10, 0, 0, 1, 100, time.Local)
      fmt.Println(time.Now().After(dt))     // true
      fmt.Println(time.Now().Before(dt))    // false

      // 是否相等 判断两个时间点是否相等时推荐使用 Equal 函数
      fmt.Println(dt.Equal(time.Now()))
复制代码

设置执行时间

经过time.After 函数与 select 结合使用可用于处理程序超时设定

select {
      case m := <- c:
            // do something
      case <- time.After(time.Duration(1)*time.Second):
            fmt.Println("time out")
      }
复制代码

Ticker类型

Ticker 类型包含一个 channel，有时咱们会遇到每隔一段时间执行的业务(好比设置心跳时间等)，就能够用它来处理，这是一个重复的过程

// 没法取消
      tick := time.Tick(1 * time.Minute)
      for _ = range tick {
            // do something
      }

      // 可经过调用ticker.Stop取消
      ticker := time.NewTicker(1 * time.Minute)
      for _ = range tick {
            // do something
      }
复制代码

Timer类型

Timer 类型用来表明一个单独的事件，当设置的时间过时后，发送当前的时间到 channel, 咱们能够经过如下两种方式来建立

func AfterFunc(d Duration, f func()) *Timer // 指定一段时间后指定的函数 func NewTimer(d Duration) *Timer 复制代码

以上两函数均可以使用 Reset, 这个有个须要注意的地方是使用 Reset 时须要确保 t.C 通道被释放时才能调用，以防止发生资源竞争的问题，可经过如下方式解决

if !t.Stop() {
            <-t.C
      }
      t.Reset(d)

复制代码

参考文献

package time

golang积累-时间、时区、格式的使用

论golang Timer Reset方法使用的正确姿式