コンテンツにスキップ

日付の表示

takuhon.json は各日付を 2024-06 のような ISO 値として一度だけ保存します。 Takuhon はその単一の値を、読み手に応じて表示の仕方だけ変えます: 人はその言語で 見え、機械は生の ISO を受け取ります。設定は不要で、保存された値は変わりません。

takuhon.json の日付は常に月精度の YYYY-MM(例 2024-06)、まれに完全な YYYY-MM-DD です。この 1 つの値が 2 通りに描画されます:

  • human-facing な surface は読み手の言語にロケール表示する。
  • 機械可読な surface は ISO のまま保持する。

サーバーレンダリングされるプロフィールページ(/)・static build(takuhon build)・ エクスポートする CV(takuhon build --cv)は、解決済みロケールで日付を表示します:

保存値English日本語
2024-06Jun 20242024年6月
2025-12-22Dec 22, 20252025年12月22日
  • 各日付は <time datetime="2024-06">2024年6月</time> でラップされ、可視テキストは 自然言語、機械可読な ISO は datetime 属性に温存されます — クローラ・AI・ スクリーンリーダーが読めます。
  • 継続中のロールは、終了日の代わりにロケール化したマーカーを表示します — Present(en)/ 現在(ja) — 例: 2020年1月 – 現在
  • ロケールはページの他の部分を解決するものと同じです(パス接頭辞 /ja/Accept-Language ヘッダー・ロケール cookie)。

これらは常に生の ISO 値を出力し、提示方法は消費側が決めます:

  • JSON-LD/api/jsonld とページ埋め込みの <script type="application/ld+json"> の両方。Schema.org は ISO 8601 を要求する ため、日付(自由文の award 文字列を含む)は ISO のままです。
  • /api/profile/takuhon.json — ポータブルで機械が消費する。
  • MCP エンドポイント — AI エージェントが読むもの。
  • meta.createdAt / meta.updatedAt のタイムスタンプ。

同じ surface をどのロケールで要求しても ISO はバイト単位で同一で、変わるのは human-facing な描画だけです。これらの surface は JSON-LDポータブルプロフィール を参照してください。

日付のロケール表示は自動で、有効化する設定はありません。takuhon.json も変わりません (もともと単一の ISO ソースでした)。英語は短い月表記(Jun 2024)を使います。日付 スタイルを選べる設定は現時点では提供していません。