Skip to end of metadata
Go to start of metadata

接口文档:

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

方法比较简单,比较常用的是以下几个方法:

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

示例1,基本使用

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

package main

import (
    "fmt"
    "github.com/gogf/gf/v2/os/gtime"
)

func main() {
    fmt.Println("Date       :", gtime.Date())
    fmt.Println("Datetime   :", gtime.Datetime())
    fmt.Println("Second     :", gtime.Timestamp())
    fmt.Println("Millisecond:", gtime.TimestampMilli())
    fmt.Println("Microsecond:", gtime.TimestampMicro())
    fmt.Println("Nanosecond :", gtime.TimestampNano())
}

执行后,输出结果为:

Date       : 2018-07-22
Datetime   : 2018-07-22 11:52:22
Second     : 1532231542
Millisecond: 1532231542688
Microsecond: 1532231542688688
Nanosecond : 1532231542688690259

示例2,设置时区

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

package main

import (
    "fmt"
    "github.com/gogf/gf/v2/os/gtime"
    "time"
)

func main() {
    // 先使用标准库打印当前时间
    fmt.Println(time.Now().String())
    // 设置进程全局时区
    err := gtime.SetTimeZone("Asia/Tokyo")
    if err != nil {
        panic(err)
    }
    // 使用gtime获取当前时间
    fmt.Println(gtime.Now().String())
    // 使用标准库获取当前时间
    fmt.Println(time.Now().String())
}

执行后,输出结果为:

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

示例3,StrToTime

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

2017-12-14 04:51:34 +0805 LMT
2017-12-14 04:51:34 +0805 LMT
2006-01-02T15:04:05Z07:00
2014-01-17T01:19:15+08:00
2018-02-09T20:46:17.897Z
2018-02-09 20:46:17.897
2018-02-09T20:46:17Z
2018-02-09 20:46:17
2018/10/31 - 16:38:46
2018-02-09
2018.02.09

01-Nov-2018 11:50:28
01/Nov/2018 11:50:28
01.Nov.2018 11:50:28
01.Nov.2018:11:50:28
日期连接符号支持'-'、'/'、'.'

使用示例:

package main

import (
	"fmt"
	"github.com/gogf/gf/v2/os/glog"
	"github.com/gogf/gf/v2/os/gtime"
	"time"
)

func main() {
	array := []string{
		"2017-12-14 04:51:34 +0805 LMT",
		"2006-01-02T15:04:05Z07:00",
		"2014-01-17T01:19:15+08:00",
		"2018-02-09T20:46:17.897Z",
		"2018-02-09 20:46:17.897",
		"2018-02-09T20:46:17Z",
		"2018-02-09 20:46:17",
		"2018.02.09 20:46:17",
		"2018-02-09",
		"2017/12/14 04:51:34 +0805 LMT",
		"2018/02/09 12:00:15",
		"01/Nov/2018:13:28:13 +0800",
		"01-Nov-2018 11:50:28 +0805 LMT",
		"01-Nov-2018T15:04:05Z07:00",
		"01-Nov-2018T01:19:15+08:00",
		"01-Nov-2018 11:50:28 +0805 LMT",
		"01/Nov/2018 11:50:28",
		"01/Nov/2018:11:50:28",
		"01.Nov.2018:11:50:28",
		"01/Nov/2018",
	}
	cstLocal, _ := time.LoadLocation("Asia/Shanghai")
	for _, s := range array {
		if t, err := gtime.StrToTime(s); err == nil {
			fmt.Println(s)
			fmt.Println(t.UTC().String())
			fmt.Println(t.In(cstLocal).String())
		} else {
			glog.Error(s, err)
		}
		fmt.Println()
	}
}

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

2017-12-14 04:51:34 +0805 LMT
2017-12-13 20:46:34
2017-12-14 04:46:34 +0800 CST

2006-01-02T15:04:05Z07:00
2006-01-02 22:04:05
2006-01-03 06:04:05 +0800 CST

2014-01-17T01:19:15+08:00
2014-01-16 17:19:15
2014-01-17 01:19:15 +0800 CST

2018-02-09T20:46:17.897Z
2018-02-09 20:46:17
2018-02-10 04:46:17.897 +0800 CST

2018-02-09 20:46:17.897
2018-02-09 12:46:17
2018-02-09 20:46:17.897 +0800 CST

