Temporal.Instant : méthode toZonedDateTimeISO()

Syntaxe

toZonedDateTimeISO(timeZone)

Paramètres

timeZone

Soit une chaîne de caractères, soit une instance de Temporal.ZonedDateTime représentant le fuseau horaire à utiliser. Si c'est une instance de Temporal.ZonedDateTime, son fuseau horaire est utilisé. Si c'est une chaîne de caractères, elle peut être un identifiant de fuseau horaire nommé, un identifiant de fuseau horaire avec décalage, ou une chaîne de caractères de date-heure contenant un identifiant de fuseau horaire ou un décalage (voir fuseaux horaires et décalages pour plus d'informations).

Valeur de retour

Un nouvel objet Temporal.ZonedDateTime représentant cet instant dans le fuseau horaire défini en utilisant le système de calendrier ISO 8601.

Exceptions

RangeError

Levée si le nom du fuseau horaire est invalide.

TypeError

Levée si timeZone n'est pas une chaîne de caractères ou une instance de Temporal.ZonedDateTime.

Exemples

Utiliser la méthode toZonedDateTimeISO()

const instant = Temporal.Instant.from("2021-08-01T12:34:56.123456789Z");
const zonedDateTime = instant.toZonedDateTimeISO("America/New_York");
console.log(zonedDateTime.toString()); // 2021-08-01T08:34:56.123456789-04:00[America/New_York]

const localDateTime = instant.toZonedDateTimeISO(Temporal.Now.timeZoneId());
console.log(localDateTime.toString()); // Cet instant dans votre fuseau horaire

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'objet Temporal.Instant
• L'objet Temporal.ZonedDateTime
• La méthode Temporal.ZonedDateTime.prototype.toInstant()