Temporal.PlainDateTime

Beschreibung

Ein PlainDateTime ist im Wesentlichen die Kombination aus einem Temporal.PlainDate und einem Temporal.PlainTime. Da die Datums- und Zeitinformationen wenig Interaktion haben, sind alle allgemeinen Informationen über Datumsmerkmale im PlainDate Objekt dokumentiert und alle allgemeinen Informationen über Zeitmerkmale im PlainTime Objekt.

Wenn das Datum-Zeit einen bestimmten Augenblick repräsentiert, der über Zeitzonen hinweg invariant bleiben soll, sollten Sie stattdessen das Temporal.ZonedDateTime Objekt verwenden. Verwenden Sie PlainDateTime, wenn Sie ein Ereignis darstellen müssen, das zu einer bestimmten Uhrzeit stattfindet, die in verschiedenen Zeitzonen ein unterschiedlicher Augenblick sein kann.

RFC 9557 Format

PlainDateTime Objekte können serialisiert und analysiert werden, indem das RFC 9557 Format verwendet wird, eine Erweiterung des ISO 8601 / RFC 3339 Formats. Der String hat die folgende Form (Leerzeichen dienen nur der Lesbarkeit und sollten im tatsächlichen String nicht vorhanden sein):

YYYY-MM-DD T HH:mm:ss.sssssssss [u-ca=calendar_id]

YYYY

Entweder eine vierstellige Zahl oder eine sechsstellige Zahl mit einem + oder - Zeichen.

MM

Eine zweistellige Zahl von 01 bis 12.

DD

Eine zweistellige Zahl von 01 bis 31. Die YYYY, MM, und DD Komponenten können durch - oder nichts getrennt werden.

T Optional

Der Datum-Zeit-Trenner, der T, t oder ein Leerzeichen sein kann. Nur vorhanden, wenn HH vorhanden ist.

HH Optional

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

mm Optional

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

ss.sssssssss Optional

Eine zweistellige Zahl von 00 bis 59. Kann optional gefolgt sein von einem . oder , und einem bis neun Ziffern. 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 in einer der drei Formen sein kann: HH, HH:mm, oder HH:mm:ss.sssssssss.

[u-ca=calendar_id] Optional

Ersetzen Sie calendar_id durch den zu verwendenden Kalender. Siehe Intl.supportedValuesOf() für eine Liste häufig unterstützter Kalendertypen. Standardmäßig [u-ca=iso8601]. Kann ein kritisches Flag haben, indem der Schlüssel mit ! vorangestellt wird: z.B. [!u-ca=iso8601]. Dieses Flag weist andere Systeme in der Regel darauf hin, dass es nicht ignoriert werden kann, wenn sie es nicht unterstützen. Der Temporal Parser wirft einen Fehler, wenn die Anmerkungen zwei oder mehr Kalenderanmerkungen enthalten und eine davon kritisch ist. Beachten Sie, dass YYYY-MM-DD immer als ISO 8601 Kalenderdatum interpretiert und dann in den angegebenen Kalender umgewandelt wird.

Als Eingabe dürfen Sie optional den Offset und die Zeitzonenkennung in demselben Format wie ZonedDateTime einschließen, diese werden jedoch ignoriert. Beachten Sie, dass der Offset nicht Z sein darf. Andere Anmerkungen im [key=value] Format werden ebenfalls ignoriert und dürfen nicht das kritische Flag haben.

Beim Serialisieren können Sie die Bruchteile von Sekunden konfiguriert, ob die Kalender-ID angezeigt werden soll, und ob ein kritisches Flag dafür hinzugefügt werden soll.

Konstruktor

Temporal.PlainDateTime() Experimentell

Erstellt ein neues Temporal.PlainDateTime Objekt, indem die zugrunde liegenden Daten direkt bereitgestellt werden.

Statische Methoden

Temporal.PlainDateTime.compare()

Gibt eine Zahl (-1, 0 oder 1) zurück, die anzeigt, ob die erste Datum-Zeit vor, gleich oder nach der zweiten Datum-Zeit liegt. Entspricht zunächst dem Vergleich ihrer Daten und dann dem Vergleich ihrer Zeiten, falls die Daten gleich sind.

Temporal.PlainDateTime.from()

Erstellt ein neues Temporal.PlainDateTime Objekt aus einem anderen Temporal.PlainDateTime Objekt, einem Objekt mit Datums- und Zeiteigenschaften oder einem RFC 9557 String.

Instanz-Eigenschaften

