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 bis 23. Es kann mit dem Zeitbezeichner T oder t vorangestellt werden.

mm Optional

Eine zweistellige Zahl von 00 bis 59. Standardmäßig 00.

ss.sssssssss Optional

Eine zweistellige Zahl von 00 bis 59. Kann optional von einem . oder , gefolgt von ein bis neun Ziffern gefolgt werden. Standardmäßig 00. Die HH, mm und ss Komponenten können durch : oder nichts getrennt werden. Sie können entweder nur ss oder sowohl ss als auch mm weglassen, sodass die Zeit eine von drei Formen haben kann: HH, HH:mm oder HH: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 anderen Temporal.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 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 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 in Object.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 durch Temporal.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 durch Temporal.PlainTime.from() konvertierbaren Form) und false sonst. 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 durch Temporal.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 durch Temporal.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 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 zu einer anderen Zeit (in einer durch Temporal.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, dass Temporal.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

Siehe auch