Temporal.Duration : 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 composante seconde contient autant 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 l'unité la plus petite à inclure dans la sortie. Les valeurs possibles sont "second", "millisecond", "microsecond" et "nanosecond", ou leurs formes plurielles, qui sont équivalentes aux valeurs de fractionalSecondDigits de 0, 3, 6, 9, respectivement. Si défini, alors fractionalSecondDigits est ignoré.

Valeur de retour

Une chaîne de caractères représentant la durée donnée au format ISO 8601, avec les composants de sous-secondes formatés selon les options. La durée nulle est représentée par "PT0S".

Exceptions

RangeError

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

Exemples

Utiliser la méthode toString()

const duration = Temporal.Duration.from({ hours: 1, minutes: 30, seconds: 15 });
console.log(duration.toString()); // 'PT1H30M15S'

// La conversion en chaîne de caractères appelle implicitement toString()
console.log(`${duration}`); // 'PT1H30M15S'

Utiliser les propriétés options

const worldRecord = Temporal.Duration.from({ seconds: 9, milliseconds: 580 });
console.log(worldRecord.toString()); // 'PT9.58S'
console.log(worldRecord.toString({ fractionalSecondDigits: 1 })); // 'PT9.5S'
console.log(worldRecord.toString({ fractionalSecondDigits: 0 })); // 'PT9S'
console.log(worldRecord.toString({ smallestUnit: "millisecond" })); // 'PT9.580S'
console.log(
  worldRecord.toString({
    fractionalSecondDigits: 1,
    roundingMode: "halfExpand",
  }),
); // 'PT9.6S'

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'objet Temporal.Duration
• La méthode Temporal.Duration.prototype.toJSON()
• La méthode Temporal.Duration.prototype.toLocaleString()