2018-02-09T20:46:17Z
2018-02-09 20:46:17
2018-02-10 04:46:17 +0800 CST

2018-02-09 20:46:17
2018-02-09 12:46:17
2018-02-09 20:46:17 +0800 CST

2018.02.09 20:46:17
2018-02-09 12:46:17
2018-02-09 20:46:17 +0800 CST

2018-02-09
2018-02-08 16:00:00
2018-02-09 00:00:00 +0800 CST

2017/12/14 04:51:34 +0805 LMT
2017-12-13 20:46:34
2017-12-14 04:46:34 +0800 CST

2018/02/09 12:00:15
2018-02-09 04:00:15
2018-02-09 12:00:15 +0800 CST

01/Nov/2018:13:28:13 +0800
2018-11-01 05:28:13
2018-11-01 13:28:13 +0800 CST

01-Nov-2018 11:50:28 +0805 LMT
2018-11-01 03:45:28
2018-11-01 11:45:28 +0800 CST

01-Nov-2018T15:04:05Z07:00
2018-11-01 22:04:05
2018-11-02 06:04:05 +0800 CST

01-Nov-2018T01:19:15+08:00
2018-10-31 17:19:15
2018-11-01 01:19:15 +0800 CST

01-Nov-2018 11:50:28 +0805 LMT
2018-11-01 03:45:28
2018-11-01 11:45:28 +0800 CST

01/Nov/2018 11:50:28
2018-11-01 03:50:28
2018-11-01 11:50:28 +0800 CST

01/Nov/2018:11:50:28
2018-11-01 03:50:28
2018-11-01 11:50:28 +0800 CST

01.Nov.2018:11:50:28
2018-11-01 03:50:28
2018-11-01 11:50:28 +0800 CST

01/Nov/2018
2018-10-31 16:00:00
2018-11-01 00:00:00 +0800 CST
Content Menu

  • No labels

4 Comments


  1. gtime.SetTimeZone

    即使是在v2版本的main函数中执行,也没有生效

    只有修改了

    time.Local = time.FixedZone("CST", 8*3600)
    才能设定时区,不知道是只有我这样吗?
    1. 我也遇到这个问题,gtime.SetTimeZone 未生效。

      	gtime.SetTimeZone("Asia/Shanghai")
      	fmt.Println(gtime.Datetime())
      
      	gtime.SetTimeZone("Asia/Tokyo")
      	fmt.Println(gtime.Datetime())
      	// Output:
      	// 2022-02-16 23:08:39
      	// 2022-02-16 23:08:39


      查看 gtime.SetTimeZone 源码

      func SetTimeZone(zone string) (err error) {
      	location, err := time.LoadLocation(zone)
      	if err != nil {
      		err = gerror.Wrapf(err, `time.LoadLocation failed for zone "%s"`, zone)
      		return err
      	}
      	var (
      		envKey   = "TZ"
      		envValue = location.String()
      	)
      	if err = os.Setenv(envKey, envValue); err != nil {
      		err = gerror.Wrapf(err, `set environment failed with key "%s", value "%s"`, envKey, envValue)
      	}
      	return
      }

      当前线程中使用 os.Setenv() 设置了 ENV “TZ”,但在 gtime 包下的其他方法中,并没有利用这个 ENV “TZ” 做额外处理。


      1. 请问有没有什么解决的方法吗


        1. 看了@王俊玺 贴的代码,可以看出 time 是通过 os.Setenv() 来修改系统的时区变量(windows 下无效),来起到全局更改时区的作用。
          页面中有提示:
          时区的全局设置必须要在标准库的timeimport之前调用。
          网上也可以搜索到相关的问题:
          go - Setting timezone globally in golang - Stack Overflow
          如果直接按示例代码来测试,因为示例代码中先执行了“ fmt.Println(time.Now().String()) ”,导致标准库的time包先调用的,所以后续进行的时区修改是无效的。注释掉这行后,在 linux 环境中测试时可以生效的。Stack Overflow 中还提到一种方式就是单独建立一个时区初始化的包,在最开始的时候 import

          不过感觉为了兼容 windows ,还是用下面这种方式好一些

          var cstSh, _ = time.LoadLocation("Asia/Shanghai") //上海
          fmt.Println("SH : ", time.Now().In(cstSh).Format("2006-01-02 15:04:05"))

          gtime 封装的 time,也支持 In 这种用法。gtime.Now().In(cstSh)