Temporal.PlainTime
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.
Das Temporal.PlainTime
Objekt repräsentiert eine Zeit ohne Datum oder Zeitzone; zum Beispiel ein sich wiederholendes Ereignis, das jeden Tag zur gleichen Zeit stattfindet. Es wird im Wesentlichen als Kombination von Stunden-, Minuten-, Sekunden-, Millisekunden-, Mikrosekunden- und Nanosekundenwerten dargestellt.
Beschreibung
Ein PlainTime
ist im Grunde der Zeitteil eines Temporal.PlainDateTime
Objekts, wobei die Datumsinformation entfernt wurde. Da Datum und Zeit wenig Interaktion haben, sind alle allgemeinen Informationen zu Zeiteigenschaften hier dokumentiert.
RFC 9557 Format
PlainTime
Objekte können mithilfe des RFC 9557 Formats, einer Erweiterung des ISO 8601 / RFC 3339 Formats, serialisiert und geparst werden. Der String hat die folgende Form:
HH:mm:ss.sssssssss
HH
-
Eine zweistellige Zahl von
00
bis23
. Es kann mit dem ZeitbezeichnerT
odert
vorangestellt werden. mm
Optional-
Eine zweistellige Zahl von
00
bis59
. Standardmäßig00
. ss.sssssssss
Optional-
Eine zweistellige Zahl von
00
bis59
. Kann optional von einem.
oder,
gefolgt von ein bis neun Ziffern gefolgt werden. Standardmäßig00
. DieHH
,mm
undss
Komponenten können durch:
oder nichts getrennt werden. Sie können entweder nurss
oder sowohlss
als auchmm
weglassen, sodass die Zeit eine von drei Formen haben kann:HH
,HH:mm
oderHH:mm:ss.sssssssss
.
Als Eingabe können Sie optional das Datum, Offset, die Zeitzonenkennung und den Kalender im gleichen Format wie bei PlainDateTime
einfügen, aber sie werden ignoriert. Ein String, der nur aus einem Datum besteht, wird abgelehnt. Andere Anmerkungen im [key=value]
Format werden ebenfalls ignoriert und dürfen nicht das kritische Flag haben.
Beim Serialisieren können Sie die Bruchteilssekundenstellen konfigurieren.
Konstruktor
Temporal.PlainTime()
Experimentell-
Erstellt ein neues
Temporal.PlainTime
Objekt, indem die zugrunde liegenden Daten direkt übergeben werden.
Statische Methoden
Temporal.PlainTime.compare()
Experimentell-
Gibt eine Zahl (-1, 0 oder 1) zurück, die anzeigt, ob die erste Zeit vor, gleich oder nach der zweiten Zeit liegt. Entspricht dem Vergleich der Stunde-, Minuten-, Sekunden-, Millisekunden-, Mikrosekunden- und Nanosekundenfelder nacheinander.
Temporal.PlainTime.from()
Experimentell-
Erstellt ein neues
Temporal.PlainTime
Objekt aus einem anderenTemporal.PlainTime
Objekt, einem Objekt mit Zeiteigenschaften oder einem RFC 9557 String.
Instanzeigenschaften
Diese Eigenschaften sind auf Temporal.PlainTime.prototype
definiert und werden von allen Temporal.PlainTime
Instanzen geteilt.
Temporal.PlainTime.prototype.constructor
-
Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für
Temporal.PlainTime
Instanzen ist der Anfangswert derTemporal.PlainTime()
Konstruktor. Temporal.PlainTime.prototype.hour
Experimentell-
Gibt eine ganze Zahl von 0 bis 23 zurück, die die Stundenkomponente dieser Zeit darstellt.
Temporal.PlainTime.prototype.microsecond
Experimentell-
Gibt eine ganze Zahl von 0 bis 999 zurück, die die Mikrosekundenkomponente (10-6 Sekunde) dieser Zeit darstellt.
Temporal.PlainTime.prototype.millisecond
Experimentell-
Gibt eine ganze Zahl von 0 bis 999 zurück, die die Millisekundenkomponente (10-3 Sekunde) dieser Zeit darstellt.
Temporal.PlainTime.prototype.minute
Experimentell-
Gibt eine ganze Zahl von 0 bis 59 zurück, die die Minutenkomponente dieser Zeit darstellt.
Temporal.PlainTime.prototype.nanosecond
Experimentell-
Gibt eine ganze Zahl von 0 bis 999 zurück, die die Nanosekundenkomponente (10-9 Sekunde) dieser Zeit darstellt.
Temporal.PlainTime.prototype.second
Experimentell-
Gibt eine ganze Zahl von 0 bis 59 zurück, die die Sekundenkomponente dieser Zeit darstellt.
Temporal.PlainTime.prototype[Symbol.toStringTag]
-
Der Anfangswert der
[Symbol.toStringTag]
Eigenschaft ist der String"Temporal.PlainTime"
. Diese Eigenschaft wird inObject.prototype.toString()
verwendet.
Instanzmethoden
Temporal.PlainTime.prototype.add()
Experimentell-
Gibt ein neues
Temporal.PlainTime
Objekt zurück, das diese Zeit nach vorne um eine gegebene Dauer (in einer durchTemporal.Duration.from()
konvertierbaren Form) verschoben darstellt, und bei Bedarf um die Uhr wickelt. Temporal.PlainTime.prototype.equals()
Experimentell-
Gibt
true
zurück, wenn diese Zeit im Wert einer anderen Zeit entspricht (in einer durchTemporal.PlainTime.from()
konvertierbaren Form) undfalse
sonst. Sie werden durch ihre Zeitwerte verglichen. EntsprichtTemporal.PlainTime.compare(this, other) === 0
. Temporal.PlainTime.prototype.round()
Experimentell-
Gibt ein neues
Temporal.PlainTime
Objekt zurück, das diese Zeit auf die gegebene Einheit gerundet darstellt. Temporal.PlainTime.prototype.since()
Experimentell-
Gibt ein neues
Temporal.Duration
Objekt zurück, das die Dauer von einer anderen Zeit (in einer durchTemporal.PlainTime.from()
konvertierbaren Form) zu dieser Zeit darstellt. Die Dauer ist positiv, wenn die andere Zeit vor dieser Zeit ist, und negativ, wenn sie danach liegt. Temporal.PlainTime.prototype.subtract()
Experimentell-
Gibt ein neues
Temporal.PlainTime
Objekt zurück, das diese Zeit rückwärts um eine gegebene Dauer (in einer durchTemporal.Duration.from()
konvertierbaren Form) verschoben darstellt, und bei Bedarf um die Uhr wickelt. Temporal.PlainTime.prototype.toJSON()
Experimentell-
Gibt einen String zurück, der diese Zeit im gleichen RFC 9557 Format wie bei einem Aufruf von
toString()
darstellt. Soll implizit durchJSON.stringify()
aufgerufen werden. Temporal.PlainTime.prototype.toLocaleString()
Experimentell-
Gibt einen String mit einer sprachsensitiven Darstellung dieser Zeit zurück.
Temporal.PlainTime.prototype.toString()
Experimentell-
Gibt einen String zurück, der diese Zeit im RFC 9557 Format darstellt.
Temporal.PlainTime.prototype.until()
Experimentell-
Gibt ein neues
Temporal.Duration
Objekt zurück, das die Dauer von dieser Zeit zu einer anderen Zeit (in einer durchTemporal.PlainTime.from()
konvertierbaren Form) darstellt. Die Dauer ist positiv, wenn die andere Zeit nach dieser Zeit ist, und negativ, wenn sie vorher ist. Temporal.PlainTime.prototype.valueOf()
Experimentell-
Wirft einen
TypeError
, der verhindert, dassTemporal.PlainTime
Instanzen implizit zu primitiven Datenstrukturen konvertiert werden, wenn sie in arithmetischen oder Vergleichsoperationen verwendet werden. Temporal.PlainTime.prototype.with()
Experimentell-
Gibt ein neues
Temporal.PlainTime
Objekt zurück, das diese Zeit mit einigen durch neue Werte ersetzten Feldern darstellt.
Spezifikationen
Specification |
---|
Temporal proposal # sec-temporal-plaintime-objects |
Browser-Kompatibilität
BCD tables only load in the browser