Skip to content
3 Death Saves

Secondary Calendar

A small read-only viewer for a calendar other than the active one. It shows that calendar’s own date and a grid you can page through.


  • Click an equivalent date link in the BigCal or MiniCal header.
  • Call CALENDARIA.api.showSecondaryCalendar(calendarId).

Clicking the link for a calendar that already has a viewer open brings that window forward instead of opening a second one. Deleting the calendar a viewer is showing closes that viewer.


The viewer opens on the secondary calendar’s date at the current world time. Navigating the primary calendar does not move it.

Weekday headers sit above the day cells, and the current date on that calendar is highlighted. Leading cells before the first weekday carry the previous month’s day numbers in faded style. Trailing cells that pad out the last week are blank.

Days the calendar marks as intercalary sit outside the week grid. The viewer lists them in a row below the grid, and each shows its festival name on hover.

For a calendar with months, the header shows that calendar’s current date in its cross-calendar format. It stays on the current date while you page through the grid.

A dropdown in the footer lists the loaded calendars except the active one. Switching calendars resets the view to that calendar’s current date.

For calendars without months, the grid shows the previous, current, and next week. Navigation moves by week, and the header reads Week X, Year (HH:mm).


  • Arrow buttons move by month, or by week for monthless calendars.
  • The today button returns the grid to the current date.

Every loaded calendar reads the same game.time.worldTime value and interprets it with its own structure. Advancing time on the primary calendar moves every equivalent date with it. There is no manual mapping between calendars.


Weather history and forecast plans are not shared between calendars; each calendar records its own. Opening a secondary calendar neither reads nor writes weather.


Equivalent dates appear for the calendars you select in the Equivalent Date Calendars setting.

Equivalent dates appear below the primary date. Click one to open the viewer for that calendar.

The same links appear in the MiniCal header. Compact mode hides them.

Hovering the HUD’s date shows the equivalent dates in place of its usual tooltip.

A note sheet shows equivalent dates in view mode only. It converts the note’s start date from the calendar that note belongs to.

Hovering a day cell adds the equivalent dates to the tooltip.


See API Reference.