Diese Eigenschaften sind auf Temporal.PlainDateTime.prototype definiert und werden von allen Instanzen von Temporal.PlainDateTime geteilt.

Temporal.PlainDateTime.prototype.calendarId

Gibt einen String zurück, der den Kalender repräsentiert, der zur Interpretation des internen ISO 8601 Datums verwendet wird.

Temporal.PlainDateTime.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für Temporal.PlainDateTime Instanzen ist der Anfangswert der Temporal.PlainDateTime() Konstruktor.

Temporal.PlainDateTime.prototype.day

Gibt eine positive Ganzzahl zurück, die den 1-basierten Tagesindex im Monat dieses Datums repräsentiert, welcher die gleiche Tagesnummer ist, die Sie auf einem Kalender sehen würden. Kalender-abhängig. Beginnt im Allgemeinen bei 1 und ist durchgängig, aber nicht immer.

Temporal.PlainDateTime.prototype.dayOfWeek

Gibt eine positive Ganzzahl zurück, die den 1-basierten Tagesindex in der Woche dieses Datums repräsentiert. Tage in einer Woche sind der Reihe nach von 1 bis daysInWeek nummeriert, wobei jede Nummer ihrem Namen zugeordnet wird. Kalender-abhängig. Normalerweise repräsentiert 1 den Montag im Kalender, auch wenn Lokale, die den Kalender verwenden, einen anderen Tag als den ersten Tag der Woche betrachten können (siehe Intl.Locale.prototype.getWeekInfo()).

Temporal.PlainDateTime.prototype.dayOfYear

Gibt eine positive Ganzzahl zurück, die den 1-basierten Tagesindex im Jahr dieses Datums repräsentiert. Der erste Tag dieses Jahres ist 1, und der letzte Tag ist der daysInYear. Kalender-abhängig.

Temporal.PlainDateTime.prototype.daysInMonth

Gibt eine positive Ganzzahl zurück, die die Anzahl der Tage im Monat dieses Datums repräsentiert. Kalender-abhängig.

Temporal.PlainDateTime.prototype.daysInWeek

Gibt eine positive Ganzzahl zurück, die die Anzahl der Tage in der Woche dieses Datums repräsentiert. Kalender-abhängig. Für den ISO 8601 Kalender sind dies immer 7, aber in anderen Kalendersystemen kann es von Woche zu Woche unterschiedlich sein.

Temporal.PlainDateTime.prototype.daysInYear

Gibt eine positive Ganzzahl zurück, die die Anzahl der Tage im Jahr dieses Datums repräsentiert. Kalender-abhängig. Für den ISO 8601 Kalender sind dies 365, oder 366 in einem Schaltjahr.

Temporal.PlainDateTime.prototype.era

Gibt einen kalenderspezifischen Kleinbuchstaben-String zurück, der die Ära dieses Datums repräsentiert, oder undefined, wenn der Kalender keine Ären verwendet (z.B. ISO 8601). era und eraYear identifizieren zusammen ein Jahr in einem Kalender eindeutig, auf die gleiche Weise wie year. Kalender-abhängig. Für den Gregorianischen Kalender ist es entweder "ce" oder "bce".

Temporal.PlainDateTime.prototype.eraYear

Gibt eine nicht-negative Ganzzahl zurück, die das Jahr dieses Datums innerhalb der Ära repräsentiert, oder undefined, wenn der Kalender keine Ären verwendet (z.B. ISO 8601). Der Jahresindex beginnt normalerweise bei 1 (häufiger) oder 0, und die Jahre in einer Ära können mit der Zeit abnehmen (z.B. Gregorianisches BCE). era und eraYear identifizieren zusammen ein Jahr in einem Kalender eindeutig, auf die gleiche Weise wie year.Kalender-abhängig.

Temporal.PlainDateTime.prototype.hour

Gibt eine Ganzzahl von 0 bis 23 zurück, die die Stundenkomponente dieser Zeit repräsentiert.

Temporal.PlainDateTime.prototype.inLeapYear

Gibt einen Boolean zurück, der angibt, ob dieses Datum in einem Schaltjahr liegt. Ein Schaltjahr ist ein Jahr, das mehr Tage hat (aufgrund eines Schalttages oder Schaltmonats) als ein normales Jahr. Kalender-abhängig.

Temporal.PlainDateTime.prototype.microsecond

Gibt eine Ganzzahl von 0 bis 999 zurück, die die Mikrosekunde (10^-6 Sekunde) Komponente dieser Zeit repräsentiert.

