[golang] time.Duration 詳解

在 Go (Golang) 中，time.Duration 是 time 包中的一個類型，用於表示時間間隔。time.Duration 是一個整數類型，底層使用 int64 表示時間的納秒數（nanoseconds）。


基礎概念


1. 定義

time.Duration 表示兩個時間點之間的差距（持續時間），例如幾秒、幾分鐘、幾小時等。

package time

type Duration int64


2. 常量單位

Go 提供了以下常量，用於輕鬆表達不同的時間單位：

const (

Nanosecond  Duration = 1                  // 1 納秒

Microsecond          = 1000 * Nanosecond  // 1 微秒

Millisecond          = 1000 * Microsecond // 1 毫秒

Second               = 1000 * Millisecond // 1 秒

Minute               = 60 * Second        // 1 分鐘

Hour                 = 60 * Minute        // 1 小時

)

這些常量可用於將不同的時間單位轉換為納秒。



使用方式

1. 創建時間間隔

time.Duration 可以通過直接指定數值或計算表達來創建。

package main

import (

"fmt"

"time"

)

func main() {

// 創建時間間隔

duration1 := 2 * time.Second       // 2 秒

duration2 := 1500 * time.Millisecond // 1.5 秒

fmt.Println("Duration1:", duration1)

fmt.Println("Duration2:", duration2)

}

輸出：

Duration1: 2s

Duration2: 1.5s


2. 時間操作

time.Duration 常用於與 time.Time 進行時間加減運算。


package main

import (

"fmt"

"time"

)

func main() {

now := time.Now()                  // 當前時間

future := now.Add(5 * time.Minute) // 增加 5 分鐘

past := now.Add(-10 * time.Second) // 減少 10 秒


fmt.Println("Now:", now)

fmt.Println("Future:", future)

fmt.Println("Past:", past)

}



3. 轉換為不同單位

time.Duration 提供多種方法來將其轉換為不同單位。

方法 描述

Hours() 轉換為小時數（浮點數）

Minutes() 轉換為分鐘數（浮點數）

Seconds() 轉換為秒數（浮點數）

Milliseconds() 轉換為毫秒數（整數）

Microseconds() 轉換為微秒數（整數）

Nanoseconds() 轉換為納秒數（整數）


範例：

package main

import (

"fmt"

"time"

)

func main() {

duration := 5*time.Minute + 30*time.Second // 5 分鐘 30 秒

fmt.Printf("Hours: %.2f\n", duration.Hours())

fmt.Printf("Minutes: %.2f\n", duration.Minutes())

fmt.Printf("Seconds: %.2f\n", duration.Seconds())

fmt.Printf("Milliseconds: %d\n", duration.Milliseconds())

fmt.Printf("Microseconds: %d\n", duration.Microseconds())

fmt.Printf("Nanoseconds: %d\n", duration.Nanoseconds())

}


輸出：

Hours: 0.09

Minutes: 5.50

Seconds: 330.00

Milliseconds: 330000

Microseconds: 330000000

Nanoseconds: 330000000000



4. 格式化輸出

可以使用 String() 方法格式化輸出 time.Duration。

範例：

package main

import (

"fmt"

"time"

)

func main() {

duration := 1*time.Hour + 15*time.Minute + 42*time.Second

fmt.Println("Duration:", duration.String()) // 輸出格式: "1h15m42s"

}


5. 解析字串為時間間隔

time.ParseDuration() 可以用來解析字串形式的時間。

package main

import (

"fmt"

"time"

)

func main() {

duration, err := time.ParseDuration("2h30m15s") // 2 小時 30 分鐘 15 秒

if err != nil {

fmt.Println("Error parsing duration:", err)

return

}

fmt.Println("Parsed Duration:", duration)

}


輸出：

Parsed Duration: 2h30m15s




注意事項

範圍限制：


由於底層是 int64，time.Duration 的範圍是 -2^63 到 2^63-1 納秒，約為 ±292 年。

精度問題：


time.Duration 的精度是 納秒，因此不適合表示超長時間或需要更高精度的時間。


與 time.Time 區別：

       time.Time 表示具體的時間點。

      time.Duration 表示時間段或持續時間。



常見用途

計算執行時間：

start := time.Now()

// 執行一些操作

elapsed := time.Since(start)

fmt.Println("Elapsed time:", elapsed)


限制操作超時：

timeout := 5 * time.Second

time.AfterFunc(timeout, func() {

fmt.Println("Timeout reached")

})


設定間隔執行：

ticker := time.NewTicker(1 * time.Second)

defer ticker.Stop()

for t := range ticker.C {

fmt.Println("Tick at:", t)

}


留言

張貼留言

這個網誌中的熱門文章

[Kotlin]如何學習Kotlin

