日時

Go言語の日付フォーマットについて解説：基本レイアウトと実例の紹介

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

Go言語の日付フォーマットでは、特定のレイアウト方式を使って柔軟に日付形式を変換できます。

標準の参照日時2006-01-02 15:04:05を基準に、自分好みのフォーマットに調整できる仕組みを簡単な実例とともにご紹介します。

目次から探す

日付フォーマットの基本
実例によるフォーマット変換
- シンプルな変換例の紹介
- タイムゾーン対応の例
コード実装の基本
- 基本的な記述方法と使い方
- エラーハンドリングのポイント
よくある誤解と注意点
- 参照日時の誤用事例
- トラブルシューティングの手法
まとめ

日付フォーマットの基本

参照日時「2006-01-02 15:04:05」の意味

Go言語では、日付のフォーマットに「2006-01-02 15:04:05」という固定のレイアウトを利用します。

この数字はそれぞれ以下の意味を持っています。

2006: 西暦年(4桁)
01: 月(2桁)
02: 日(2桁)
15: 時(24時間表示で2桁)
04: 分(2桁)
05: 秒(2桁)

この参照日時は、日付の各部分を具体的な数値で表現しており、その順番に従って入力値やフォーマット文字列を判別します。

数式で表すと、入力文字列は

$Reference = “ 2006 - 01 - 0215 : 04 : 05 ″$

と表現されます。

レイアウト指定方式の特徴

Goのレイアウト指定方式は、従来の%Yや%mのような記号を用いるフォーマットとは異なり、実際の日時の数字を用います。

この方式の特徴は以下の通りです。

誤りにくい固定パターンであるため、フォーマットの意図が明確になります。
レイアウト文字列がそのまま日時の各部分に対応するので、コードの可読性が高いです。
書式設定に柔軟性があり、位置を入れ替えることで様々なフォーマットに対応可能です。

基本パターンの解説

日付フォーマットの基本パターンは、以下のような構成になっています。

年：2006または06(短縮形)
月：01または1(先頭に0があるかないか)
日：02または2(先頭に0があるかないか)
時：15(24時間)、または03(12時間表示)
分：04
秒：05

例えば、短いフォーマットで「02/01/06」という形にする場合、レイアウトは02/01/06と記述します。

日付や時刻の区切り文字(ハイフンやスラッシュなど)は自由に変更できるため、用途に合わせて柔軟なフォーマットが実現できます。

実例によるフォーマット変換

シンプルな変換例の紹介

Goの標準ライブラリtimeパッケージを使い、現在の日時を特定のフォーマットに変換する例を以下に示します。

package main
import (
	"fmt"
	"time"
)
func main() {
	// 現在の日時を取得
	currentTime := time.Now()
	// レイアウトを指定して日付文字列に変換
	layout := "2006-01-02 15:04:05"
	formattedDate := currentTime.Format(layout)
	// 結果を表示
	fmt.Println("Formatted Date:", formattedDate)
}

Formatted Date: 2023-10-25 13:45:30

上記のサンプルコードでは、currentTime.Format(layout)を利用して日時の整形を行い、結果として「YYYY-MM-DD HH:MM:SS」の形式に変換しています。

タイムゾーン対応の例

タイムゾーンを考慮した日時変換も可能です。

以下の例では、特定のタイムゾーンに変更して日時を整形する方法を紹介します。

package main
import (
	"fmt"
	"time"
)
func main() {
	// 指定するタイムゾーン "Asia/Tokyo" を読み込み
	location, err := time.LoadLocation("Asia/Tokyo")
	if err != nil {
		// タイムゾーンの読み込み失敗時の処理
		fmt.Println("Error loading location:", err)
		return
	}
	// 現在の日時を指定したタイムゾーンで取得
	currentTime := time.Now().In(location)
	// レイアウトを指定して日付文字列に変換
	layout := "2006-01-02 15:04:05 MST"
	formattedDate := currentTime.Format(layout)
	// 結果を表示
	fmt.Println("Formatted Date with Timezone:", formattedDate)
}

Formatted Date with Timezone: 2023-10-25 22:45:30 JST

この例では、time.LoadLocationでタイムゾーンを読み込み、In(location)でそのタイムゾーンの時間に変換しています。

出力にはタイムゾーンの略称も含めて表示されます。

コード実装の基本

基本的な記述方法と使い方

レイアウト指定の具体例

日付フォーマットで利用するレイアウト文字列の具体例を示します。

以下のサンプルコードでは、日付と時刻の各部分を指定した形式に変換する方法を紹介します。

package main
import (
	"fmt"
	"time"
)
func main() {
	// 具体例として固定日時を作成
	baseTime := time.Date(2023, 10, 25, 14, 30, 0, 0, time.UTC)
	// レイアウト例1: 年月日
	layout1 := "2006-01-02"
	formattedDate1 := baseTime.Format(layout1)
	fmt.Println("Date Format 1:", formattedDate1)
	// レイアウト例2: 時刻のみ
	layout2 := "15:04:05"
	formattedTime := baseTime.Format(layout2)
	fmt.Println("Time Format:", formattedTime)
	// レイアウト例3: 日時＋タイムゾーン
	layout3 := "2006-01-02 15:04:05 MST"
	baseTimeInLocal := baseTime.In(time.Local)
	formattedDateTime := baseTimeInLocal.Format(layout3)
	fmt.Println("DateTime with Timezone:", formattedDateTime)
}

Date Format 1: 2023-10-25
Time Format: 14:30:00
DateTime with Timezone: 2023-10-25 14:30:00 JST

このコードでは、それぞれの日付や時刻の部分を抽出するために異なるレイアウト文字列を利用しています。

日付操作と変換処理

日付のパースやフォーマット変換における基本的な操作について紹介します。

以下の例は、文字列からtime.Time型へ変換し、別の形式に整形する方法です。

package main
import (
	"fmt"
	"time"
)
func main() {
	// 解析対象の文字列とレイアウトを定義
	inputDate := "2023-10-25 14:30:00"
	layout := "2006-01-02 15:04:05"
	// 文字列から time.Time へ変換
	parsedTime, err := time.Parse(layout, inputDate)
	if err != nil {
		fmt.Println("Parse Error:", err)
		return
	}
	// 別の形式で日時文字列に変換
	newLayout := "02 Jan 2006, 15:04"
	newFormattedDate := parsedTime.Format(newLayout)
	fmt.Println("New Formatted Date:", newFormattedDate)
}