Temporal.PlainDateTime.prototype.round()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die round() Methode von Temporal.PlainDateTime Instanzen gibt ein neues Temporal.PlainDateTime-Objekt zurück, das diesen Datum-Uhrzeit-Wert auf die angegebene Einheit gerundet darstellt.

Syntax

js
round(smallestUnit)
round(options)

Parameter

smallestUnit

Ein String, der die smallestUnit-Option darstellt. Dies ist eine Komfort-Überladung, sodass round(smallestUnit) gleichbedeutend mit round({ smallestUnit }) ist, wobei smallestUnit ein String ist.

options

Ein Objekt, das einige oder alle der folgenden Eigenschaften enthält (in der Reihenfolge, in der sie abgerufen und validiert werden):

roundingIncrement Optional

Eine Zahl (auf eine ganze Zahl gekürzt), die den Rundungsinkrement in der angegebenen smallestUnit darstellt. Standardwert ist 1. Für alle Werte von smallestUnit außer "day" muss der Inkrement ein Teiler des Maximalwertes 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.

roundingMode Optional

Ein String, der angibt, wie der Bruchteil der smallestUnit gerundet werden soll. Siehe Intl.NumberFormat(). Standardwert ist "halfExpand".

smallestUnit

Ein String, der die kleinste Einheit repräsentiert, die in der Ausgabe 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 der smallestUnit entsprechend den Einstellungen roundingIncrement und roundingMode gerundet.

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 sind.

Ausnahmen

RangeError

Wird ausgelöst, wenn eine der Optionen ungültig ist.

Beispiele

Abrunden kleiner Einheiten

js
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 proposal
# sec-temporal.plaindatetime.prototype.round

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
round
Experimental

Legend

Tip: you can click/tap on a cell for more information.

No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
User must explicitly enable this feature.

Siehe auch