Skip to content

Calendars and Years

github-actions[bot] edited this page Nov 4, 2026 · 2 revisions

Calendars and years

Calendars available, one tile per year

data/index.json is always the up-to-date list. Today it covers 2015 and 2017 to 2027.

Naming

  • Calendar years are named 2026.
  • Academic years that run from August to June are named 2023-2024. This is how the Ministry has published them since 2021, so the files 2021-2022, 2022-2023 and 2023-2024 span two calendar years.

Status

Status Meaning
final The Ministry published it as the final calendar
current Taken from the Ministry's published calendar, without a final or tentative label
tentative A draft that can still change

The newest version wins

The Ministry often publishes several versions of a year: a tentative draft, a final, and later revisions. The data always follows the most recent one.

flowchart TD
    A["Several PDFs published<br/>for the same year"] --> B{"Which is newest?"}
    B --> C["Newest publication date wins"]
    C --> D{"Newer than the<br/>data we hold?"}
    D -->|yes| E["Data is updated"]
    D -->|no| F["Nothing changes"]
Loading

Categories

Category Meaning
public_holiday Public holidays and the days around them
school_days Teaching periods and terms
exam_days Examination periods
term_holidays Mid-term breaks and term holidays
other Everything else: reporting days, professional development days, events

← Data format · Next: Using the data in your app →

Clone this wiki locally