Temporal.Instant : méthode toString()

Syntaxe

toString()
toString(options)

Paramètres

options Facultatif

Un objet contenant certaines ou toutes les propriétés suivantes (dans l'ordre où elles sont récupérées et validées) :

fractionalSecondDigits Facultatif

Soit un entier de 0 à 9, soit la chaîne de caractères "auto". La valeur par défaut est "auto". Si "auto", les zéros finaux sont supprimés des secondes fractionnaires. Sinon, la partie fractionnaire de la seconde contient ce nombre de chiffres, complétés par des zéros ou arrondis si nécessaire.

roundingMode Facultatif

Une chaîne de caractères définissant comment arrondir les chiffres fractionnaires au-delà de fractionalSecondDigits. Voir Intl.NumberFormat(). La valeur par défaut est "trunc".

smallestUnit Facultatif

Une chaîne de caractères définissant la plus petite unité à inclure dans la sortie. Les valeurs possibles sont "minute", "second", "millisecond", "microsecond" et "nanosecond", ou leurs formes plurielles, qui (sauf "minute") sont équivalentes aux valeurs de fractionalSecondDigits de 0, 3, 6, 9, respectivement. Si défini, alors fractionalSecondDigits est ignoré.

timeZone Facultatif

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). La valeur par défaut est "UTC".

Valeur de retour

Une chaîne de caractères au format RFC 9557 représentant cet instant en utilisant le fuseau horaire défini. Aucune annotation, telle que les noms de fuseaux horaires, n'est incluse.

Exceptions

RangeError

Levée si l'une des options est invalide.

Exemples

Utiliser la méthode toString()

const instant = Temporal.Instant.fromEpochMilliseconds(1627814412345);
console.log(instant.toString()); // '2021-08-01T10:40:12.345Z'

// La conversion en chaîne de caractères appelle implicitement toString()
console.log(`${instant}`); // '2021-08-01T10:40:12.345Z'

Utiliser des options

const instant = Temporal.Instant.fromEpochMilliseconds(1627814412345);
console.log(instant.toString({ fractionalSecondDigits: 1 })); // '2021-08-01T10:40:12.3Z'
console.log(instant.toString({ smallestUnit: "minute" })); // '2021-08-01T10:40Z'
console.log(instant.toString({ timeZone: "America/New_York" })); // '2021-08-01T06:40:12.345-04:00'

// Le nom du fuseau horaire se résout automatiquement au décalage correct
// en fonction de l'instant ; par exemple, America/New_York est UTC-4 en
// été, mais UTC-5 en hiver.
const instant2 = Temporal.Instant.fromEpochMilliseconds(1577836800000);
console.log(instant2.toString({ timeZone: "UTC" })); // '2029-12-31T23:00:00Z'
console.log(instant2.toString({ timeZone: "America/New_York" })); // '2019-12-31T19:00:00-05:00'

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'objet Temporal.Instant
• La méthode statique Temporal.Instant.from()
• La méthode Temporal.Instant.prototype.toJSON()
• La méthode Temporal.Instant.prototype.toLocaleString()