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 wiederkehrendes Ereignis, das jeden Tag zur gleichen Zeit stattfindet. Es wird grundsätzlich als Kombination von Stunde, Minute, Sekunde, Millisekunde, Mikrosekunde und Nanosekunde dargestellt.

Beschreibung

Ein PlainTime ist im Wesentlichen der Zeitteil eines Temporal.PlainDateTime Objekts, wobei die Datumsinformationen entfernt wurden. Da das Datum und die Zeitinformationen kaum miteinander interagieren, werden alle allgemeinen Informationen zu Zeiteigenschaften hier dokumentiert.

RFC 9557 Format

PlainTime Objekte können unter Verwendung 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. Sie kann durch den Zeitdesignator T oder t eingeleitet 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 , und einer 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 der drei Formen annehmen 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 PlainDateTime einschließen, aber sie werden ignoriert. Ein reiner Datumsstring wird abgelehnt. Andere Anmerkungen im [key=value] Format werden ebenfalls ignoriert und dürfen das kritische Flag nicht haben.

Bei der Serialisierung können Sie die Anzahl der Bruchteilstellen der Sekunden konfigurieren.

Konstruktor

Temporal.PlainTime() Experimentell: Erzeugt ein neues Temporal.PlainTime Objekt, indem die zugrunde liegenden Daten direkt bereitgestellt werden.

Statische Methoden

Temporal.PlainTime.compare() Experimentell: Gibt eine Zahl (-1, 0 oder 1) zurück, die angibt, ob die erste Zeit vor der zweiten liegt, gleich ist oder danach kommt. Entspricht dem Vergleich der Stunden-, Minuten-, Sekunden-, Millisekunden-, Mikrosekunden- und Nanosekundenfelder nacheinander.
Temporal.PlainTime.from() Experimentell: Erzeugt 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 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.

Instanz-Methoden

Temporal.PlainTime.prototype.add() Experimentell: Gibt ein neues Temporal.PlainTime Objekt zurück, das diese Zeit, verschoben um eine gegebene Dauer (in einer Form umwandelbar durch Temporal.Duration.from()), repräsentiert, und um die Uhr gedreht wird, falls nötig.
Temporal.PlainTime.prototype.equals() Experimentell: Gibt true zurück, wenn diese Zeit einem anderen Zeitwert (in einer Form umwandelbar durch Temporal.PlainTime.from()) entspricht, und false andernfalls. Sie werden anhand ihrer 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, gerundet auf die gegebene Einheit, repräsentiert.
Temporal.PlainTime.prototype.since() Experimentell: Gibt ein neues Temporal.Duration Objekt zurück, das die Dauer von einer anderen Zeit (in einer Form umwandelbar durch Temporal.PlainTime.from()) bis zu dieser Zeit darstellt. Die Dauer ist positiv, wenn die andere Zeit vor dieser Zeit ist, und negativ, wenn sie danach ist.
Temporal.PlainTime.prototype.subtract() Experimentell: Gibt ein neues Temporal.PlainTime Objekt zurück, das diese Zeit, zurückgesetzt um eine gegebene Dauer (in einer Form umwandelbar durch Temporal.Duration.from()), repräsentiert und um die Uhr gedreht wird, falls nötig.
Temporal.PlainTime.prototype.toJSON() Experimentell: Gibt einen String zurück, der diese Zeit im gleichen RFC 9557 Format wie beim 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 Form umwandelbar durch Temporal.PlainTime.from()) darstellt. Die Dauer ist positiv, wenn die andere Zeit nach dieser Zeit ist, und negativ, wenn sie davor ist.
Temporal.PlainTime.prototype.valueOf() Experimentell: Löst einen TypeError aus, was verhindert, dass Temporal.PlainTime Instanzen implizit in primitive Werte 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 durch neue Werte ersetzten Feldern repräsentiert.

Spezifikationen

Specification
Temporal proposal # sec-temporal-plaintime-objects