Go 時刻フォーマット・strftime 変換

このツールについて

レイアウトはパターンではなく見本

多くの言語では、%Y-%m-%d や YYYY-MM-DD のようなプレースホルダーで日付の形式を表します。Go のやり方は異なります。基準時刻という特定の 1 つの時点をどう表示したいかを書くと、time.Format がほかの時刻も同じように出力します。基準時刻は Mon Jan 2 15:04:05 MST 2006 です。

この値は、アメリカ式の順序で 01/02 03:04:05PM '06 -0700 と書いたときに数字が順に増えるように選ばれています。月が 1、日が 2、時が 3（24 時間制では 15）、分が 4、秒が 5、年が 6、タイムゾーンのオフセットがマイナス 7 時間です。それぞれの値は 1 つの意味しか持たないため、Go は 01 が月で 04 が分だと判別できます。

よくある間違い

01 が月、02 が日なので、日を先に書く日付は 02/01/2006 になります。基準の順序に慣れていないと、これは誤りに見えます。ほかの言語の書き方で書いたレイアウトも、エラーにはなりません。Go は認識できない部分をそのままテキストとして出力するので、YYYY-MM-DD は変わらずに出力されます。また、認識できる数字はすべてトークンとして読むので、2021-12-25 は無関係な数字の並びになります。

トークンをエスケープする方法はありません。トークンを含むテキストは置き換えられるため、レイアウト内に文字どおりの Jan や Mon、2 のような数字を書くと、値に変わってしまいます。そうしたテキストは、レイアウトの外で付け足してください。

Z07:00 は、UTC では Z、それ以外では数値のオフセットを出力します。これは RFC 3339 が求める形式です。一方、-07:00 は常に数値を出力します。秒の小数部は、.000 なら末尾のゼロを残し、.999 なら取り除きます。月名と曜日名は常に英語です。

プレビューと変換のしくみ

プレビューは、WebAssembly にコンパイルしてブラウザで実行している Go 標準ライブラリの time.Format が生成します。そのため、同じ時点とオフセットに対して Go のプログラムが出力するものと同じ結果を表示します。現在時刻、お使いのタイムゾーンの UTC オフセットとその略称はブラウザから取得します。ブラウザがタイムゾーンの略称を持たない場合は、+03 のような数値の略称を使います。これは、独自の英字の略称を持たないタイムゾーンに対して Go が出力するものと同じです。タイムゾーンによっては、ブラウザの略称が、Go が読み込むタイムゾーンデータベースの略称と異なる場合があります。

2 つの形式が表現できる範囲は同じではありません。strftime には Z07:00 のように動作する指定子がなく、Go には週番号（%U、%W、%V）、数値の曜日（%u、%w）、エポックからの秒数（%s）に対応するトークンがありません。変換ツールはそうした部分をそのまま残し、欄の下に表示します。また、strftime 形式に含まれる文字どおりのテキストのうち、Go がトークンとして読み取ってしまうものも表示します。レイアウトではそれを保持できないためです。

strftime 側の指定子の一部は、すべての実装にあるわけではない拡張です。ゼロ埋めを外すフラグ（%-d）、コロン付きのオフセット（%:z）、小数部の指定子 %L、%f、%N がそうです。変換先の言語のドキュメントを確認してください。