#475 Event pages describe their time as the timeline writes it, in ISO 8601 for machines
–
- github
- github/openchronology/timeline-app
- github/openchronology/timeline-app#475
- pull request
- state:merged
Closes #466. Closes #468. **Descriptions (#466).** A moment's or duration's page described itself, for search results and link previews, as `0539-01-01T00:00:00Z BCE – 0331-01-01T00:00:00Z BCE. **Persian (Achaemenid) Babylon…`. It now reads `539 BCE – 331 BCE. Persian (Achaemenid) Babylon…`: - **Times written alone:** `presentTime` uses the presenter's `alone`, as Explore's search does (`printEntityTime`). Each time is written at its own precision: "1975 CE", "1975-03 CE", "1861-03-04 CE 12:00 UTC". This also applies to the visible ` `, timeline facts and lists on the website. Other displays (numbers, units, custom) print as before. - **Plain text:** the notes lose their Markdown (`markdownText`). - **Length:** descriptions are cut near 155 characters, what search results show. `excerpt` now cuts between words when a word ends in the last fifth of the room, and drops trailing punctuation before the "…". - **No notes:** an event without notes is described by its time alone, not "1970-01-02 CE.". **`temporalCoverage` (#468).** It was a full timestamp on CE dates, and the displayed text, which isn't ISO 8601, on BCE dates or other displays. Now: - **Precision:** ISO 8601 as precise as the timeline writes the time: `1975`, `1975-03`, `1975-03-14`, or a full timestamp with its offset. - **Years:** counted astronomically, so 539 BCE is `-0538` and 1 BCE `0000`, for years -9999 to 9999. - **Durations:** `start/end`, with both ends at the finer of their precisions: `1970-01-01/1970-01-03`, not `1970/1970-01-03`. - **Other displays:** a fictional calendar's years or a number line give no `temporalCoverage` at all. - **HTML `datetime`:** it takes no years before 1, so it is left out for those (`htmlTime`). **Tests:** - **Unit:** `entity-pages.test.mjs` covers the precisions, BCE years, intervals, `htmlTime`, Markdown stripping, the word-boundary cut and the time-only description. All unit tests pass here except `contents.test.mjs`, which fails on `main` in this checkout as well. - **PostgreSQL:** `sharing-postgres.mjs` checks a moment's description, `datetime` and `temporalCoverage` and a duration's interval. Its HTTP checks pass here; its later embed step needs Chromium, so CI runs it whole. `next-postgres.mjs` passes. **Docs:** updated in `docs/sharing.md`. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_011fFY8eruEi1xAkkMBni13B https://github.com/openchronology/timeline-app/pull/475