Temporal.PlainTime : méthode round()

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 round() des instances de Temporal.PlainTime retourne un nouvel objet Temporal.PlainTime représentant cette heure arrondie à l'unité spécifiée.

Une chaîne de caractères représentant l'option smallestUnit. Il s'agit d'une surcharge pratique, donc round(smallestUnit) est équivalent à round({ smallestUnit }), où smallestUnit est une chaîne.

options

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

roundingIncrement Facultatif: Un nombre (tronqué à un entier) représentant l'incrément d'arrondi dans l'unité smallestUnit donnée. Par défaut, 1. L'incrément doit être un diviseur de la valeur maximale de smallestUnit ; par exemple, si l'unité est les heures, l'incrément doit être un diviseur de 24 et ne doit pas être 24 lui-même, ce qui signifie qu'il peut être 1, 2, 3, 4, 6, 8 ou 12.
roundingMode Facultatif: Une chaîne de caractères définissant comment arrondir la partie fractionnaire de smallestUnit. Voir Intl.NumberFormat(). Par défaut, "halfExpand".
smallestUnit: Une chaîne de caractères représentant l'unité la plus petite à inclure dans la sortie. La valeur doit être l'une des suivantes : "hour", "minute", "second", "millisecond", "microsecond", "nanosecond", ou leurs formes plurielles. Pour les unités supérieures à "nanosecond", les parties fractionnaires de smallestUnit seront arrondies selon les paramètres roundingIncrement et roundingMode.

Valeur de retour

Un nouvel objet Temporal.PlainTime représentant cette heure arrondie à l'unité donnée, où toutes les unités inférieures à smallestUnit sont mises à zéro.

Exceptions

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

Exemples

Arrondir les petites unités

const time = Temporal.PlainTime.from("12:34:56.123456789");
const nearestMillisecond = time.round("millisecond");
console.log(nearestMillisecond.toString()); // 12:34:56.123

const nearestHalfHour = time.round({
  smallestUnit: "minute",
  roundingIncrement: 30,
});
console.log(nearestHalfHour.toString()); // 12:30:00

const nextHour = time.round({ smallestUnit: "hour", roundingMode: "ceil" });
console.log(nextHour.toString()); // 13:00:00