日時

Go言語の日付取得について解説：timeパッケージを利用した基本手法

2025-02-19更新日: 2025-02-19

Go言語で日付や時刻を取得するのは、シンプルで実用的な作業です。

この記事では、time.Now()などの関数を活用し、基本的な日付取得方法を分かりやすく説明します。

初心者でも手軽に実装できる方法を紹介していきます。

目次から探す

基礎知識と基本取得方法
- Go言語における日付・時刻の基本
- timeパッケージの概要
日付フォーマットの設定
- 書式指定の基礎
- time.Format() の活用例
タイムゾーンの扱い
- ローカルタイムとUTCの取得方法
その他の日時操作
- 日付のパースと比較
実装上の注意点
- エラー処理の確認ポイント
まとめ

基礎知識と基本取得方法

Go言語における日付・時刻の基本

Go言語では、日付や時刻を扱うために専用の型である time.Time を利用します。

この型は日付、時刻、ナノ秒までの精度を持ち、内部ではタイムゾーンの情報も含んでいます。

また、time パッケージを通じてさまざまな日時操作が簡単に行えるため、標準ライブラリだけで実装が完結できるのが特徴です。

timeパッケージの概要

time パッケージは、日付や時刻の取得、書式設定、パース、差分計算など、多数の日時関係の関数を提供しています。

このパッケージを利用することで、システムの現在時刻の取得やタイムゾーンの管理、日付データ同士の演算が手軽に行えます。

time.Now() の基本的な使い方

Go言語において現在の日付と時刻を取得するためには、time.Now() を使用します。

以下は、現在の日時を取得し、標準出力に出力するサンプルコードです。

package main
import (
    "fmt"
    "time"
)
func main() {
    // 現在の日時を取得する
    currentTime := time.Now()
    fmt.Println("現在の時刻:", currentTime)
}

現在の時刻: 2023-10-12 15:04:05.999999999 +0900 JST m=+0.000000001

日付フォーマットの設定

書式指定の基礎

Go言語では、日付や時刻のフォーマットを設定する際に、あらかじめ定められた基準となる時刻を利用します。

この基準時刻は Mon Jan 2 15:04:05 -0700 MST 2006 であり、各数字や略語がフォーマットの意味を持ちます。

たとえば、\(\dfrac{2006}{01}\) や 01 のようなパターンで年や月を表現することが可能です。

time.Format() の活用例

time.Format() を使用することで、取得した日付時刻を任意の形式に変換できます。

下記のサンプルコードでは、time.Format() を使って年月日、時刻を適切なフォーマットで出力する例を示しています。

package main
import (
    "fmt"
    "time"
)
func main() {
    // 現在の日時を取得
    currentTime := time.Now()
    // YYYY-MM-DD HH:MM:SS のフォーマットに変換
    formattedTime := currentTime.Format("2006-01-02 15:04:05")
    fmt.Println("フォーマットされた時刻:", formattedTime)
}

フォーマットされた時刻: 2023-10-12 15:04:05

タイムゾーンの扱い

ローカルタイムとUTCの取得方法

Go言語では、デフォルトでシステムのローカルタイムが利用されます。

一方、UTC()メソッドを呼び出すことで、協定世界時 (UTC) に変換することができます。

この違いを理解することで、異なるタイムゾーン間での時刻計算がスムーズに行えます。

time.LoadLocation() を利用したタイムゾーン設定

タイムゾーンを明示的に設定する際は、time.LoadLocation() を利用して希望するタイムゾーンをロードします。

例えば、アメリカのニューヨーク時間に変更する場合は以下のようになります。

package main
import (
    "fmt"
    "time"
)
func main() {
    // "America/New_York" タイムゾーンのロケーションを取得
    newYorkLocation, err := time.LoadLocation("America/New_York")
    if err != nil {
        fmt.Println("タイムゾーンの取得に失敗:", err)
        return
    }
    // 現在のローカル日時をニューヨーク時間に変換
    newYorkTime := time.Now().In(newYorkLocation)
    fmt.Println("ニューヨーク時刻:", newYorkTime.Format("2006-01-02 15:04:05 MST"))
}

ニューヨーク時刻: 2023-10-12 03:04:05 EDT

その他の日時操作

日付のパースと比較

Go言語では、文字列で表された日付を、特定のフォーマットに基づいて time.Time型に変換することができます。

また、time.Time型同士は直接比較ができ、差分を計算するためのメソッドも用意されています。

これにより、日時の大小比較や時間間隔の検出が可能となります。

time.Parse() の基本的な使い方

time.Parse() は、指定したフォーマットに従い文字列をパースして time.Time型に変換します。

たとえば、下記のサンプルコードでは、特定のフォーマット文字列を用いて日付文字列を解析する方法を示しています。

package main
import (
    "fmt"
    "time"
)
func main() {
    // "2006-01-02 15:04:05" の形式で日付文字列を定義
    dateString := "2023-10-12 15:04:05"
    // 定義したフォーマットに沿ってパースを実施
    parsedTime, err := time.Parse("2006-01-02 15:04:05", dateString)
    if err != nil {
        fmt.Println("パースエラー:", err)
        return
    }
    fmt.Println("パースされた時刻:", parsedTime)
}

パースされた時刻: 2023-10-12 15:04:05 +0000 UTC

time.Sub() を用いた差分計算

time.Sub()メソッドは、2つの time.Time型の日付の差を time.Duration型で返します。

これにより、特定の日時間の経過時間や残り時間の計算が簡単に行えます。

以下はその利用例です。

package main
import (
    "fmt"
    "time"
)
func main() {
    // 2つの日付をパースする
    startString := "2023-10-12 12:00:00"
    endString := "2023-10-12 15:30:00"
    startTime, err := time.Parse("2006-01-02 15:04:05", startString)
    if err != nil {
        fmt.Println("開始時刻のパースエラー:", err)
        return
    }
    endTime, err := time.Parse("2006-01-02 15:04:05", endString)
    if err != nil {
        fmt.Println("終了時刻のパースエラー:", err)
        return
    }
    // 経過時間の計算
    duration := endTime.Sub(startTime)
    fmt.Println("経過時間:", duration)
}