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 ein Datum oder eine Zeitzone; zum Beispiel ein wiederkehrendes Ereignis, das jeden Tag zur gleichen Zeit stattfindet. Es wird im Wesentlichen als Kombination von Stunde, Minute, Sekunde, Millisekunde, Mikrosekunde und Nanosekunde dargestellt.

Beschreibung

Ein PlainTime ist im Wesentlichen der Zeitanteil eines Temporal.PlainDateTime Objekts, wobei die Datumsinformationen entfernt wurden. Da Datum und Zeit wenig Interaktion haben, sind alle allgemeinen Informationen zu Zeiteigenschaften hier dokumentiert.

RFC 9557 Format

PlainTime Objekte können im RFC 9557 Format, einer Erweiterung des ISO 8601 / RFC 3339 Formats, serialisiert und geparst werden. Der String hat folgende Form:

HH:mm:ss.sssssssss

HH: Eine zweistellige Zahl von 00 bis 23. Sie kann durch den Zeitdesignator T oder t vorangestellt sein.
mm Optional: Eine zweistellige Zahl von 00 bis 59. Standardwert ist 00.
ss.sssssssss Optional: Eine zweistellige Zahl von 00 bis 59. Kann optional von einem . oder , und ein bis neun Ziffern gefolgt werden. Standardwert ist 00. Die Komponenten HH, mm und ss können durch : oder nichts getrennt werden. Sie können entweder nur ss oder sowohl ss als auch mm weglassen, sodass die Zeit in einer von drei Formen vorliegen kann: HH, HH:mm oder HH:mm:ss.sssssssss.

Als Eingabe können Sie optional das Datum, den Offset, die Zeitzonenkennung und den Kalender im gleichen Format wie bei PlainDateTime einschließen, aber sie werden ignoriert. Ein reiner Datums-String wird abgelehnt. Andere Anmerkungen im [key=value] Format werden ebenfalls ignoriert und dürfen nicht die kritische Flagge haben.

Beim Serialisieren können Sie die Bruchteile von Sekunden 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 zurück (-1, 0 oder 1), die angibt, ob die erste Zeit vor, gleich oder nach der zweiten Zeit liegt. Entspricht dem Vergleich der Stunden-, Minuten-, Sekunden-, Millisekunden-, Mikrosekunden- und Nanosekundenfelder nacheinander.
Temporal.PlainTime.from() Experimentell: Erstellt ein neues Temporal.PlainTime Objekt aus einem anderen Temporal.PlainTime Objekt, einem Objekt mit Zeiteigenschaften oder einem RFC 9557 String.

Instanz-Eigenschaften

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 der Temporal.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 Mikrosekunde (10^-6 Sekunde) dieser Zeit darstellt.
Temporal.PlainTime.prototype.millisecond Experimentell: Gibt eine ganze Zahl von 0 bis 999 zurück, die die Millisekunde (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 Nanosekunde (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 in Object.prototype.toString() verwendet.

Instanz-Methoden

Temporal.PlainTime.prototype.add() Experimentell: Gibt ein neues Temporal.PlainTime Objekt zurück, das diese Zeit um eine gegebene Dauer (in einer Form, die durch Temporal.Duration.from() konvertierbar ist) vorverlegt darstellt, wobei es bei Bedarf um den Uhrkreis herumläuft.
Temporal.PlainTime.prototype.equals() Experimentell: Gibt true zurück, wenn diese Zeit im Wert gleich einer anderen Zeit ist (in einer Form konvertierbar durch Temporal.PlainTime.from()), und false andernfalls. Sie werden durch ihre Zeitwerte verglichen. Entspricht Temporal.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 Form konvertierbar durch Temporal.PlainTime.from()) bis zu dieser Zeit darstellt. Die Dauer ist positiv, wenn die andere Zeit vor dieser Zeit liegt, und negativ, wenn sie danach liegt.
Temporal.PlainTime.prototype.subtract() Experimentell: Gibt ein neues Temporal.PlainTime Objekt zurück, das diese Zeit um eine gegebene Dauer (in einer Form, die durch Temporal.Duration.from() konvertierbar ist) zurückverlegt darstellt, wobei es bei Bedarf um den Uhrkreis herumläuft.
Temporal.PlainTime.prototype.toJSON() Experimentell: Gibt einen String zurück, der diese Zeit im gleichen RFC 9557 Format darstellt wie der Aufruf von toString(). Soll implizit durch JSON.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 bis zu einer anderen Zeit (in einer Form konvertierbar durch Temporal.PlainTime.from()) darstellt. Die Dauer ist positiv, wenn die andere Zeit nach dieser Zeit liegt, und negativ, wenn sie davor liegt.
Temporal.PlainTime.prototype.valueOf() Experimentell: Wirft einen TypeError, der verhindert, dass Temporal.PlainTime Instanzen implizit in primitive Typen umgewandelt 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 Feldern darstellt, die durch neue Werte ersetzt wurden.

Spezifikationen

Specification
Temporal # sec-temporal-plaintime-objects