Temporal.PlainDateTime.prototype.round()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die round() Methode von Instanzen von Temporal.PlainDateTime gibt ein neues Temporal.PlainDateTime-Objekt zurück, das diesen Datum-Uhrzeit-Wert auf die angegebene Einheit gerundet darstellt.
Syntax
round(smallestUnit)
round(options)
Parameter
smallestUnit-
Ein String, der die
smallestUnitOption darstellt. Dies ist eine Überladung zur Vereinfachung, so dassround(smallestUnit)äquivalent zuround({ smallestUnit })ist, wobeismallestUnitein String ist. options-
Ein Objekt, das einige oder alle der folgenden Eigenschaften enthält (in der Reihenfolge, in der sie abgerufen und validiert werden):
roundingIncrementOptional-
Eine Zahl (abgerundet auf eine ganze Zahl), die den Rundungsinkrement in der gegebenen
smallestUnitdarstellt. Standardmäßig1. Für alle Werte vonsmallestUnitaußer"day"muss der Inkrement ein Teiler des Maximalwerts der Einheit sein; zum Beispiel, wenn die Einheit Stunden ist, muss der Inkrement ein Teiler von 24 sein und darf nicht 24 selbst sein, was bedeutet, dass es 1, 2, 3, 4, 6, 8 oder 12 sein kann. Für"day"muss der Inkrement 1 sein. roundingModeOptional-
Ein String, der angibt, wie der Bruchteil von
smallestUnitgerundet werden soll. SieheIntl.NumberFormat(). Standardmäßig"halfExpand". smallestUnit-
Ein String, der die kleinste Einheit darstellt, die im Ergebnis enthalten sein soll. Der Wert muss einer der folgenden sein:
"day","hour","minute","second","millisecond","microsecond","nanosecond"oder deren Pluralformen. Für Einheiten größer als"nanosecond"werden Bruchteile dersmallestUnitgemäß den EinstellungenroundingIncrementundroundingModegerundet.
Rückgabewert
Ein neues Temporal.PlainDateTime-Objekt, das diesen Datum-Uhrzeit-Wert auf die angegebene Einheit gerundet darstellt, wobei alle Einheiten kleiner als smallestUnit auf null gesetzt werden.
Ausnahmen
RangeError-
Wird ausgelöst, wenn eine der Optionen ungültig ist.
Beispiele
Kleine Einheiten runden
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
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.round |