◉ANTIGRAVITY LABEN
記事一覧/アプリ開発
▣ アプリ開発/2026-11-20中級

手元では正しいのに、本番だけ公開時刻が 9 時間ずれる。オフセットのない日付文字列を疑う順番

サイトマップの lastmod や構造化データの datePublished が、本番だけ 9 時間先になる症状の切り分けと直し方です。日付だけの文字列と時刻付きの文字列で解釈が分かれる仕様、UTC で動く CI と Workers、検出スクリプトとテストまでを実例でまとめました。

Cloudflare Workers9Next.js9タイムゾーンsitemapJavaScript Date

更新したばかりのページのサイトマップを開いて、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())'
done

Node.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 件と出れば、それだけで一つ肩の荷を下ろせるはずです。

シェア

お読みいただきありがとうございます

Antigravity Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

もしこの記事がお役に立ちましたら、チップ(¥150)で応援いただけると大変励みになります。広告なしでの運営を続けるため、皆さまのご支援が大きな力になっています。

関連記事

▣ アプリ開発2026-10-18
エージェントに設定を任せる前に、.env* を無視していても .dev.vars が素通りだと分かり、点検スクリプトで先に塞ぎました
Cloudflare Workers のリポジトリを自分で点検すると、.gitignore の .env* では .dev.vars を守れていませんでした。git check-ignore を使い、エージェントに触らせる前の秘密の置き場を確かめる Python スクリプトの全文を残します。
▣ アプリ開発2026-11-12
Web フォントの配信確認は Origin ヘッダ付きの curl でも行う:代替書体のまま 13 日間気づかなかった記録
自分のサイトで欧文フォントだけが 13 日間 404 のまま、代替書体で描かれていました。素の curl は 200 を返し、ブラウザが送る Origin 付きの要求だけが古い 404 を受け取っていたためです。3 通りの要求を並べる確認スクリプト、エラー応答に長期キャッシュを乗せない設定、変種まで届くパージの選び方を書き残します。
▣ アプリ開発2026-11-05
「cannot pull with rebase: You have unstaged changes」で止まった朝。autostash で通したら、終了コード 0 のまま衝突が残りました
エージェントに触らせたリポジトリで git pull --rebase が unstaged changes で止まったときの切り分け順と、--autostash が衝突しても終了コード 0 を返す点を手元で再現して確かめた記録です。