接口文档：

https://pkg.go.dev/github.com/gogf/gf/v2/os/gtime

方法比较简单，比较常用的是以下几个方法：

  1. Timestamp用于获得当前时间戳，TimestampMilli、TimestampMicro及TimestampNano用于获得当前的毫秒、微秒和纳秒值。
  2. Date和Datetime用于获得当前日期及当前日期时间。
  3. SetTimeZone用于设置当前进程的全局时区。
  4. 其他方法说明请查看接口文档。

示例1，基本使用

创建时间对象及获取当前时间戳。

  1. package main
  3. import (
  4.     "fmt"
  5.     "github.com/gogf/gf/v2/os/gtime"
  6. )
  8. func main() {
  9.     fmt.Println("Date       :", gtime.Date())
  10.     fmt.Println("Datetime   :", gtime.Datetime())
  11.     fmt.Println("Second     :", gtime.Timestamp())
  12.     fmt.Println("Millisecond:", gtime.TimestampMilli())
  13.     fmt.Println("Microsecond:", gtime.TimestampMicro())
  14.     fmt.Println("Nanosecond :", gtime.TimestampNano())
  15. }

执行后，输出结果为：

  1. Date       : 2018-07-22
  2. Datetime   : 2018-07-22 11:52:22
  3. Second     : 1532231542
  4. Millisecond: 1532231542688
  5. Microsecond: 1532231542688688
  6. Nanosecond : 1532231542688690259

示例2，设置时区

时区的全局设置必须要在标准库的time包import之前调用。

  1. package main
  3. import (
  4.     "fmt"
  5.     "github.com/gogf/gf/v2/os/gtime"
  6.     "time"
  7. )
  9. func main() {
  10.     // 先使用标准库打印当前时间
  11.     fmt.Println(time.Now().String())
  12.     // 设置进程全局时区
  13.     err := gtime.SetTimeZone("Asia/Tokyo")
  14.     if err != nil {
  15.         panic(err)
  16.     }
  17.     // 使用gtime获取当前时间
  18.     fmt.Println(gtime.Now().String())
  19.     // 使用标准库获取当前时间
  20.     fmt.Println(time.Now().String())
  21. }

执行后，输出结果为：

  1. 2018-11-21 22:50:56.723429 +0800 CST m=+0.000649366
  2. 2018-11-21 23:50:56
  3. 2018-11-21 23:50:56.723832 +0900 JST m=+0.001052780

示例3，StrToTime

除了通过New方法外，也可以通过StrToTime根据常见的时间字符串解析生成gtime.Time对象，常见的时间字符串如下：

  1. 2017-12-14 04:51:34 +0805 LMT
  2. 2017-12-14 04:51:34 +0805 LMT
  3. 2006-01-02T15:04:05Z07:00
  4. 2014-01-17T01:19:15+08:00
  5. 2018-02-09T20:46:17.897Z
  6. 2018-02-09 20:46:17.897
  7. 2018-02-09T20:46:17Z
  8. 2018-02-09 20:46:17
  9. 2018/10/31 - 16:38:46
  10. 2018-02-09
  11. 2018.02.09
  13. 01-Nov-2018 11:50:28
  14. 01/Nov/2018 11:50:28
  15. 01.Nov.2018 11:50:28
  16. 01.Nov.2018:11:50:28
  17. 日期连接符号支持'-'、'/'、'.'

