Temporal.PlainDateTime.prototype.round()
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more support for this feature? Tell us why.
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
| Spezifikation |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.round |