一文帶你瞭解Go語言中time包的時間常用操作

2022-12-05 14:00:46

前言
Now()：獲取當前原生的時間
獲取具體時間單位的值（yeah、month、day ······）
時間格式化
獲取秒、微秒、毫秒、納秒
通過指定年月日等引數獲取時間
時間戳與時間的轉換
字串轉時間格式
時間的新增和減少操作
計算兩個時間的時間差
計算當前時間與某個時間的時間差
判斷當前時間是否在某個時間之前
判斷當前時間是否在某個時間之後
小結

前言

在日常開發中，我們避免不了時間的使用，我們可能需要獲取當前時間，然後格式化儲存，也可能需要在時間型別與字串型別之間相互轉換等。本文將會對 Go time 包裡面的常用函數和方法進行介紹。

Now()：獲取當前原生的時間

import (
    "fmt"
    "time"
)

func main() {
    now := time.Now()
    fmt.Println(now) // 2022-12-03 21:06:16.1658077 +0800 CST m=+5.936223001
}

Now() 函數返回的是一個 time 包內建的一個結構體 Time。

獲取具體時間單位的值（yeah、month、day ······）

根據 Now() 的返回的 Time 結構體，我們通過其方法可以獲取到具體的時間單位的值，例如年、月、日等等。

import (
    "fmt"
    "time"
)

func main() {
    now := time.Now()
    fmt.Println("年：", now.Year())
    fmt.Println("月：", now.Month())
    fmt.Println("數位格式的月：", int(now.Month()))
    fmt.Println("日：", now.Day())
    fmt.Println("時：", now.Hour())
    fmt.Println("分：", now.Minute())
    fmt.Println("秒：", now.Second())
}

通過 Time 結構體的 Year()、Month()、Day()、Hour()、Minute()、Second() 這些方法，可以獲取到當前時間的年、月、日、時、分、秒的值。

時間格式化

通過 Time 結構體的 Format(layout string) 方法可以將時間轉換成指定格式並以 string 型別返回。

import (
    "fmt"
    "time"
)

func main() {
    now := time.Now()
    format1 := now.Format("2006-01-02 15:04:05")
    format2 := now.Format("2006/01/02 15:04:05")
    format3 := now.Format("2006-01-02")
    format4 := now.Format("2006/01/02")
    format5 := now.Format("15:04:05")

    fmt.Println(format1) // 2022-12-03 22:27:56
    fmt.Println(format2) // 2022/12/03 22:27:56
    fmt.Println(format3) // 2022-12-03
    fmt.Println(format4) // 2022/12/03
    fmt.Println(format5) // 22:27:56
}

其中 layout 格式引數，Go 強制我們使用 2006-01-02 15:04:05 這個固定的值，連線符如 - 可以改變，但是數位不能變，否則時間會對不上。

獲取秒、微秒、毫秒、納秒

import (
    "fmt"
    "time"
)

func main() {
    now := time.Now()
    // 獲取秒
    fmt.Println(now.Unix()) // 1670078476
    // 獲取毫秒
    fmt.Println(now.UnixMilli()) // 1670079987508082
    // 獲取微秒
    fmt.Println(now.UnixMicro()) // 1670079987508082
    // 獲取納秒
    fmt.Println(now.UnixNano()) // 1670079987508082500
}

通過 time 結構體的 Unix()、UnixMilli()、UnixMicro()、UnixNano() 方法可以獲取對應是秒時間戳、毫秒時間戳、微秒時間戳和納秒時間戳。

通過指定年月日等引數獲取時間

import (
    "fmt"
    "time"
)

func main() {
    date := time.Date(2002, 12, 03, 12, 12, 12, 0, time.UTC)
    fmt.Println(date) // 2022-12-03 12:12:12 +0000 UTC
}

通過 Date(year int, month Month, day, hour, min, sec, nsec int, loc *Location) Time 函數，傳入指定的年月日等引數，獲取指定是時間變數。

時間戳與時間的轉換

import (
    "fmt"
    "time"
)

func main() {
    now := time.Now()

    time1 := time.Unix(now.Unix(), 0).Format("2006-01-02 15:04:05")
    time2 := time.UnixMilli(now.UnixMilli()).Format("2006-01-02 15:04:05")
    time3 := time.UnixMicro(now.UnixMicro()).Format("2006-01-02 15:04:05")
    fmt.Println(time1) // 2022-12-03 23:03:33
    fmt.Println(time2) // 2022-12-03 23:03:33
    fmt.Println(time3) // 2022-12-03 23:03:33
}

通過 Unix()、UnixMilli()、和 UnixMicro() 方法可以將對應時間戳轉換成當前時間並格式化。

字串轉時間格式

import (
   "fmt"
   "time"
)

func main() {
   t1, err := time.Parse("2006-01-02 15:04:05", "2022-12-03 13:00:00")
   if err != nil {
      fmt.Println("err: ", err)
      return
   }
   fmt.Println(t1) // 2022-12-03 13:00:00 +0000 UTC

   t2, err := time.Parse("2006-01-02", "2022-12-03")
   if err != nil {
      fmt.Println("err: ", err)
      return
   }
   fmt.Println(t2) // 2022-12-03 00:00:00 +0000 UTC

   t3, err := time.Parse("15:04:05", "13:00:00")
   if err != nil {
      fmt.Println("err: ", err)
      return
   }
   fmt.Println(t3) // 0000-01-01 13:00:00 +0000 UTC
}

通過 Parse(layout, value string) (Time, error) 函數將字串轉成 time 時間。layout 格式必須與 value 的格式相對應，否則會返回 error。

時間的新增和減少操作

import (
    "fmt"
    "time"
)

func main() {
    now := time.Now()
    newTime := now.Add(time.Hour * 1)
    fmt.Println(newTime.Format("2006-01-02 15:04:05"))
}

通過 (t Time) Add(d Duration) Time 方法，可以對時間進行新增或減少操作，傳入的引數是正數表示新增，負數表示減少。新增單位有天、小時、分鐘等。
Duration 表示所新增的時間，time.Hour 表示小時單位，除此之外還有 time.Minute 分鐘單位、time.Second 秒單位等。

計算兩個時間的時間差

import (
    "fmt"
    "time"
)

func main() {
    now := time.Now()
    newTime := now.Add(time.Hour * 1)
    fmt.Println(newTime.Sub(now)) // 1h0m0s
}

通過 Sub(u Time) Duration 方法可以計算兩個時間的時間差。

計算當前時間與某個時間的時間差

import (
    "fmt"
    "time"
)

func main() {
    beforeTime := time.Now().Add(time.Hour * -1)
    fmt.Println(time.Since(beforeTime)) // 1h0m0s
}

通過 Add(d Duration) Time 方法將當前時間減少一小時，然後通過 Since(t Time) Duration 函數比較當前時間與其他時間的時間差。

判斷當前時間是否在某個時間之前

import (
    "fmt"
    "time"
)

func main() {
    now := time.Now()
    date := time.Date(2022, 12, 03, 12, 12, 12, 0, time.UTC)
    fmt.Println(now.Before(date)) // false
}

通過 Before(u Time) bool #方法，判斷當前的時間是否在傳入的時間之前，返回值為布林值，true 為是，false 為否。

判斷當前時間是否在某個時間之後

import (
    "fmt"
    "time"
)

func main() {
    now := time.Now()
    date := time.Date(2022, 12, 03, 12, 12, 12, 0, time.UTC)
    fmt.Println(now.After(date)) // true
}

通過 After(u Time) bool 方法，判斷當前的時間是否在傳入的時間之後，返回值為布林值，true 為是，false 為否。