Temporal.ZonedDateTime : 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.ZonedDateTime retourne un nouvel objet Temporal.ZonedDateTime représentant cette date et cette heure interprétées 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 et de l'heure.
Pour remplacer les propriétés de composant de la date et de l'heure, utilisez la méthode with(). Pour remplacer son fuseau horaire, utilisez la méthode withTimeZone().
Syntaxe
withCalendar(calendar)
Paramètres
calendar-
Une chaîne de caractères correspondant à la propriété
calendarId. VoirIntl.supportedValuesOf()pour une liste des types de calendriers couramment pris en charge.
Valeur de retour
Un nouvel objet Temporal.ZonedDateTime, représentant la date et l'heure définies par le ZonedDateTime d'origine, interprétées 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 zdt = Temporal.ZonedDateTime.from(
"2021-07-01T12:34:56[America/New_York]",
);
const newZDT = zdt.withCalendar("islamic-umalqura");
console.log(newZDT.toLocaleString("en-US", { calendar: "islamic-umalqura" }));
// 11/21/1442 AH, 12:34:56 PM EDT
Spécifications
| Spécification |
|---|
| Temporal # sec-temporal.zoneddatetime.prototype.withcalendar |
Compatibilité des navigateurs
Voir aussi
- L'objet
Temporal.ZonedDateTime - La méthode
Temporal.ZonedDateTime.prototype.with() - La méthode
Temporal.ZonedDateTime.prototype.withTimeZone() - La méthode
Temporal.ZonedDateTime.prototype.withPlainTime() - La méthode statique
Temporal.ZonedDateTime.from() - La propriété
Temporal.ZonedDateTime.prototype.calendarId