Aller au contenu

initialDate

La date dont le calendrier montre la période en premier.

TypePlainDate
Par défautaujourd'hui, dans timeZone
Modifiable en direct (update())Oui, sous le nom date : update({ date: … })
Déclaré danspackages/core/src/kernel.ts

Le calendrier s’ouvre sur la période qui contient cette date : son mois, sa semaine, son jour. Sans elle, c’est aujourd’hui dans timeZone. Ensuite la personne se déplace avec les flèches de l’en-tête et « aujourd’hui », et votre code avec update({ date }) ou navigate('prev' | 'next' | 'today').

C’est un Temporal.PlainDate — une date sans heure ni fuseau, lue comme ce jour dans le fuseau du calendrier. Attendez loadTemporal() avant d’en créer une : sur un navigateur sans Temporal natif, son polyfill arrive à ce moment.

import { Temporal, loadTemporal } from '@dzcalendar/core';
import { createCalendar } from '@dzcalendar/dom';
await loadTemporal();
const calendar = createCalendar(element, {
timeZone: 'Europe/Paris',
initialDate: Temporal.PlainDate.from('2026-10-25'),
});
// Later: another period.
calendar.update({ date: Temporal.PlainDate.from('2026-12-01') });

Dans les frameworks, c’est la date du composant : [(date)] en Angular, defaultDate en React (ou date avec onDateChange, contrôlée), v-model:date en Vue. Leur Temporal.PlainDate.from(…) s’exécute avec le composant : sur Safari, attendez d’abord loadTemporal() une fois au démarrage (le provideDzCalendar() d’Angular le fait ; React, Vue).

Le calendrier s’ouvre sur la semaine du 25 octobre 2026 — le jour de 25 heures de Paris.

  • initialView — la vue dans laquelle il s’ouvre.
  • timeZone — le fuseau où se lit son « aujourd’hui ».
  • Vues.