Temporal.PlainDate : méthode withCalendar()
Disponibilité limitée
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
La méthode withCalendar() des instances de Temporal.PlainDate retourne un nouvel objet Temporal.PlainDate représentant cette date interprétée dans le nouveau système de calendrier. Comme tous les objets Temporal sont conçus pour être immuables, cette méthode fonctionne essentiellement comme le mutateur de la propriété calendarId de la date.
Pour remplacer les propriétés du composant de date, utilisez la méthode with() à la place.
Syntaxe
withCalendar(calendar)
Paramètres
calendar-
Une chaîne de caractères correspondant à la propriété
calendarId. ConsultezIntl.supportedValuesOf()pour une liste des types de calendriers couramment pris en charge.
Valeur de retour
Un nouvel objet Temporal.PlainDate, représentant la date définie par l'objet PlainDate d'origine, interprétée dans le nouveau système de calendrier.
Exceptions
TypeError-
Levée si
calendarn'est pas une chaîne de caractères. RangeError-
Levée si
calendarn'est pas un identifiant de calendrier valide.
Exemples
Utiliser la méthode withCalendar()
const date = Temporal.PlainDate.from("2021-07-01");
const newDate = date.withCalendar("islamic-umalqura");
console.log(newDate.toLocaleString("en-US", { calendar: "islamic-umalqura" }));
// 11/21/1442 AH
Spécifications
| Spécification |
|---|
| Temporal # sec-temporal.plaindate.prototype.withcalendar |
Compatibilité des navigateurs
Voir aussi
- L'objet
Temporal.PlainDate - La méthode
Temporal.PlainDate.prototype.with() - La méthode statique
Temporal.PlainDate.from() - La propriété
Temporal.PlainDate.prototype.calendarId