Temporal.PlainDateTime : 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.PlainDateTime retourne un nouvel objet Temporal.PlainDateTime représentant cette date-heure arrondie à l'unité donné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 de caractères.

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. Pour toutes les valeurs de smallestUnit sauf "day", l'incrément doit être un diviseur de la valeur maximale de l'unité ; 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. Pour "day", l'incrément doit être 1.
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 : "day", "hour", "minute", "second", "millisecond", "microsecond", "nanosecond", ou leurs formes plurielles. Pour les unités plus grandes que "nanosecond", les parties fractionnaires de smallestUnit seront arrondies selon les paramètres roundingIncrement et roundingMode.

Valeur de retour

Un nouvel objet Temporal.PlainDateTime représentant cette valeur de date et d'heure arrondie à l'unité donnée, où toutes les unités plus petites que smallestUnit sont mises à zéro.

Exceptions

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

Exemples

Arrondir les petites unités

const dt = Temporal.PlainDateTime.from("2021-07-01T12:34:56.123456789");
const nearestMillisecond = dt.round("millisecond");
console.log(nearestMillisecond.toString()); // 2021-07-01T12:34:56.123

const nearestHalfHour = dt.round({
  smallestUnit: "minute",
  roundingIncrement: 30,
});
console.log(nearestHalfHour.toString()); // 2021-07-01T12:30:00

const nextDay = dt.round({ smallestUnit: "day", roundingMode: "ceil" });
console.log(nextDay.toString()); // 2021-07-02T00:00:00