Aller au contenu

locale

La langue BCP 47 dans laquelle sont écrits les mots, les dates et les nombres du calendrier.

Typestring
Par défautla langue de la page (<html lang>), sinon 'en'
Modifiable en direct (update())Oui
Déclaré danspackages/core/src/kernel.ts

locale décide comment s’écrivent les dates et les heures (21 oct., Oct 21), les mots du calendrier lui-même (les boutons, « +N autres », les menus), et les conventions de la semaine quand firstDay n’est pas donné : le premier jour de la semaine et la numérotation des semaines.

Les mots anglais et français sont intégrés. L’arabe, l’espagnol et l’allemand s’importent en une ligne chacun (import '@dzcalendar/dom/locales/ar', /es, /de) ; une autre langue prend ses mots de messages ou de defineLocale. Une locale dont les mots ne sont pas chargés reste écrite par la plateforme — dates et nombres dans cette langue — avec les mots anglais. Sans elle, la langue de la page (<html lang>) est utilisée, puis 'en'.

import { createCalendar } from '@dzcalendar/dom';
import '@dzcalendar/dom/locales/de';
const calendar = createCalendar(element, { timeZone: 'Europe/Berlin', locale: 'de-DE' });
// Later: French, built in.
calendar.update({ locale: 'fr-FR' });

Dans les frameworks, c’est une entrée : locale en Angular, en React et en Vue.

La même semaine, ses dates, ses heures et ses boutons en anglais américain.

  • firstDay — le premier jour de la semaine, celui de la locale par défaut.
  • titleFormat — comment s’écrit le titre.
  • Langues.