Temporal.Now
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Das Temporal.Now-Namensraumobjekt enthält statische Methoden, um die aktuelle Zeit in verschiedenen Formaten zu erhalten.
Beschreibung
Im Gegensatz zu den meisten globalen Objekten ist Temporal.Now kein Konstruktor. Sie können es weder mit dem new Operator verwenden noch das Temporal.Now-Objekt als Funktion aufrufen. Alle Eigenschaften und Methoden von Temporal.Now sind statisch (genau wie das Math-Objekt).
Grundlegend wird die Systemzeit vom Betriebssystem als Zeit seit der Unix-Epoche zurückgegeben (normalerweise mit Millisekundenpräzision, aber möglicherweise auch mit Nanosekundenpräzision). Temporal.Now.instant() gibt diese Zeit als Temporal.Instant-Objekt zurück.
Ein Zeitpunkt kann in einer Zeitzone interpretiert werden (was standardmäßig die Systemzeitzone Temporal.Now.timeZoneId() ist), ähnlich wie in Temporal.Instant.prototype.toZonedDateTimeISO(). Um ein Temporal.ZonedDateTime-Objekt zu erhalten, können Sie Temporal.Now.zonedDateTimeISO() verwenden. Sie können auch verschiedene Teile des Datums und der Zeit erhalten, indem Sie Temporal.Now.plainDateISO(), Temporal.Now.plainTimeISO() und Temporal.Now.plainDateTimeISO() verwenden.
Wenn der Computer beispielsweise auf die Zeitzone "America/New_York" eingestellt ist, gibt Temporal.Now.zonedDateTimeISO() ein zoned date-time zurück wie: 2021-08-01T10:40:12.345-04:00[America/New_York]. In diesem Fall würde Temporal.Now.plainTimeISO() den Zeitteil dieses zoned date-time zurückgeben: 10:40:12.345. Wenn Sie jedoch Temporal.Now.plainTimeISO("UTC") aufrufen, gibt es den Zeitteil des zoned date-time in der UTC-Zeitzone zurück: 14:40:12.345. Dies ist besonders nützlich für die Kommunikation zwischen Systemen, bei der das andere Ende möglicherweise die Zeit in einer anderen Zeitzone erwartet.
Reduzierte Zeitpräzision
Um Schutz gegen Timing-Angriffe und Fingerprinting zu bieten, könnte die Präzision der Temporal.Now-Funktionen je nach Browsereinstellungen gerundet werden. In Firefox ist die privacy.reduceTimerPrecision-Einstellung standardmäßig aktiviert und auf 2ms voreingestellt. Sie können auch privacy.resistFingerprinting aktivieren, in diesem Fall wird die Präzision 100ms oder der Wert von privacy.resistFingerprinting.reduceTimerPrecision.microseconds sein, je nachdem, welcher größer ist.
Mit reduzierter Zeitpräzision ist das Ergebnis von Temporal.Now.instant().epochMilliseconds immer ein Vielfaches von 2, oder ein Vielfaches von 100 (oder privacy.resistFingerprinting.reduceTimerPrecision.microseconds), wenn privacy.resistFingerprinting aktiviert ist.
// reduced time precision (2ms) in Firefox 60
Temporal.Now.instant().epochMilliseconds;
// Might be:
// 1519211809934
// 1519211810362
// 1519211811670
// …
// reduced time precision with `privacy.resistFingerprinting` enabled
Temporal.Now.instant().epochMilliseconds;
// Might be:
// 1519129853500
// 1519129858900
// 1519129864400
// …
Statische Eigenschaften
Temporal.Now[Symbol.toStringTag]-
Der Anfangswert der
[Symbol.toStringTag]-Eigenschaft ist der String"Temporal.Now". Diese Eigenschaft wird inObject.prototype.toString()verwendet.
Statische Methoden
Temporal.Now.instant()-
Gibt die aktuelle Zeit als
Temporal.Instant-Objekt zurück. Temporal.Now.plainDateISO()-
Gibt das aktuelle Datum als
Temporal.PlainDate-Objekt zurück, im ISO 8601-Kalender und der angegebenen Zeitzone. Temporal.Now.plainDateTimeISO()-
Gibt das aktuelle Datum und die Zeit als
Temporal.PlainDateTime-Objekt zurück, im ISO 8601-Kalender und der angegebenen Zeitzone. Temporal.Now.plainTimeISO()-
Gibt die aktuelle Zeit als
Temporal.PlainTime-Objekt zurück, in der angegebenen Zeitzone. Temporal.Now.timeZoneId()-
Gibt eine Zeitzonenkennung zurück, die die aktuelle Zeitzone des Systems repräsentiert.
Temporal.Now.zonedDateTimeISO()-
Gibt das aktuelle Datum und die Zeit als
Temporal.ZonedDateTime-Objekt zurück, im ISO 8601-Kalender und der angegebenen Zeitzone.
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal-now-object |