一篇文章帶你搞懂Go語言標準庫Time

2022-10-06 14:05:34

前言

在程式設計過程中，我們經常會用到與時間和日期相關的各種需求，下面來介紹 Go 語言中有關時間的一些基本用法。

時間型別

time.Time 型別表示時間。可以通過 time.Now() 函數獲取當前的時間物件，然後獲取時間物件的年月日時分秒等資訊。

範例程式碼如下：

func main() {
  now := time.Now() //獲取當前時間
  fmt.Printf("當前時間:%vn", now)
  //當前時間:2021-12-26 09:38:42.334358833 +0000 UTC m=+0.000056108
	
  year := now.Year()     //年
  month := now.Month()   //月
  day := now.Day()       //日
  hour := now.Hour()     //小時
  minute := now.Minute() //分鐘
  second := now.Second() //秒
  fmt.Printf("%d-%02d-%02d %02d:%02d:%02dn", year, month, day, hour, minute, second)
  fmt.Printf("%T,%T,%T,%T,%T,%T,%Tn", now, year, month, day, hour, minute, second)
  //time.Time,int,time.Month,int,int,int,int
}

時間戳

時間戳是自1970年1月1日（08:00:00GMT）至當前時間的總毫秒數。它也被稱為Unix時間戳（UnixTimestamp）。在 GoLang 中,獲取時間戳的操作如下：

func main() {
  now := time.Now()            //獲取當前時間
  timestamp1 := now.Unix()     //時間戳
  timestamp2 := now.UnixNano() //納秒時間戳
  fmt.Printf("current timestamp1:%vn", timestamp1)
  fmt.Printf("current timestamp2:%vn", timestamp2)
}

可以通過 time.Unix來直接將時間戳轉化為當前時間格式。

func main() {
  timestamp := time.Now().Unix()
  timeObj := time.Unix(timestamp, 0) //將時間戳轉為時間格式
  fmt.Println(timeObj) //2021-12-26 09:47:39 +0000 UTC
  year := timeObj.Year()     //年
  month := timeObj.Month()   //月
  day := timeObj.Day()       //日
  hour := timeObj.Hour()     //小時
  minute := timeObj.Minute() //分鐘
  second := timeObj.Second() //秒
  fmt.Printf("%d-%02d-%02d %02d:%02d:%02dn", year, month, day, hour, minute, second) //2021-12-26 09:47:39
}

時間間隔

time.Duration是time包定義的一個型別，它代表兩個時間點之間經過的時間，以納秒為單位。time.Duration表示一段時間間隔，可表示的最長時間段大約290年。

time包中定義的時間間隔型別的常數如下：

const (
    Nanosecond  Duration = 1
    Microsecond          = 1000 * Nanosecond
    Millisecond          = 1000 * Microsecond
    Second               = 1000 * Millisecond
    Minute               = 60 * Second
    Hour                 = 60 * Minute
)

例如：time.Duration表示1納秒，time.Second表示1秒。

操作時間

Add

對於時間+時間間隔的需求，我們可以使用 Add 方法如下：

func (t Time) Add(d Duration) Time

func main() {
	now := time.Now()
	fmt.Println(now)
	
	h := time.Duration(1)
	m := time.Duration(2)
	s := time.Duration(3)
	// 當前時間加1小時2分3秒後的時間
	later := now.Add(time.Hour*h + time.Minute*m + time.Second*s) 
	fmt.Println(later)
}

注意在這裡並不能增加年月日，僅能增加時分秒,也就是時間間隔 time.Duration 型別中的常數。

Sub

求兩個時間之間的差值：

func (t Time) Sub(u Time) Duration

返回一個時間段t-u。如果結果超出了Duration可以表示的最大值/最小值，將返回最大值/最小值。要獲取時間點t-d（d為Duration），可以使用t.Add(-d)。

func main() {
  now := time.Now()
  fmt.Println(now)
	
  targetTime := now.Add(time.Hour)
  // 目標時間與此時相比相差1h0m0s
  fmt.Println(targetTime.Sub(now)) //1h0m0s
	
  before := now.Add(time.Hour*-1) // 當前時間減1小時後的時間
  fmt.Println(before)
}

Equal

func (t Time) Equal(u Time) bool

判斷兩個時間是否相同，會考慮時區的影響，因此不同時區標準的時間也可以正確比較。和用 t==u 不同的是，這種方法還會比較地點和時區資訊。

Before

func (t Time) Before(u Time) bool

如果t代表的時間點在u之前，返回真；否則返回假。

After

func (t Time) After(u Time) bool

如果 t 代表的時間點在 u 之後，返回真；否則返回假。

定時器

使用time.Tick(時間間隔)來設定定時器。

func main() {
  ticker := time.Tick(time.Second) //定義一個1秒間隔的定時器
  for i := range ticker {
    fmt.Println(i)//每秒都會執行的任務
  }
}

時間格式化

時間型別有一個自帶的方法Format進行格式化，需要注意的是 Go 語言中格式化時間模板不是常見的Y-m-d H:M:S而是使用 Go 的誕生時間2006年1月2號15點04分（記憶口訣為2006 1 2 3 4）。

func main() {
    now := time.Now()
    // 格式化的模板為Go的出生時間2006年1月2號15點04分 Mon Jan
    // 24小時制
    fmt.Println(now.Format("2006-01-02 15:04:05.000 Mon Jan"))
    // 12小時制
    fmt.Println(now.Format("2006-01-02 03:04:05.000 PM Mon Jan"))
    fmt.Println(now.Format("2006/01/02 15:04"))
    fmt.Println(now.Format("15:04 2006/01/02"))
    fmt.Println(now.Format("2006/01/02"))
}

解析字串格式的時間

now := time.Now()
fmt.Println(now)
// 載入時區
loc, err := time.LoadLocation("Asia/Shanghai")
if err != nil {
    fmt.Println(err)
    return
}
// 按照指定時區和指定格式解析字串時間
timeObj, err := time.ParseInLocation("2006/01/02 15:04:05", "2021/12/27 18:48:44", loc)
if err != nil {
    fmt.Println(err)
    return
}
fmt.Println(timeObj)
fmt.Println(timeObj.Sub(now))