Skip to content

Conversation

@codersjj
Copy link
Contributor

@codersjj codersjj commented Jan 7, 2026

Description

Updates the Chinese calendar example in Temporal.PlainDate.from() documentation:

  • Corrects the comment about epoch year alignment (Chinese year 2021 = ISO year 2021)
  • Fixes expected output: "2021-08-08[u-ca=chinese]" instead of "-000616-08-12[u-ca=chinese]"
  • Adds Hebrew calendar example showing significant epoch year difference (5781 Hebrew = 2021 ISO)

Per TC39 proposal, the Chinese calendar's epoch is ISO year 0, not -616 BCE.

Motivation

Additional details

Related issues and pull requests

Fixes #42565

The Chinese calendar example incorrectly stated that year 2021 in the
Chinese calendar corresponds to 616 BC in the ISO calendar. According
to the TC39 Intl era and monthCode proposal, the Chinese calendar's
epoch year is now ISO year 0, so year 2021 aligns with ISO year 2021.

This commit:
- Updates the Chinese calendar example comment to reflect the correct
  epoch year alignment
- Corrects the expected output from "-000616-08-12[u-ca=chinese]" to
  "2021-08-08[u-ca=chinese]"
- Adds a new Hebrew calendar example to demonstrate a calendar with a
  significantly different epoch year (5781 Hebrew = 2021 ISO)

Fixes mdn#42565
@codersjj codersjj requested a review from a team as a code owner January 7, 2026 14:18
@codersjj codersjj requested review from Josh-Cena and removed request for a team January 7, 2026 14:18
@github-actions github-actions bot added Content:JS JavaScript docs size/s [PR only] 6-50 LoC changed labels Jan 7, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Jan 7, 2026

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:JS JavaScript docs size/s [PR only] 6-50 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

The example of Temporal.PlainDate should be revised

1 participant