Temporal.PlainDateTime.prototype.millisecond

Gibt eine Ganzzahl von 0 bis 999 zurück, die die Millisekunde (10^-3 Sekunde) Komponente dieser Zeit repräsentiert.

Temporal.PlainDateTime.prototype.minute

Gibt eine Ganzzahl von 0 bis 59 zurück, die die Minutenkomponente dieser Zeit repräsentiert.

Temporal.PlainDateTime.prototype.month

Gibt eine positive Ganzzahl zurück, die den 1-basierten Monatsindex im Jahr dieses Datums repräsentiert. Der erste Monat dieses Jahres ist 1, und der letzte Monat ist der monthsInYear. Kalender-abhängig. Beachten Sie, dass im Gegensatz zu Date.prototype.getMonth() der Index 1-basiert ist. Wenn der Kalender Schaltmonate hat, dann kann der Monat mit dem gleichen monthCode unterschiedliche month Indizes für verschiedene Jahre haben.

Temporal.PlainDateTime.prototype.monthCode

Gibt einen kalenderspezifischen String zurück, der den Monat dieses Datums repräsentiert. Kalender-abhängig. Üblicherweise ist es M plus eine zweistellige Monatszahl. Für Schaltmonate ist es der Code des Vormonats gefolgt von L. Wenn der Schaltmonat der erste Monat des Jahres ist, ist der Code M00L.

Temporal.PlainDateTime.prototype.monthsInYear

Gibt eine positive Ganzzahl zurück, die die Anzahl der Monate im Jahr dieses Datums repräsentiert. Kalender-abhängig. Für den ISO 8601 Kalender sind dies immer 12, aber in anderen Kalendersystemen kann es unterschiedlich sein.

Temporal.PlainDateTime.prototype.nanosecond

Gibt eine Ganzzahl von 0 bis 999 zurück, die die Nanosekunde (10^-9 Sekunde) Komponente dieser Zeit repräsentiert.

Temporal.PlainDateTime.prototype.second

Gibt eine Ganzzahl von 0 bis 59 zurück, die die Sekundenkomponente dieser Zeit repräsentiert.

Temporal.PlainDateTime.prototype.weekOfYear

Gibt eine positive Ganzzahl zurück, die den 1-basierten Wochenindex im yearOfWeek dieses Datums repräsentiert, oder undefined, wenn der Kalender kein gut definiertes Wochensystem hat. Die erste Woche des Jahres ist 1. Kalender-abhängig. Beachten Sie, dass es für ISO 8601 die ersten und letzten Tage des Jahres an die letzte Woche des Vorjahres oder die erste Woche des nächsten Jahres attributiert werden können.

Temporal.PlainDateTime.prototype.year

Gibt eine Ganzzahl zurück, die die Anzahl der Jahre dieses Datums relativ zum Beginn eines kalenderspezifischen Epochejahrs repräsentiert. Kalender-abhängig. Normalerweise ist das Jahr 1 entweder das erste Jahr der neuesten Ära oder das ISO 8601 Jahr 0001. Wenn die Epoche mitten im Jahr liegt, hat dieses Jahr denselben Wert vor und nach dem Startdatum der Ära.

Temporal.PlainDateTime.prototype.yearOfWeek

Gibt eine Ganzzahl zurück, die das Jahr repräsentiert, das mit der weekOfYear dieses Datums zu paaren ist, oder undefined, wenn der Kalender kein gut definiertes Wochensystem hat. Kalender-abhängig. Normalerweise ist dies das Jahr des Datums, aber für ISO 8601 können die ersten und letzten Tage des Jahres der letzten Woche des Vorjahres oder der ersten Woche des nächsten Jahres zugeordnet werden, was dazu führt, dass sich yearOfWeek um 1 unterscheidet.

Temporal.PlainDateTime.prototype[Symbol.toStringTag]

Der Anfangswert der [Symbol.toStringTag] Eigenschaft ist der String "Temporal.PlainDateTime". Diese Eigenschaft wird in Object.prototype.toString() verwendet.

Instanz-Methoden

Temporal.PlainDateTime.prototype.add()

Gibt ein neues Temporal.PlainDateTime Objekt zurück, das diese Datum-Zeit repräsentiert, verschoben um eine gegebene Dauer (in einer Form, die durch Temporal.Duration.from() konvertierbar ist).

Temporal.PlainDateTime.prototype.equals()

