Temporal.Instant : méthode statique from()

Syntaxe

Temporal.Instant.from(info)

Paramètres

info

L'un des éléments suivants :

• Une instance de Temporal.Instant, ce qui crée une copie de l'instance.
• Une chaîne de caractères au format RFC 9557 contenant une date, une heure et un décalage de fuseau horaire. Le nom du fuseau horaire est ignoré ; seul le décalage est utilisé.

Valeur de retour

Un nouvel objet Temporal.Instant représentant l'instant dans le temps défini par info.

Exceptions

TypeError

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

RangeError

Levée dans l'un des cas suivants :

• La chaîne de caractères n'est pas une chaîne de caractères RFC 9557 valide.
• L'information n'est pas dans la plage représentable, qui est de ±10⁸ jours, soit environ ±273 972,6 ans, à partir de l'époque Unix.

Exemples

Créer un instant à partir d'une chaîne de caractères

const instant = Temporal.Instant.from("1970-01-01T00Z");
console.log(instant.toString()); // 1970-01-01T00:00:00Z

const instant2 = Temporal.Instant.from("1970-01-01T00+08:00");
console.log(instant2.toString()); // 1969-12-31T16:00:00Z

// America/New_York est UTC-5 en janvier 1970, pas UTC+8
const instant3 = Temporal.Instant.from("1970-01-01T00+08:00[America/New_York]");
console.log(instant3.toString()); // 1969-12-31T16:00:00Z; le nom du fuseau horaire est ignoré

Créer un instant à partir d'un autre instant

const instant = Temporal.Instant.from("1970-01-01T00Z");
const instant2 = Temporal.Instant.from(instant);
console.log(instant2.toString()); // 1970-01-01T00:00:00Z

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'objet Temporal.Instant
• La méthode statique Temporal.Instant.fromEpochMilliseconds()
• La méthode statique Temporal.Instant.fromEpochNanoseconds()