以下是 Go 語言 time 模塊的詳細說明及示例，涵蓋時間操作、定時器、時區處理等核心功能：
一、時間基礎操作
1. 獲取時間
// 當前本地時間
now := time.Now()
fmt.Println(now) // 2023-08-04 15:30:45.123456 +0800 CST// 構造指定時間
t := time.Date(2023, 8, 4, 12, 30, 0, 0, time.UTC)
fmt.Println(t) // 2023-08-04 12:30:00 +0000 UTC
2. 時間戳轉換
// 獲取秒級/毫秒級/納秒級時間戳
sec := now.Unix() // 1691134245
msec := now.UnixMilli()// 1691134245123
nsec := now.UnixNano() // 1691134245123456789// 時間戳轉Time對象
t1 := time.Unix(sec, 0) // 2023-08-04 15:30:45 +0800 CST
二、時間格式化與解析
1. 標準格式化
// 格式化為字符串（固定布局）
fmt.Println(now.Format("2006-01-02 15:04:05")) // 2023-08-04 15:30:45
fmt.Println(now.Format(time.RFC3339)) // 2023-08-04T15:30:45+08:00// 解析時間字符串
t2, _ := time.Parse("2006-01-02", "2023-08-04")
fmt.Println(t2) // 2023-08-04 00:00:00 +0000 UTC
2. 時區處理
// 加載時區
loc, _ := time.LoadLocation("America/New_York")
nyTime := now.In(loc)
fmt.Println(nyTime) // 2023-08-04 03:30:45 -0400 EDT// 創建固定時區
fixedZone := time.FixedZone("CST", 8*3600)
t3 := time.Date(2023, 8, 4, 12, 0, 0, 0, fixedZone)
三、時間運算與比較
1. 時間加減
// 加1小時30分鐘
t4 := now.Add(1*time.Hour + 30*time.Minute)// 計算時間差
duration := t4.Sub(now) // 1h30m0s// 使用時間常量
t5 := now.Add(24 * time.Hour) // 加1天
2. 時間比較
// 判斷時間先后
isAfter := now.After(t3) // true
isBefore := now.Before(t3) // false// 計算相對時間
time.Since(t3) // 已過時間
time.Until(t3) // 剩余時間
四、定時器與周期任務
1. Timer（單次定時）
timer := time.NewTimer(2 * time.Second)
<-timer.C // 阻塞等待2秒
timer.Stop() // 取消未觸發的定時器
2. Ticker（周期觸發）
ticker := time.NewTicker(1 * time.Second)
defer ticker.Stop()for {select {case <-ticker.C:fmt.Println("每秒觸發")case <-time.After(5 * time.Second):return // 5秒后退出}
}
五、其他實用方法
1. 睡眠控制
time.Sleep(100 * time.Millisecond) // 精確睡眠
2. 時間間隔計算
start := time.Now()
// 執行某些操作...
elapsed := time.Since(start) // 計算耗時
fmt.Printf("耗時: %v\n", elapsed)
3. 時間組成部分提取
year := now.Year() // 2023
month := now.Month() // August
day := now.Day() // 4
hour := now.Hour() // 15
minute := now.Minute() // 30
4. 時間周期判斷
// 判斷是否為周末
if now.Weekday() == time.Saturday || now.Weekday() == time.Sunday {fmt.Println("周末")
}
六、特殊時間處理
1. 截止時間控制
ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
defer cancel()select {
case <-ctx.Done():fmt.Println("操作超時")
}
2. 解析持續時間字符串
duration, _ := time.ParseDuration("1h30m40s")
fmt.Println(duration.Hours()) // 1.511111111111111
七、時間格式布局對照表
| 布局字符 | 含義 | 示例 |
|---|---|---|
| 2006 | 年（4位） | 2023 |
| 01 | 月（前導零） | 08 |
| 02 | 日（前導零） | 04 |
| 15 | 時（24小時制） | 15 |
| 04 | 分（前導零） | 05 |
| 05 | 秒（前導零） | 06 |
| .999 | 毫秒（可重復） | .123 |
| MST | 時區縮寫 | CST |
| -0700 | 時區偏移 | +0800 |
八、典型應用場景
1. 接口超時控制
func fetchData() (string, error) {// 模擬網絡請求time.Sleep(2 * time.Second)return "data", nil
}func main() {ctx, cancel := context.WithTimeout(context.Background(), 1*time.Second)defer cancel()select {case result := <-asyncFetch(ctx):fmt.Println(result)case <-ctx.Done():fmt.Println("請求超時")}
}
2. 定時批處理
func batchJob() {ticker := time.NewTicker(5 * time.Minute)for range ticker.C {fmt.Println("執行定時任務:", time.Now().Format("15:04:05"))}
}
time 包是 Go 語言時間處理的基石，熟練掌握其 API 可以高效處理各種時間相關需求。建議結合官方文檔 (pkg.go.dev/time) 進行深入理解。
)