Gibt true zurück, wenn diese Datum-Zeit einem anderen Datum-Zeitwert (in einer Form konvertierbar durch Temporal.PlainDateTime.from()) gleichwertig ist, und false andernfalls. Sie werden sowohl anhand ihres Datums und ihrer Zeitwerte als auch anhand ihrer Kalender verglichen, sodass zwei Datum-Zeitpunkte aus unterschiedlichen Kalendern durch Temporal.PlainDateTime.compare() gleich sein können, aber nicht durch equals() bewertet werden.

Temporal.PlainDateTime.prototype.round()

Gibt ein neues Temporal.PlainDateTime Objekt zurück, das diese Datum-Zeit repräsentiert, gerundet auf die gegebene Einheit.

Temporal.PlainDateTime.prototype.since()

Gibt ein neues Temporal.Duration Objekt zurück, das die Dauer von einem anderen Datum-Zeitpunkt (in einer Form konvertierbar durch Temporal.PlainDateTime.from()) bis zu dieser Datum-Zeitpunkt darstellt. Die Dauer ist positiv, wenn der andere Datum-Zeitpunkt vor dieser Datum-Zeitpunkt liegt, und negativ, wenn danach.

Temporal.PlainDateTime.prototype.subtract()

Gibt ein neues Temporal.PlainDateTime Objekt zurück, das diese Datum-Zeit repräsentiert, verschoben um eine gegebene Dauer (in einer Form konvertierbar durch Temporal.Duration.from()).

Temporal.PlainDateTime.prototype.toJSON()

Gibt einen String zurück, der diese Datum-Zeit in demselben RFC 9557 Format wie beim Aufrufen von toString() repräsentiert. Soll implizit von JSON.stringify() aufgerufen werden.

Temporal.PlainDateTime.prototype.toLocaleString()

Gibt einen String mit einer sprachsensitiven Darstellung dieser Datum-Zeit zurück.

Temporal.PlainDateTime.prototype.toPlainDate()

Gibt ein neues Temporal.PlainDate Objekt zurück, das den Datenteil (Jahr, Monat, Tag) dieser Datum-Zeit im selben Kalendersystem repräsentiert.

Temporal.PlainDateTime.prototype.toPlainTime()

Gibt ein neues Temporal.PlainTime Objekt zurück, das den Zeitteil (Stunde, Minute, Sekunde und Subsekundenkomponenten) dieser Datum-Zeit repräsentiert.

Temporal.PlainDateTime.prototype.toString()

Gibt einen String zurück, der diese Datum-Zeit im RFC 9557 Format repräsentiert.

Temporal.PlainDateTime.prototype.toZonedDateTime()

Gibt eine neue Temporal.ZonedDateTime Instanz zurück, die dieselbe Datum-Zeit wie diese einfache Datum-Zeit repräsentiert, jedoch in der angegebenen Zeitzone.

Temporal.PlainDateTime.prototype.until()

Gibt ein neues Temporal.Duration Objekt zurück, das die Dauer von dieser Datum-Zeit bis zu einem anderen Datum-Zeitpunkt (in einer Form konvertierbar durch Temporal.PlainDateTime.from()) darstellt. Die Dauer ist positiv, wenn der andere Datum-Zeitpunkt nach dieser Datum-Zeitpunkt liegt, und negativ, wenn davor.

Temporal.PlainDateTime.prototype.valueOf()

Wirft einen TypeError, der verhindert, dass Temporal.PlainDateTime Instanzen implizit in Primitive umgewandelt werden, wenn sie in arithmetischen oder Vergleichsoperationen verwendet werden.

Temporal.PlainDateTime.prototype.with()

Gibt ein neues Temporal.PlainDateTime Objekt zurück, das diese Datum-Zeit repräsentiert, wobei einige Felder durch neue Werte ersetzt werden.

Temporal.PlainDateTime.prototype.withCalendar()

Gibt ein neues Temporal.PlainDateTime Objekt zurück, das diese Datum-Zeit, interpretiert im neuen Kalendersystem, repräsentiert.

Temporal.PlainDateTime.prototype.withPlainTime()

Gibt ein neues Temporal.PlainDateTime Objekt zurück, das diese Datum-Zeit repräsentiert, wobei der Zeitanteil vollständig durch die neue Zeit ersetzt wird (in einer Form konvertierbar durch Temporal.PlainTime.from()).

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Temporal
• Temporal.Duration
• Temporal.PlainDate
• Temporal.PlainTime
• Temporal.ZonedDateTime