time パッケージ

time パッケージは、現在時刻の取得、日時のフォーマット、経過時間の計測などに使います。

1. 現在時刻の取得(time.Now)

time.Now は、現在時刻を time.Time 型の値として返す関数です。書き方は以下のとおりです。

now := time.Now()   // time.Time ─ 現在時刻を取得する

次のコードは、現在時刻を取得してそのまま表示する例です。

package main

import (
    "fmt"
    "time"
)

func main() {
    now := time.Now()
    fmt.Println(now)
}

以下のような実行結果が表示されます(実行した時刻により異なります)。

2026-07-15 12:34:56.789 +0900 JST m=+0.000078335

time.Time 型の値を fmt.Println に渡すと、ナノ秒とタイムゾーンを含む既定の形式で表示されます。末尾の m=+0.000078335 はモノトニッククロック(プログラム起動からの経過秒)で、Goの time パッケージが実行時に自動で付与します。

2. 日時のフォーマット(Format)

time.Time 型の Format メソッドは、日時を任意の書式に整形した文字列を返します。書き方は以下のとおりです。

文字列 := 時刻.Format("2006-01-02 15:04:05")   // string ─ 指定した書式で整形する

次のコードは、現在時刻を YYYY-MM-DD HH:MM:SS の形式で整形して表示する例です。

package main

import (
    "fmt"
    "time"
)

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

以下のような実行結果が表示されます。

2026-07-15 12:34:56

指定した書式に沿って、年月日と時分秒が整形されて表示されました。

💡 ポイント
Goの日時フォーマット文字列は独特で、2006-01-02 15:04:05 という固定の参照時刻をどう表示するかで指定します。例えば 2006-01-02 は YYYY-MM-DD を意味します。「2006 が年」「01 が月」「02 が日」といった対応を覚えれば、他言語よりも直感的に扱えます。

3. 経過時間の計測(time.Since)

time.Since は、指定した時刻から現在までの経過時間を返す関数です。書き方は以下のとおりです。

elapsed := time.Since(開始時刻)   // time.Duration ─ 開始時刻から現在までの経過時間

次のコードは、time.Sleep で 100ms だけ待った処理の経過時間を計測する例です。

package main

import (
    "fmt"
    "time"
)

func main() {
    start := time.Now()
    time.Sleep(100 * time.Millisecond)
    elapsed := time.Since(start)
    fmt.Println("経過時間:", elapsed)
}

以下のような実行結果が表示されます。

経過時間: 100.234ms

time.Sleep で 100ms 待った後、time.Since(start) で start からの経過時間が取得され、約100msが表示されました。処理時間のログ出力やパフォーマンス計測でよく使うパターンです。