secondaryCalendar
A second calendar’s date shown beside each date — the Hijri under the Gregorian.
| Type | string | null |
|---|---|
| Default | null |
Live update (update()) | Yes |
| Declared in | packages/dom/src/calendar.ts |
What it does
Section titled “What it does”Each day cell and each day’s heading shows its date in this calendar too,
small, beside the first one (displayCalendar or the locale’s). It serves
two readers at once: a clinic in Algiers whose patients count in both. Any
of the platform’s calendars (an unknown name throws a RangeError); null
(the default) none, and nothing is shown when it is the calendar the dates
are already written in.
Example
Section titled “Example”import { createCalendar } from '@dzcalendar/dom';
createCalendar(element, { timeZone: 'Africa/Algiers', locale: 'fr-DZ', initialView: 'dayGridMonth', secondaryCalendar: 'islamic-umalqura' });import { Component } from '@angular/core';import { DZ_CALENDAR } from '@dzcalendar/angular';
@Component({ selector: 'app-agenda', imports: [DZ_CALENDAR], template: `<dz-calendar timeZone="Europe/Paris" secondaryCalendar="islamic-umalqura" />`,})export class Agenda {}import { DzCalendar } from '@dzcalendar/react';
export function Agenda() { return <DzCalendar timeZone="Europe/Paris" secondaryCalendar="islamic-umalqura" />;}<script setup lang="ts">import { DzCalendar } from '@dzcalendar/vue';</script>
<template> <DzCalendar time-zone="Europe/Paris" secondary-calendar="islamic-umalqura" /></template>In the frameworks it is an Angular input (secondaryCalendar) and a React and Vue prop (secondaryCalendar, secondary-calendar).
Live demo
Section titled “Live demo”October 2026, each day with its Hijri date.
See also
Section titled “See also”displayCalendar— the first calendar.locale— the language.- Languages.