學習 Kotlin 主要分為幾個階段，根據你的需求（Android 開發、後端開發、Kotlin Multiplatform 等），可以選擇不同的路徑。下面是 完整的 Kotlin 學習指南 ，適合初學者到進階開發者。 1️⃣ 基礎入門 1.1 安裝 Kotlin 開發環境 你可以在不同的平台使用 Kotlin： ✅ 在線學習 （不需安裝） Kotlin 官方 Playground （適合快速測試代碼） ✅ 本地開發 IntelliJ IDEA （推薦，官方 IDE） Android Studio （如果想學 Android 開發） VS Code （需安裝 Kotlin 插件） 命令行 （需要安裝 JDK 和 Kotlin） 安裝 Kotlin 命令行工具 如果想在命令行運行 Kotlin 代碼，可以安裝 Kotlin 編譯器： sh # macOS/Linux (使用 SDKMAN) curl -s https://get.sdkman.io | bash sdk install kotlin # Windows (使用 Chocolatey) choco install kotlin 測試 Kotlin 是否安裝成功： sh kotlin -version 1.2 Kotlin 語法基礎 📌 推薦資源 Kotlin 官方文檔 Kotlin 官方教程 🔥 基本語法 kotlin fun main () { val name: String = "Kotlin" println( "Hello, $name !" ) // 字符串模板 } ✅ 變量與數據類型 kotlin val immutable: String = "不能改變" // val = 只讀 var mutable: Int = 10 // var = 可變 mutable = 20 ✅ 條件語句 kotlin val age = 18 if (age >= 18 ) { println( "成年人" ) } else { println( "未成年" ) } ✅ 函數 kotlin fun add (a: Int ...
閱讀完整內容

[golang]如何使用 gorm 高效執行批量插入 (可以透過 Create()、CreateInBatches()，或者 原生 SQL 語句 來提升效率)

  方法 1：使用  CreateInBatches() （推薦） CreateInBatches()  是  gorm  提供的批量插入方法，支援設定單批次的筆數，適合大規模資料寫入。 範例 package main import ( "log" "gorm.io/driver/mysql" "gorm.io/gorm" ) type User struct { ID uint `gorm:"primaryKey"` Name string Age int } func main () { dsn := "user:password@tcp(127.0.0.1:3306)/testdb?charset=utf8mb4&parseTime=True&loc=Local" db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{}) if err != nil { log.Fatal( "資料庫連接失敗:" , err) } // 準備批量插入的資料 var users []User for i := 1 ; i <= 1000 ; i++ { users = append (users, User{Name: "User" + string (i), Age: 20 + (i % 10 )}) } // 批量插入，每批 100 筆 if err := db.CreateInBatches(users, 100 ).Error; err != nil { log.Fatal( "批量插入失敗:" , err) } else { log.Println( "批量插入成功！" ) } } 優勢 ： 可控每批插入筆數 ，減少單次 SQL 負擔（如  100  筆一批）。 支援事務 ，避免部分插入失敗導致數據不一致。 限制 ： CreateInBatches()  會執行  多次 SQ...
閱讀完整內容

[Kotlin]Kotlin Multiplatform (KMP) 如何安裝使用和部署

 Kotlin Multiplatform (KMP) 是 JetBrains 推出的跨平台開發技術，允許使用 Kotlin 共享核心業務邏輯，同時為不同平台（如 Android、iOS、桌面和 Web）提供各自的 UI。 1️⃣ 安裝與環境設置 1.1 安裝 Kotlin 和 Gradle KMP 使用 Gradle 作為構建工具，因此需要安裝： Kotlin （通常隨 Gradle 自帶） Gradle （建議使用最新版本） Android Studio （開發 Android 部分） Xcode （開發 iOS 部分） 如果你使用 IntelliJ IDEA 或 Android Studio，這些工具通常已預裝。 1.2 安裝 Kotlin Multiplatform 插件 在 Android Studio 或 IntelliJ IDEA： File → Settings → Plugins 搜索 Kotlin Multiplatform Mobile 點擊 Install 安裝 重啟 IDE 2️⃣ 創建 Kotlin Multiplatform 專案 2.1 使用官方範本 可以使用 Kotlin 官方提供的範本來快速建立 KMP 項目： sh # 使用 KMP 官方範本 curl -s https://get.sdkman.io | bash sdk install kotlin 或直接在 Android Studio 內： File → New → New Project 選擇 Kotlin Multiplatform App 選擇所需的目標平台（Android、iOS、Web、Desktop） 2.2 目錄結構 KMP 項目通常具有以下目錄結構： bash root/ ├── shared/ # 共享代碼（Kotlin） │ ├── src/commonMain/ # 共享業務邏輯（Kotlin） │ ├── src/androidMain/ # Android 相關代碼 │ ├── src/iosMain/ # iOS 相關代碼 │ └── build.gradle.kts # KMP 配置 ├── androidApp/ # Android 專案...
閱讀完整內容