locale
La langue BCP 47 dans laquelle sont écrits les mots, les dates et les nombres du calendrier.
| Type | string |
|---|---|
| Par défaut | la langue de la page (<html lang>), sinon 'en' |
Modifiable en direct (update()) | Oui |
| Déclaré dans | packages/core/src/kernel.ts |
Ce qu’elle fait
Section intitulée « Ce qu’elle fait »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' });import { Component } from '@angular/core';import { DZ_CALENDAR } from '@dzcalendar/angular';import '@dzcalendar/dom/locales/ar';
@Component({ selector: 'app-agenda', imports: [DZ_CALENDAR], template: `<dz-calendar timeZone="Asia/Riyadh" locale="ar-SA" />`,})export class Agenda {}import { DzCalendar } from '@dzcalendar/react';import '@dzcalendar/dom/locales/es';
export function Agenda() { return <DzCalendar timeZone="Europe/Madrid" locale="es-ES" />;}<script setup lang="ts">import { DzCalendar } from '@dzcalendar/vue';</script>
<template> <DzCalendar time-zone="Europe/Paris" locale="fr-FR" /></template>Dans les frameworks, c’est une entrée : locale en Angular, en React et en Vue.
Démo en direct
Section intitulée « Démo en direct »La même semaine, ses dates, ses heures et ses boutons en anglais américain.
Voir aussi
Section intitulée « Voir aussi »firstDay— le premier jour de la semaine, celui de la locale par défaut.titleFormat— comment s’écrit le titre.- Langues.