使用示例：

  1. package main
  3. import (
  4.     "fmt"
  5.     "github.com/gogf/gf/v2/os/glog"
  6.     "github.com/gogf/gf/v2/os/gtime"
  7.     "time"
  8. )
  10. func main() {
  11.     array := []string{
  12.         "2017-12-14 04:51:34 +0805 LMT",
  13.         "2006-01-02T15:04:05Z07:00",
  14.         "2014-01-17T01:19:15+08:00",
  15.         "2018-02-09T20:46:17.897Z",
  16.         "2018-02-09 20:46:17.897",
  17.         "2018-02-09T20:46:17Z",
  18.         "2018-02-09 20:46:17",
  19.         "2018.02.09 20:46:17",
  20.         "2018-02-09",
  21.         "2017/12/14 04:51:34 +0805 LMT",
  22.         "2018/02/09 12:00:15",
  23.         "01/Nov/2018:13:28:13 +0800",
  24.         "01-Nov-2018 11:50:28 +0805 LMT",
  25.         "01-Nov-2018T15:04:05Z07:00",
  26.         "01-Nov-2018T01:19:15+08:00",
  27.         "01-Nov-2018 11:50:28 +0805 LMT",
  28.         "01/Nov/2018 11:50:28",
  29.         "01/Nov/2018:11:50:28",
  30.         "01.Nov.2018:11:50:28",
  31.         "01/Nov/2018",
  32.     }
  33.     cstLocal, _ := time.LoadLocation("Asia/Shanghai")
  34.     for _, s := range array {
  35.         if t, err := gtime.StrToTime(s); err == nil {
  36.             fmt.Println(s)
  37.             fmt.Println(t.UTC().String())
  38.             fmt.Println(t.In(cstLocal).String())
  39.         } else {
  40.             glog.Error(s, err)
  41.         }
  42.         fmt.Println()
  43.     }
  44. }

在这个示例中，将部分时间格式串使用StrToTime方法转换为gtime.Time对象，并输出该事件的UTC时间和CST时间(上海时区时间)。 执行后，输出结果为：

  1. 2017-12-14 04:51:34 +0805 LMT
  2. 2017-12-13 20:46:34
  3. 2017-12-14 04:46:34 +0800 CST
  5. 2006-01-02T15:04:05Z07:00
  6. 2006-01-02 22:04:05
  7. 2006-01-03 06:04:05 +0800 CST
  9. 2014-01-17T01:19:15+08:00
  10. 2014-01-16 17:19:15
  11. 2014-01-17 01:19:15 +0800 CST
  13. 2018-02-09T20:46:17.897Z
  14. 2018-02-09 20:46:17
  15. 2018-02-10 04:46:17.897 +0800 CST
  17. 2018-02-09 20:46:17.897
  18. 2018-02-09 12:46:17
  19. 2018-02-09 20:46:17.897 +0800 CST
  21. 2018-02-09T20:46:17Z
  22. 2018-02-09 20:46:17
  23. 2018-02-10 04:46:17 +0800 CST
  25. 2018-02-09 20:46:17
  26. 2018-02-09 12:46:17
  27. 2018-02-09 20:46:17 +0800 CST
  29. 2018.02.09 20:46:17
  30. 2018-02-09 12:46:17
  31. 2018-02-09 20:46:17 +0800 CST
  33. 2018-02-09
  34. 2018-02-08 16:00:00
  35. 2018-02-09 00:00:00 +0800 CST
  37. 2017/12/14 04:51:34 +0805 LMT
  38. 2017-12-13 20:46:34
  39. 2017-12-14 04:46:34 +0800 CST
  41. 2018/02/09 12:00:15
  42. 2018-02-09 04:00:15
  43. 2018-02-09 12:00:15 +0800 CST
  45. 01/Nov/2018:13:28:13 +0800
  46. 2018-11-01 05:28:13
  47. 2018-11-01 13:28:13 +0800 CST
  49. 01-Nov-2018 11:50:28 +0805 LMT
  50. 2018-11-01 03:45:28
  51. 2018-11-01 11:45:28 +0800 CST
  53. 01-Nov-2018T15:04:05Z07:00
  54. 2018-11-01 22:04:05
  55. 2018-11-02 06:04:05 +0800 CST
  57. 01-Nov-2018T01:19:15+08:00
  58. 2018-10-31 17:19:15
  59. 2018-11-01 01:19:15 +0800 CST
  61. 01-Nov-2018 11:50:28 +0805 LMT
  62. 2018-11-01 03:45:28
  63. 2018-11-01 11:45:28 +0800 CST
  65. 01/Nov/2018 11:50:28
  66. 2018-11-01 03:50:28
  67. 2018-11-01 11:50:28 +0800 CST
  69. 01/Nov/2018:11:50:28
  70. 2018-11-01 03:50:28
  71. 2018-11-01 11:50:28 +0800 CST
  73. 01.Nov.2018:11:50:28
  74. 2018-11-01 03:50:28
  75. 2018-11-01 11:50:28 +0800 CST
  77. 01/Nov/2018
  78. 2018-10-31 16:00:00
  79. 2018-11-01 00:00:00 +0800 CST