Skip to content
Takuhon

How dates are shown

Your takuhon.json stores each date once, as a plain ISO value like 2024-06. Takuhon decides how that single value is shown based on who is reading: people see it in their language, machines get the raw ISO. There is nothing to configure, and the stored value never changes.

One ISO value, two presentations

Section titled “One ISO value, two presentations”

A date in takuhon.json is always a month-precision YYYY-MM (e.g. 2024-06), or occasionally a full YYYY-MM-DD. That one value is rendered two ways:

  • Human-facing surfaces localize it to the reader’s language.
  • Machine-readable surfaces keep it verbatim as ISO.

On the pages people read

Section titled “On the pages people read”

The server-rendered profile page (/), the static build (takuhon build), and the exported CV (takuhon build --cv) show dates in the resolved locale:

Stored valueEnglish日本語
2024-06Jun 20242024年6月
2025-12-22Dec 22, 20252025年12月22日
  • Each date is wrapped in <time datetime="2024-06">Jun 2024</time>, so the visible text is natural language while the machine-readable ISO stays in the datetime attribute — readable by crawlers, AI, and screen readers.
  • An ongoing role shows a localized marker in place of an end date — Present (en) / 現在 (ja) — for example Jan 2020 – Present.
  • The locale is the same one that resolves the rest of the page (the path prefix /ja/, the Accept-Language header, or the locale cookie).

On machine-readable surfaces

Section titled “On machine-readable surfaces”

These always emit the raw ISO value, so the consumer decides how to present it:

  • JSON-LD — both /api/jsonld and the <script type="application/ld+json"> embedded in the page. Schema.org expects ISO 8601, so dates (including the free-text award strings) stay ISO.
  • /api/profile and /takuhon.json — portable, machine-consumed.
  • The MCP endpoint — what an AI agent reads.
  • meta.createdAt / meta.updatedAt timestamps.

Request the same surface in any locale and the ISO is byte-identical; only the human-facing rendering changes. See JSON-LD and the portable profile for those surfaces.

No configuration, no schema change

Section titled “No configuration, no schema change”

Date localization is automatic — there is nothing to turn on, and your takuhon.json is unchanged (it was already a single ISO source). English uses the short month form (Jun 2024); a configurable date style is not offered today.