時刻の末尾の「Z」は、1 日進める印ではなかった
私は IT の知識ゼロから、Claude Codeを用いて、部活の運営アプリ「Aulloy」を作っています。このブログでは、作りながら学んだことを 1 つずつ残していきます。
1 本目は、テストのコード 3 行を読む問題で、半分まちがえた話です。
出された問題
Aulloy には「今が何年度か」を出す計算があります。4 月 1 日で年度が切り替わる、日本ではおなじみの決まりです。
次は、その計算が正しいかを自動で確かめる「テスト」の 3 行です。assert.equal(A, B) は「A は B になるはず」という確認です。
assert.equal(fiscalYear(jst('2026-03-31T23:59:59')), 2025); // 日本時間の 3/31 23:59:59 → 2025 年度
assert.equal(fiscalYear(jst('2026-04-01T00:00:00')), 2026); // 日本時間の 4/1 0:00 → 2026 年度
assert.equal(fiscalYear(new Date('2026-03-31T20:00:00Z')), 2026); // ?
問:3 行目は「3 月 31 日」なのに、なぜ 2026 年度が正しいのでしょう?
私の答え
3 行目だけ jst が無く、new Date と Z が書いてある。だから Z は「1 日進めた」という表記で、日本時間は関係なく 4 月 1 日を指している。だから 2026 年度。
結果は半分正解でした。
- 3 行目だけ書き方が違う、と気付いたのは正解。違いを見つけるのが、コードを読む第一歩だそうです
- 2026 年度という結論も正解
- 理由がまちがい
正しい理由
Zは「この時刻は、世界の基準の時計(UTC=協定世界時)で書いています」という印です。1 日進める記号ではありません- 日本の時計は UTC より 9 時間進んでいます。20 時(UTC)に 9 時間を足すと 29 時、つまり翌日の朝 5 時(日本時間)です
- 年度は日本の暦で決まります。計算の中で日本時間に直してから月を見るので、4 月、つまり 2026 年度になります
「日本時間は関係ない」どころか、日本時間に直したからこそ 4 月 1 日になっていたのでした。
自分の手で確かめる
Node.js(JavaScript を動かす道具)が入っているパソコンなら、ターミナルで次を打つと、3 行目の時刻を日本時間で表示できます。
node -e "console.log(new Date('2026-03-31T20:00:00Z').toLocaleString('ja-JP', { timeZone: 'Asia/Tokyo' }))"
2026/4/1 5:00:00 と出ます。
次に 20:00 を 10:00 に変えると、2026/3/31 19:00:00 と出ます。もし Z が「1 日進める」印なら 4 月 1 日になるはずですが、日付は変わりません。9 時間足しても、夜中の 0 時をまたがないからです。
なぜ、この行まで確かめるのか
Aulloy の同じ計算は、2 か所で動いています。利用者のスマホ(日本の時計)と、サーバー(UTC の時計)です。
もし日本時間に直すのを忘れると、サーバーの中だけ、4 月 1 日の 0 時から 8 時 59 分までが前の年度として扱われます。年に 1 回、9 時間だけ起きる不具合は、手で試してもまず見つかりません。だから境目を、テストで押さえておきます。
こういう確かめ方を「境界値テスト」と言います。不具合は境目に集まります。年度の変わり目、夜中の 0 時、月末、うるう年。
今日わかったこと
Zは UTC の印。日本時間は UTC + 9 時間