Temporal.Instant.prototype.toString()

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 Ganzzahl 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 Stellen, wie angegeben, gepolstert mit Nullen oder bei Bedarf gerundet.

roundingMode Optional

Ein String, der angibt, wie Bruchteile von Sekundenziffern über fractionalSecondDigits hinaus gerundet werden sollen. Siehe Intl.NumberFormat(). Standardmäßig "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") den fractionalSecondDigits-Werten von 0, 3, 6, 9 entsprechen. Wenn angegeben, wird fractionalSecondDigits ignoriert.

timeZone Optional

Entweder ein String oder eine Temporal.ZonedDateTime-Instanz, die die zu verwendende Zeitzone darstellt. Wenn es sich um eine Temporal.ZonedDateTime-Instanz handelt, wird deren Zeitzone verwendet. Wenn es ein String ist, kann es sich um einen benannten Zeitzonen-Identifier, einen Offset-Zeitzonen-Identifier oder einen Datum-Uhrzeit-String handeln, der einen Zeitzonen-Identifier oder einen Offset enthält (siehe Zeitzonen und Offsets für mehr Informationen). Standardwert ist "UTC".

Rückgabewert

Ein String im RFC 9557-Format, der diesen Moment unter Verwendung der angegebenen Zeitzone darstellt. Keine Anmerkungen, wie Zeitzonen-Namen, sind enthalten.

Ausnahmen

RangeError

Wird ausgelöst, wenn eine 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

Browser-Kompatibilität

Siehe auch

• Temporal.Instant
• Temporal.Instant.from()
• Temporal.Instant.prototype.toJSON()
• Temporal.Instant.prototype.toLocaleString()