日付の表示
takuhon.json は各日付を 2024-06 のような ISO 値として一度だけ保存します。
Takuhon はその単一の値を、読み手に応じて表示の仕方だけ変えます: 人はその言語で
見え、機械は生の ISO を受け取ります。設定は不要で、保存された値は変わりません。
1 つの ISO 値、2 つの見せ方
Section titled “1 つの ISO 値、2 つの見せ方”takuhon.json の日付は常に月精度の YYYY-MM(例 2024-06)、まれに完全な
YYYY-MM-DD です。この 1 つの値が 2 通りに描画されます:
- human-facing な surface は読み手の言語にロケール表示する。
- 機械可読な surface は ISO のまま保持する。
人が読むページ
Section titled “人が読むページ”サーバーレンダリングされるプロフィールページ(/)・static build(takuhon build)・
エクスポートする CV(takuhon build --cv)は、解決済みロケールで日付を表示します:
| 保存値 | English | 日本語 |
|---|---|---|
2024-06 | Jun 2024 | 2024年6月 |
2025-12-22 | Dec 22, 2025 | 2025年12月22日 |
- 各日付は
<time datetime="2024-06">2024年6月</time>でラップされ、可視テキストは 自然言語、機械可読な ISO はdatetime属性に温存されます — クローラ・AI・ スクリーンリーダーが読めます。 - 継続中のロールは、終了日の代わりにロケール化したマーカーを表示します —
Present(en)/現在(ja) — 例:2020年1月 – 現在。 - ロケールはページの他の部分を解決するものと同じです(パス接頭辞
/ja/・Accept-Languageヘッダー・ロケール cookie)。
機械可読な surface
Section titled “機械可読な surface”これらは常に生の 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 と ポータブルプロフィール を参照してください。
設定不要・schema 不変
Section titled “設定不要・schema 不変”日付のロケール表示は自動で、有効化する設定はありません。takuhon.json も変わりません
(もともと単一の ISO ソースでした)。英語は短い月表記(Jun 2024)を使います。日付
スタイルを選べる設定は現時点では提供していません。