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 Zeitpunkt im RFC 9557 Format unter Verwendung der angegebenen Zeitzone darstellt.

Syntax

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 der Bruchteile entfernt. Andernfalls enthält der Bruchteil der Sekundenkomponente so viele Stellen, aufgefüllt mit Nullen oder gerundet, wie nötig.
roundingMode Optional: Ein String, der angibt, wie die Stellen der Bruchteile über fractionalSecondDigits hinaus gerundet werden sollen. Siehe Intl.NumberFormat(). Der Standardwert ist "trunc".
smallestUnit Optional: Ein String, der die kleinste Einheit angibt, 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 darstellt. Wenn eine Temporal.ZonedDateTime Instanz verwendet wird, wird deren Zeitzone verwendet. Wenn ein String, kann es sich um einen benannten Zeitzonenbezeichner, einen offset-Zeitzonenbezeichner oder einen Datum-Zeit-String handeln, der einen Zeitzonenbezeichner oder einen Offset enthält (siehe Zeitzonen und Offsets für weitere Informationen). Der Standardwert ist "UTC".

Rückgabewert

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

Ausnahmen

RangeError: Wird ausgelöst, wenn einer der Optionen ungültig ist.

Beispiele

Verwendung von toString()

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

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 # sec-temporal.instant.prototype.tostring