Interface Documentation:

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

The methods are quite simple, with the more commonly used methods as follows:

  1. Timestamp is used to obtain the current timestamp, while TimestampMilli, TimestampMicro, and TimestampNano are used to get the current millisecond, microsecond, and nanosecond values.
  2. Date and Datetime are used to obtain the current date and current date-time.
  3. SetTimeZone is used to set the global timezone for the current process.
  4. For descriptions of other methods, please refer to the interface documentation.

Example 1: Basic Usage

Create a time object and get the current timestamp.

  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. }

After execution, the output is:

  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

Example 2: StrToTime

In addition to using the New method, you can also use StrToTime to parse common time strings into a gtime.Time object. Common time strings include:

  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. Date connectors support '-', '/', '.'

Usage example:

  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. }

In this example, some time strings are converted to gtime.Time objects using the StrToTime method, and both the UTC time and CST time (Shanghai timezone time) of the event are output. After execution, the output is:

  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