Temporal.Instant.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 Temporal.Instant Instanzen gibt ein neues Temporal.Instant Objekt zurück, das diesen Zeitpunkt, gerundet auf die angegebene Einheit, darstellt.
Syntax
round(smallestUnit)
round(options)
Parameter
smallestUnit-
Ein String, der die
smallestUnitOption darstellt. Dies ist eine bequeme Überladung, daher istround(smallestUnit)äquivalent zuround({ smallestUnit }), 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 (auf eine ganze Zahl abgerundet), die das Rundungsinkrement in der angegebenen
smallestUnitdarstellt. Standard ist1. Das Inkrement und diesmallestUnitmüssen 24 Stunden gleichmäßig teilen; zum Beispiel sind 45 Sekunden ein Teiler von 86400 Sekunden, und 100 Minuten sind ein Teiler von 3600 Minuten. Dies ist etwas weniger streng als dieround()Methode der anderen Klassen, die alle erfordern, dass das Inkrement ein Teiler des Maximalwertes der Einheit ist. roundingModeOptional-
Ein String, der angibt, wie der Bruchteil der
smallestUnitgerundet werden soll. SieheIntl.NumberFormat(). Voreinstellung ist"halfExpand". smallestUnit-
Ein String, der die kleinste Einheit darstellt, die im Ergebnis enthalten sein soll. Der Wert muss einer der folgenden sein:
"hour","minute","second","millisecond","microsecond","nanosecond"oder deren Mehrzahlformen. Für Einheiten größer als"nanosecond"werden Bruchteile dersmallestUnitentsprechend den EinstellungenroundingIncrementundroundingModegerundet.
Rückgabewert
Ein neues Temporal.Instant Objekt, das diesen Zeitpunkt gerundet auf die angegebene Einheit darstellt, wobei alle Einheiten kleiner als smallestUnit auf null gesetzt werden.
Ausnahmen
RangeError-
Wird ausgelöst, wenn eine der Optionen ungültig ist.
Beispiele
Abrunden kleiner Einheiten
const instant = Temporal.Instant.fromEpochMilliseconds(1000);
const roundedInstant = instant.round("second");
console.log(roundedInstant.epochMilliseconds); // 1000
const instant2 = instant.round("minute");
console.log(instant2.epochMilliseconds); // 0
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.instant.prototype.round |