Temporal.Instant.prototype.toString()

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 toString()-Methode von Temporal.Instant-Instanzen gibt einen String zurück, der diesen Moment im RFC 9557-Format unter Verwendung der angegebenen Zeitzone darstellt.

Syntax

js
toString()
toString(options)

Parameter

options Optional

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

fractionalSecondDigits Optional

Entweder eine ganze Zahl von 0 bis 9 oder der String "auto". Der Standardwert ist "auto". Wenn "auto", werden nachfolgende Nullen von den Bruchteilen der Sekunden entfernt. Andernfalls enthält der Bruchteil der Sekundenkomponente so viele Ziffern, wie nötig mit Nullen aufgefüllt oder gerundet werden.

roundingMode Optional

Ein String, der angibt, wie die Bruchteile der Sekunden über fractionalSecondDigits hinaus gerundet werden sollen. Siehe Intl.NumberFormat(). Standardmäßig auf "trunc".

smallestUnit Optional

Ein String, der die kleinste Einheit festlegt, die in der Ausgabe enthalten sein soll. Mögliche Werte sind "minute", "second", "millisecond", "microsecond" und "nanosecond", oder deren Pluralformen, die (außer "minute") äquivalent zu fractionalSecondDigits-Werten von 0, 3, 6, 9 sind. Wenn angegeben, wird fractionalSecondDigits ignoriert.

timeZone Optional

Entweder ein String oder eine Temporal.ZonedDateTime-Instanz, die die zu verwendende Zeitzone repräsentiert. Wenn eine Temporal.ZonedDateTime-Instanz, wird deren Zeitzone verwendet. Wenn ein String, kann es sich um eine benannte Zeitzonenkennung, eine Offset-Zeitzonenkennung oder einen Datum-Zeit-String mit einer Zeitzonenkennung oder einem Offset handeln (siehe Zeitzonen und Offsets für weitere Informationen). Standard ist "UTC".

Rückgabewert

Ein String im RFC 9557-Format, der diesen Moment unter Verwendung der angegebenen Zeitzone darstellt. Es sind keine Anmerkungen, wie Zeitzonennamen, enthalten.

Ausnahmen

RangeError

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

Beispiele

Verwendung von toString()

js
const instant = Temporal.Instant.fromEpochMilliseconds(1627814412345);
console.log(instant.toString()); // '2021-08-01T10:40:12.345Z'

// Stringification implicitly calls toString()
console.log(`${instant}`); // '2021-08-01T10:40:12.345Z'

Verwendung von Optionen

js
const instant = Temporal.Instant.fromEpochMilliseconds(1627814412345);
console.log(instant.toString({ fractionalSecondDigits: 1 })); // '2021-08-01T10:40:12.3Z'
console.log(instant.toString({ smallestUnit: "minute" })); // '2021-08-01T10:40Z'
console.log(instant.toString({ timeZone: "America/New_York" })); // '2021-08-01T06:40:12.345-04:00'

// The time zone name automatically resolves to the correct offset
// based on the instant; for example, America/New_York is UTC-4 in summer,
// but UTC-5 in winter.
const instant2 = Temporal.Instant.fromEpochMilliseconds(1577836800000);
console.log(instant2.toString({ timeZone: "UTC" })); // '2029-12-31T23:00:00Z'
console.log(instant2.toString({ timeZone: "America/New_York" })); // '2019-12-31T19:00:00-05:00'

Spezifikationen

Specification
Temporal proposal
# sec-temporal.instant.prototype.tostring

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch