更新したばかりのページのサイトマップを開いて、lastmod の欄を上から眺めていた朝のことです。いちばん新しい行の時刻が、いまの時計より先を指していました。手元の iMac でビルドした出力を見直すと、同じ記事の時刻は正しく並んでいます。
ずれていたのは、Cloudflare Workers で配信している本番の出力だけでした。しかも差はきっちり 9 時間で、日本時間と UTC の差そのものです。
最初にお伝えしたいのは、原因は Workers の不具合ではなく、オフセットの付いていない日付文字列を、そのまま new Date() に渡していたことだった、という点です。個人開発で Next.js のサイトを運用していると、フロントマターに date: "2026-03-22T10:00" のような書き方を続けてしまいがちで、私自身もそうでした。
症状の見分け方:ずれが「ちょうど 9 時間」かどうか
時刻がおかしいとき、まず差の大きさを確かめます。9 時間ちょうどなら、ほぼ確実にタイムゾーンの解釈違いです。数分や数十分なら、キャッシュや配信の遅れなど別の原因を疑います。
この症状が出やすい場所は、次の四つでした。
| 出力 | 見え方 | 気づきにくさ |
|---|---|---|
| sitemap.xml の lastmod | 更新時刻が未来になる・日付が 1 日ずれる | 人が読まないので放置されやすい |
| JSON-LD の datePublished / dateModified | 公開日時が 9 時間先になる | リッチリザルトの検証まで見ないと分からない |
| OGP の article:published_time | 共有カードの日時がずれる | 共有先によっては表示されない |
| RSS の pubDate | フィードリーダーでの並び順が乱れる | 購読者からの指摘で気づく |
画面に表示する日付だけを見ていると、これらはなかなか目に入りません。表示用の日付は「年月日」だけのことが多く、昼間の記事なら 9 時間ずれても同じ日付に収まってしまうからです。
原因の切り分け:同じ文字列が、実行環境で別の時刻になる
手元で再現するのは簡単です。Node.js の実行時のタイムゾーンを TZ で切り替え、同じ三つの文字列を読ませます。
for tz in UTC Asia/Tokyo; do
TZ=$tz node -e 'for (const s of ["2026-03-22T10:00","2026-03-22","2026-03-22T10:00:00+09:00"]) console.log(process.env.TZ.padEnd(10), s.padEnd(26), new Date(s).toISOString())'
doneNode.js v22 で実行した結果は次のとおりでした。
UTC 2026-03-22T10:00 2026-03-22T10:00:00.000Z
UTC 2026-03-22 2026-03-22T00:00:00.000Z
UTC 2026-03-22T10:00:00+09:00 2026-03-22T01:00:00.000Z
Asia/Tokyo 2026-03-22T10:00 2026-03-22T01:00:00.000Z
Asia/Tokyo 2026-03-22 2026-03-22T00:00:00.000Z
Asia/Tokyo 2026-03-22T10:00:00+09:00 2026-03-22T01:00:00.000Z一行目と四行目を見比べると、時刻付きでオフセットのない文字列は、実行している環境のタイムゾーンで読まれていることが分かります。手元の Mac は日本時間なので正しく、UTC で動く環境では 9 時間先になります。Workers も、GitHub Actions の標準のランナーも、UTC で動いています。
意外だったのは二行目と五行目です。日付だけの "2026-03-22" は、どちらの環境でも UTC の 0 時として読まれました——つまり日本時間の 9 時です。JavaScript の仕様では、日付だけの形式は UTC、時刻付きの形式はローカル時刻として扱うと決まっていて、同じ「オフセットなし」でも振る舞いが二通りに分かれるのです。
私はここを取り違えて、「手元で正しいなら日付だけの値も大丈夫だろう」と考えていました。結果は芳しくありませんでした。日付だけの値は、手元でも本番でも、意図より 9 時間遅れていたのです。それに気づいたのは、テストを UTC 以外のタイムゾーンでも走らせてからでした。手元で正しく見えることは、思っていたほど多くを保証してくれないのかもしれません。
直し方:Date にする前に、文字列の段階でオフセットを付ける
直し方は一つに絞りました。フロントマターの値を Date に変える前に、必ず日本時間のオフセットを付けた文字列へ整えます。
// to-iso-jst.mjs
const OFFSET = /([Zz]|[+-]\d{2}:\d{2})$/;
export function toIsoJst(value) {
if (!value) return "";
if (OFFSET.test(value)) return value;
if (/^\d{4}-\d{2}-\d{2}$/.test(value)) return `${value}T00:00:00+09:00`;
if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$/.test(value)) return `${value}:00+09:00`;
if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/.test(value)) return `${value}+09:00`;
throw new Error(`想定外の日付形式: ${value}`);
}使う側は、new Date(article.date) を new Date(toIsoJst(article.date)) に置き換えるだけです。sitemap、JSON-LD、OGP、RSS のように日時を外へ出す箇所をすべてこの関数に通しました。
なぜこう書くのかを補足します。正規表現で形式を限定しているのは、2026/03/22 のような想定外の書き方を黙って通さないためです。本番のサイトでは想定外の値をそのまま返す形にしていますが、ここでは例外を投げる版にしました。ビルドが止まる方が、ずれた時刻が静かに配信され続けるよりもはるかに安全だと考えたからです。
もう一つ、timeZone を指定した toLocaleString で表示だけを直す方法もあります。ただ、それは表示が合うだけで、機械が読む lastmod や datePublished は直りません。日付は文字列のうちにオフセットを付け、Date にするのはそのあと。 いまはこの順番だけを守るようにしています。
手元の TZ に守られないための検出とテスト
直したあとに困ったのは、手元が日本時間である限り、取りこぼしに気づけないことでした。そこで、オフセットのない値を一覧にするスクリプトを用意しました。実行環境のタイムゾーンに頼らず、「UTC の環境で読まれたらどうなるか」を自前で計算します。
// check-dates.mjs — 使い方: node check-dates.mjs content
import { readdirSync, readFileSync } from "node:fs";
import { join } from "node:path";
import { toIsoJst } from "./to-iso-jst.mjs";
const OFFSET = /([Zz]|[+-]\d{2}:\d{2})$/;
// 実行環境の TZ に依存しないよう、UTC として読んだ値を自前で作る
function asIfUtcRuntime(value) {
return /^\d{4}-\d{2}-\d{2}$/.test(value)
? new Date(`${value}T00:00:00Z`)
: new Date(`${value.length === 16 ? value + ":00" : value}Z`);
}
function walk(dir) {
return readdirSync(dir, { withFileTypes: true }).flatMap((e) =>
e.isDirectory() ? walk(join(dir, e.name)) : e.name.endsWith(".mdx") ? [join(dir, e.name)] : []
);
}
let flagged = 0;
for (const file of walk(process.argv[2] ?? "content")) {
const fm = readFileSync(file, "utf8").split("---")[1] ?? "";
for (const key of ["date", "updated"]) {
const m = fm.match(new RegExp(`^${key}:\\s*"([^"]+)"`, "m"));
if (!m || OFFSET.test(m[1])) continue;
const wrong = asIfUtcRuntime(m[1]);
const right = new Date(toIsoJst(m[1]));
flagged++;
console.log(`${file} ${key}="${m[1]}"`);
console.log(` UTC 環境で読むと ${wrong.toISOString()} / JST として正しくは ${right.toISOString()}(差 ${(wrong - right) / 3600000} 時間)`);
if (wrong.toISOString().slice(0, 10) !== right.toISOString().slice(0, 10)) {
console.log(" ⚠ 日付だけの lastmod でも1日ずれます");
}
}
}
console.log(flagged ? `オフセットなし: ${flagged} 件` : "オフセットなしの日付はありません");
process.exitCode = flagged ? 1 : 0;早朝の時刻、日付だけの値、更新日時の三つを並べた見本で走らせると、こう出ました。
content/a.mdx date="2026-03-22T05:30"
UTC 環境で読むと 2026-03-22T05:30:00.000Z / JST として正しくは 2026-03-21T20:30:00.000Z(差 9 時間)
⚠ 日付だけの lastmod でも1日ずれます
content/b.mdx date="2026-03-22"
UTC 環境で読むと 2026-03-22T00:00:00.000Z / JST として正しくは 2026-03-21T15:00:00.000Z(差 9 時間)
⚠ 日付だけの lastmod でも1日ずれます
content/b.mdx updated="2026-03-23T09:00"
UTC 環境で読むと 2026-03-23T09:00:00.000Z / JST として正しくは 2026-03-23T00:00:00.000Z(差 9 時間)
オフセットなし: 3 件日本時間の朝 9 時より前の時刻は、UTC では前日になります。日付だけの lastmod を出しているサイトでも、ここでは 1 日ずれるのです。
このスクリプトは「オフセットのない値が残っているか」を数えるためのもので、件数が出ること自体は問題ではありません。変換を通していれば正しく出力されます。確かめたいのは変換の側なので、テストは TZ を変えて三回走らせました。
// dates.test.mjs — 使い方: TZ=UTC node --test dates.test.mjs
import test from "node:test";
import assert from "node:assert/strict";
import { toIsoJst } from "./to-iso-jst.mjs";
test("オフセットなしの日時は JST として読む", () => {
assert.equal(new Date(toIsoJst("2026-03-22T05:30")).toISOString(), "2026-03-21T20:30:00.000Z");
});
test("日付だけの値も JST の 0 時にする", () => {
assert.equal(new Date(toIsoJst("2026-03-22")).toISOString(), "2026-03-21T15:00:00.000Z");
});
test("オフセット付きはそのまま通す", () => {
assert.equal(toIsoJst("2026-03-22T10:00:00+09:00"), "2026-03-22T10:00:00+09:00");
});UTC、Asia/Tokyo、America/Los_Angeles のどれでも三件とも通りました。手元が日本時間でも、テストだけは TZ=UTC を付けて走らせる——それだけで、本番と同じ条件の確認が毎回できるようになります。
直らないとき:変換を通っていない箇所を探す
関数を足しても本番の lastmod が先を指したままなら、変換を通っていない呼び出しが残っています。デプロイ後のサイトマップを直接読んで、未来の時刻を数えるのがいちばん早い確認でした。
// future-lastmod.mjs — 使い方: node future-lastmod.mjs https://example.com/sitemap.xml
import { readFileSync } from "node:fs";
const src = process.argv[2];
const xml = src.startsWith("http") ? await (await fetch(src)).text() : readFileSync(src, "utf8");
const now = Date.now();
const future = [...xml.matchAll(/<loc>([^<]+)<\/loc>\s*<lastmod>([^<]+)<\/lastmod>/g)]
.map(([, loc, lastmod]) => ({ loc, lastmod, ahead: (Date.parse(lastmod) - now) / 3600000 }))
.filter((r) => r.ahead > 0.1); // 時計の誤差を少しだけ許す
for (const r of future) console.log(`${r.ahead.toFixed(1)} 時間先 ${r.lastmod} ${r.loc}`);
console.log(future.length ? `未来の lastmod: ${future.length} 件` : "未来の lastmod はありません");
process.exitCode = future.length ? 1 : 0;ここで 1 件でも出たら、リポジトリで new Date( を検索し、引数がフロントマター由来のものを一つずつ確かめます。Antigravity のエージェントに頼むときは、「new Date( の呼び出しを一覧にし、引数がフロントマターの date / updated に由来するものだけ、変換関数を通しているかを表にしてください。修正はまだしないでください」と、調べることと直すことを分けて伝えました。一度に直させると、timeZone を指定して正しく動いている表示用の toLocaleDateString まで書き換えの対象になりかねません。調べた表を自分の目で確かめてから直す方が、結局は早く終わるのです。
フロントマターの書き方そのものを +09:00 付きに改める方法もあります。ただ、既存の値をすべて書き換えると差分が大きくなり、取りこぼしも起きやすくなります。私は、書き方はそのままにして、読む側の一か所で揃える方を選びました。
日時を外へ出す処理の設計を、日付の変わり目や夏時間まで含めて組み直したいときは、日付の変わり目に昨日の壁紙がもう一度出た件の記録に、アプリ側で同じ問題に向き合った手順を残しています。
まずは、お手元のサイトのサイトマップを future-lastmod.mjs に一度だけ掛けてみていただければと思います。0 件と出れば、それだけで一つ肩の荷を下ろせるはずです。