Temporal.PlainDateTime : 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.PlainDateTime retourne un nouvel objet Temporal.PlainDateTime représentant cette date et heure 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 pour la propriété calendarId de la date et heure.
Pour remplacer les propriétés composants de la date et heure, utilisez la méthode with() à la place.
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.PlainDateTime, représentant la date et heure définie par le PlainDateTime 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 dt = Temporal.PlainDateTime.from("2021-07-01T12:34:56");
const newDT = dt.withCalendar("islamic-umalqura");
console.log(newDT.toLocaleString("en-US", { calendar: "islamic-umalqura" }));
// 11/21/1442 AH, 12:34:56 PM
Spécifications
| Spécification |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.withcalendar |
Compatibilité des navigateurs
Voir aussi
- L'objet La méthode
Temporal.PlainDateTime - La méthode
Temporal.PlainDateTime.prototype.with() - La méthode
Temporal.PlainDateTime.prototype.withPlainTime() - La méthode statique
Temporal.PlainDateTime.from() - La méthode
Temporal.PlainDateTime.prototype.calendarId