Langue et locale
Deux choses décident de ce qu’affiche un composant, et elles sont séparées à dessein.
La locale
Les noms de mois, les noms de jours, l’ordre d’une date et le choix entre douze et vingt-quatre heures viennent tous d’Intl, que tout navigateur possède déjà. Passez une étiquette BCP-47, ou laissez faire : celle du navigateur s’applique.
<tz-calendar locale="fr-FR" />Le même calendrier, quatre locales. Rien d’autre n’est réglé : les noms de mois et l’ordre des jours suivent.
Le début de la semaine vient aussi de la locale — lundi en France et au Royaume-Uni, dimanche aux États-Unis et au Japon, samedi dans une grande partie du monde arabe. Rien ci-dessus ne l’a demandé ; regardez le calendrier en-US et celui en ja-JP.
C’est Intl qu’on interroge, pas une table tenue ici : une table de deux cents locales est une table qui se périme. Là où le navigateur est trop ancien pour répondre — vieux Safari, vieux Firefox — la semaine commence le lundi, comme le dit ISO-8601.
firstDayOfWeek passe outre, pour l’entreprise qui n’est pas d’accord avec sa propre locale :
createCalendar(element, { locale: 'en-US', firstDayOfWeek: 1 });Les raccourcis suivent la même réponse. Cette semaine en fr-FR commence le lundi ; en en-US, le dimanche d’avant — un calendrier et un raccourci qui ne seraient pas d’accord sur le début d’une semaine seraient pires que l’un ou l’autre choix.
Et un champ horaire suit la locale vers douze heures, ou non :
Aucun fichier de locale n’est livré avec tzslot. Air Datepicker en embarque une trentaine ; ils vieillissent, et ce sont des octets que chaque visiteur télécharge pour des langues qu’il ne lit pas.
Les mots que tzslot ajoute
Tout le reste — Aujourd’hui, Effacer, Du, Jusqu’au, la phrase qui explique un changement de décalage — tient dans un seul jeu. L’anglais et le français sont fournis.
import { provideTzslotMessages, FR } from '@tzslot/angular';
bootstrapApplication(App, { providers: [provideTzslotMessages(FR)] });import { createCalendar, FR } from '@tzslot/dom';
createCalendar(element, { locale: 'fr-FR', messages: FR });Une application parle une langue, donc le dire une fois est la façon habituelle. Un écran qui change de langue pendant qu'il tourne passe le jeu sur la balise : une valeur injectée est lue une seule fois et ne change plus, donc les noms de mois suivraient la bascule et les boutons non.
<tz-range-field [messages]="mots()" [locale]="langue()" />Ce qu'écrit la balise l'emporte ; ce que fournit l'application est le repli. Pressez les boutons sous celui-ci — les noms de mois et les mots du composant changent ensemble, et le champ garde ce qui était choisi :
Ne changer que la locale, c'est ce que laisse un jeu de messages injecté : les mois bougent et les mots restent.
La locale et le jeu de messages sont distincts, et les mélanger exprès montre pourquoi ils doivent l’être. Une locale française avec le jeu anglais — mois français, boutons anglais :
Les deux en français :
Redéfinir quelques mots plutôt que tout le jeu :
createCalendar(element, {
locale: 'fr-FR',
messages: { ...FR, today: 'Aller à aujourd’hui', clear: 'Tout effacer' },
buttons: ['today', 'clear'],
});Une autre langue
Copiez EN, changez les mots. Certains sont des fonctions, parce que les langues ne s’accordent pas sur l’ordre des morceaux : le français met la durée réelle avant la raison, l’allemand met le verbe à la fin, et aucune chaîne de format n’exprime l’un ou l’autre.
import { EN, type TzslotMessages } from '@tzslot/dom';
export const ES: TzslotMessages = {
...EN,
today: 'Hoy',
clear: 'Borrar',
summerTime: 'verano',
winterTime: 'invierno',
clockChange: ({ direction, by, apparent, real }) =>
`Dura ${real} en vez de ${apparent}: los relojes se ${
direction === 'back' ? 'atrasan' : 'adelantan'
} ${by}.`,
};Le nom qu’un fuseau donne à chaque lecture — « heure d’été d’Europe centrale » — n’est pas dans le jeu de messages : il vient lui aussi d’Intl, dans la langue du lecteur. Les deux mots été et hiver, eux, sont dans le jeu de messages : c’est le raccourci propre à la librairie, et aucune API ne les fournit.
Voici où tout cela se rejoint : une locale française, le jeu français, et le matin où les pendules reculent à Paris.
L'arabe, et la lecture de droite à gauche
AR est livré à côté de EN et FR.
import { AR } from '@tzslot/dom';
createRangeField(element, { locale: 'ar-EG', messages: AR, timeZone: 'Africa/Cairo' });Deux réglages, pas un. messages choisit les mots ; locale choisit tout ce qu'Intl décide — et pour l'arabe les deux se séparent comme ils ne le font jamais pour le français :
| locale | chiffres | la semaine commence |
|---|---|---|
ar | 20 | samedi |
ar-EG | ٢٠ | samedi |
ar-SA | ٢٠ | dimanche |
ar-MA | 20 | lundi |
Le catalogue ne contient donc aucun chiffre. Un écran à Rabat et un au Caire veulent les mêmes mots et des chiffres différents ; en choisir un pour eux serait décider à leur place.
Compter, ce que l'arabe fait de six façons
Le français a un singulier et un pluriel. L'arabe a six catégories, et les phrases à compter de la bibliothèque sont des fonctions précisément pour qu'un catalogue puisse s'en servir :
const jours = new Intl.PluralRules('ar');
dailySummary: ({ days: n, total }) =>
`${n} ${{ zero: 'أيام', one: 'يوم', two: 'يومان', few: 'أيام', many: 'يوماً', other: 'يوم' }[jours.select(n)]} · ${total}`,يومان est le duel — une forme pour exactement deux, que le français n'a pas et qu'un gabarit à trou ne peut pas atteindre.
Taper une date
Les chiffres indo-arabes et persans sont lus comme les nombres qu'ils sont : ٢٠, ۲۰ et 20 valent vingt. Cela vaut dans toutes les locales, pas seulement en arabe — un champ français n'a rien à perdre à les accepter.
La direction
Les widgets suivent la direction en vigueur là où ils se trouvent — dir="rtl" sur n'importe quel ancêtre, ou sur la page. Rien à configurer.
Le panneau est la partie qui mérite d'être connue. Il est dessiné sur document.body, donc il n'hérite de rien de votre conteneur : il lit la direction sur le champ auquel il appartient et l'emporte avec lui, comme il emporte déjà la palette. Une application qui inverse un seul conteneur plutôt que toute la page obtient quand même un panneau cohérent.
Dans la grille, une flèche désigne un jour et non un côté : la touche qui pointe vers demain va vers demain, c'est-à-dire vers la gauche en arabe. Haut et bas ne changent pas, une semaine étant sous la précédente dans toutes les directions d'écriture.
Un calendrier qui n'est pas grégorien
getMonthGrid construit un mois dans le calendrier qu'on lui donne, et inMonth lit un jour dans ce calendrier :
import { getMonthGrid, inMonth } from '@tzslot/core';
// Rabi al-Thani 1448 — trente jours, du 12 septembre au 11 octobre 2026.
const grille = getMonthGrid(1448, 4, 7, 'islamic-umalqura');
const dedans = grille.flat().filter((jour) => inMonth(jour, 1448, 4, 'islamic-umalqura'));Ce qui revient est en ISO, quel que soit le calendrier demandé. Un calendrier est une façon de lire les dates, pas de les stocker — la règle que cette bibliothèque applique déjà aux fuseaux, où un moment est gardé en UTC et lu sur les horloges de quelqu'un. Pour le numéro hégirien d'une cellule, on demande à la date : jour.withCalendar('islamic-umalqura').day.
Les widgets ne s'en servent pas encore. Chacun garde son année et son mois et l'incrémente de un, ce qui n'est pas avancer d'un mois dans un calendrier dont les années n'en comptent pas toujours le même nombre. La grille est prête ; les cinq widgets qui la piloteraient ne le sont pas.