Secondary Calendar
View any loaded calendar side by side with the primary calendar. The viewer shows the equivalent date on a different calendar system, with a month grid and navigation controls.
Opening the secondary calendar viewer
Section titled “Opening the secondary calendar viewer”- Click an equivalent date link in the BigCal or MiniCal header
- API:
CALENDARIA.api.showSecondaryCalendar(calendarId)
Display
Section titled “Display”The viewer shows a month grid for the selected secondary calendar, centered on the equivalent date of the primary calendar’s current view.
Month grid
Section titled “Month grid”- Weekday headers
- Day cells with the current equivalent date highlighted
- Previous and next month days shown in faded style
Calendar selector
Section titled “Calendar selector”The calendar selector is a dropdown in the viewer’s footer that lists all loaded calendars except the active primary calendar. Select a different calendar to switch the viewer to that calendar’s month grid.
Monthless calendars
Section titled “Monthless calendars”For calendars without months, the viewer displays a week-based grid:
- A three-week sliding window of the previous, current, and next week
- Navigation moves by week instead of month
- The header displays
Week X, Year (HH:mm)instead of a month name
Navigation
Section titled “Navigation”| Action | Result |
|---|---|
| Arrow buttons | Move by month, or by week for monthless calendars |
| Today button | Return to the equivalent of the current date |
| Calendar dropdown | Switch to a different secondary calendar |
Date conversion
Section titled “Date conversion”Cross-calendar date translation runs through shared world time. All loaded calendars share the same underlying game.time.worldTime value. The viewer converts the primary calendar’s current date to the equivalent position on the secondary calendar by resolving through this shared time reference.
- Each calendar interprets the same world time according to its own structure
- Advancing time on the primary calendar updates equivalent dates on every secondary calendar
- Conversion is derived from world time, with no manual mapping
Equivalent date display
Section titled “Equivalent date display”Equivalent dates appear in several locations for the calendars you select in the Equivalent Date Calendars setting.
BigCal header
Section titled “BigCal header”Equivalent dates appear below the primary date for the calendars selected in the Equivalent Date Calendars setting. Click one to open the secondary calendar viewer for that calendar.
MiniCal header
Section titled “MiniCal header”Equivalent date links appear in the header, the same as BigCal. They are hidden in compact mode.
Note sheets
Section titled “Note sheets”Note sheets show equivalent dates for the calendars selected in the Equivalent Date Calendars setting.
Day tooltips
Section titled “Day tooltips”Hovering over a day cell shows the equivalent dates in the tooltip.
See API Reference for full details.