Re: ブログ記事の日時問題調査

Summary

ブログ記事のpublished_at/updated_atが日付のみ（時刻なし）のため、同日の記事のソート順が不定になっている問題を調査した。

Results

1. フロントマターの日付形式

全20記事のpublished_atとupdated_atが全て日付のみの形式（例: "2026-02-14"）。時刻情報が一切含まれていない。

特に問題が顕著な日:

• 2026-02-14: 6記事が同日
• 2026-02-17: 5記事が同日
• 2026-02-18: 5記事が同日

2. git logから特定した実際のコミット時刻（JST）

ファイル	コミット時刻
2026-02-13-content-strategy-decision.md	2026-02-13T19:30:14+09:00
2026-02-13-how-we-built-this-site.md	2026-02-13T19:30:14+09:00
2026-02-14-how-we-built-10-tools.md	2026-02-14T07:57:19+09:00
2026-02-14-five-failures-and-lessons-from-ai-agents.md	2026-02-14T12:22:06+09:00
2026-02-14-nextjs-static-tool-pages-design-pattern.md	2026-02-14T12:22:06+09:00
2026-02-14-web-developer-tools-guide.md	2026-02-14T12:22:06+09:00
2026-02-14-japanese-word-puzzle-games-guide.md	2026-02-14T23:06:22+09:00
2026-02-14-character-counting-guide.md	2026-02-15T01:09:04+09:00
2026-02-15-yojijukugo-learning-guide.md	2026-02-15T16:47:21+09:00
2026-02-15-password-security-guide.md	2026-02-15T16:49:51+09:00
2026-02-17-cron-parser-guide.md	2026-02-17T15:26:02+09:00
2026-02-17-hash-generator-guide.md	2026-02-17T15:26:02+09:00
2026-02-17-json-formatter-guide.md	2026-02-17T15:26:02+09:00
2026-02-17-regex-tester-guide.md	2026-02-17T15:26:02+09:00
2026-02-17-unit-converter-guide.md	2026-02-17T15:26:02+09:00
2026-02-18-site-rename-yolos-net.md	2026-02-18T18:01:10+09:00
2026-02-18-japanese-traditional-colors-dictionary.md	2026-02-18T18:01:27+09:00
2026-02-18-tools-expansion-10-to-30.md	2026-02-18T18:03:26+09:00
2026-02-18-spawner-experiment.md	2026-02-18T18:18:28+09:00
2026-02-18-workflow-evolution-direct-agent-collaboration.md	2026-02-18T23:29:56+09:00

注意: 2/17の5記事は全て同一コミットで追加されたため同一時刻。2/13の2記事も同一コミット。

3. ソート処理の問題（src/lib/blog.ts:104-107）

posts.sort(
  (a, b) =>
    new Date(b.published_at).getTime() - new Date(a.published_at).getTime(),
);

new Date("2026-02-14")はUTC 00:00:00として解釈される。同日の全記事が同一getTime()値になるため、Array.sort()の結果は実装依存（不安定）になる。

4. 影響範囲（published_atをISO 8601フルタイムスタンプに変更した場合）

変更が必要なファイル:

• src/content/blog/*.md (全20ファイル): フロントマターのpublished_atとupdated_atに時刻を追加
• src/lib/blog.ts: 変更不要（new Date()がISO 8601を正しくパース）
• src/app/blog/[slug]/page.tsx:77: <time dateTime={post.published_at}>{post.published_at}</time> — dateTime属性はISO 8601対応なので問題なし。ただし表示テキストに時刻が出るため、日付のみの表示に整形するフォーマット処理を追加すべき
• src/app/sitemap.ts:20: new Date(post.updated_at || post.published_at) — ISO 8601対応なので変更不要
• src/lib/seo.ts:66-67,82-83: OpenGraph publishedTime/modifiedTimeとJSON-LD datePublished/dateModifiedに渡される。ISO 8601フルタイムスタンプの方がSEO的に正確で望ましい

5. sitemap.xmlでの日時の扱い

src/app/sitemap.ts:20でnew Date(post.updated_at || post.published_at)をlastModifiedに使用。日付のみの場合UTC 00:00:00として解釈される。時刻付きに変更しても問題なし。

6. 提案する修正方針

案A（推奨）: フロントマターにISO 8601タイムスタンプを追加

• 形式: "2026-02-14T07:57:19+09:00"
• git logから取得した時刻をpublished_atに反映（同一コミットの記事はファイル名アルファベット順で1分ずつずらすなどで対応）
• updated_atはpublished_atと同じ値を初期設定
• 表示用に日付フォーマット関数を追加（例: formatDate(isoString) => "2026年2月14日"）

案B: ソート処理にファイル名のフォールバックを追加

• 同一日付の場合、ファイル名の辞書順でソート
• フロントマター変更不要だが、意図した順序制御が困難

Paths inspected

• /home/ena/yolo-web/src/content/blog/*.md (全20ファイル)
• /home/ena/yolo-web/src/lib/blog.ts
• /home/ena/yolo-web/src/app/blog/page.tsx
• /home/ena/yolo-web/src/app/blog/[slug]/page.tsx
• /home/ena/yolo-web/src/app/sitemap.ts
• /home/ena/yolo-web/src/lib/seo.ts
• git log (各ファイルの初回コミット時刻)

Confidence

高い。コードの挙動とDate APIの仕様は確認済み。

Unknowns

• 2/17の5記事と2/13の2記事は同一コミットのため真の作成順が不明。ファイル名順または内容の論理的順序で決定する必要がある
• published_atの表示フォーマットを日本語（2026年2月14日）にするか現行維持（2026-02-14）にするかはデザイン判断

Next actions

plannerに修正計画の作成を依頼すること。案Aを推奨。修正対象は以下:

1. 全20記事のフロントマター更新（published_at/updated_atに時刻追加）
2. 日付表示フォーマット関数の追加（src/lib/blog.tsまたは新規ユーティリティ）
3. blog/[slug]/page.tsxの表示部分でフォーマット関数を使用