Temporal.PlainDateTime

Beschreibung

Ein PlainDateTime ist im Wesentlichen die Kombination aus einem Temporal.PlainDate und einem Temporal.PlainTime. Da die Informationen über Datum und Uhrzeit wenig miteinander interagieren, sind alle allgemeinen Informationen über Datumseigenschaften im PlainDate-Objekt dokumentiert und alle allgemeinen Informationen über Uhrzeiteigenschaften im PlainTime-Objekt.

Wenn das Datum und die Uhrzeit einen bestimmten Moment darstellen, der über Zeitzonen hinweg unveränderlich bleiben soll, sollten Sie stattdessen das Temporal.ZonedDateTime-Objekt verwenden. Verwenden Sie PlainDateTime, wenn Sie ein Ereignis darstellen müssen, das zu einer bestimmten Wanduhrzeit stattfindet, die in verschiedenen Zeitzonen ein anderer Moment sein kann.

RFC 9557 Format

PlainDateTime-Objekte können im RFC 9557-Format, einer Erweiterung des ISO 8601 / RFC 3339-Formats, serialisiert und analysiert werden. 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 Komponenten YYYY, MM und DD können durch - oder nichts getrennt sein.

T Optional

Der Datum-Uhrzeit-Trennzeichen, das T, t oder ein Leerzeichen sein kann. Nur vorhanden, wenn HH vorhanden ist.

HH Optional

Eine zweistellige Zahl von 00 bis 23. Standard ist 00.

mm Optional

Eine zweistellige Zahl von 00 bis 59. Standard ist 00.

ss.sssssssss Optional

Eine zweistellige Zahl von 00 bis 59. Kann optional von einem . oder , und einer bis neun Ziffern gefolgt werden. Standard ist 00. Die Komponenten HH, mm und ss können durch : oder nichts getrennt sein. Sie können entweder nur ss oder sowohl ss als auch mm weglassen, sodass die Uhrzeit eine der drei Formen haben 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 der allgemein unterstützten Kalendertypen. Standard ist [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 im Allgemeinen darauf hin, dass es nicht ignoriert werden kann, wenn sie es nicht unterstützen. Der Temporal-Parser wird einen Fehler ausgeben, 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 können Sie optional den Versatz und die Zeitzonenkennung im gleichen Format wie ZonedDateTime einschließen, aber sie werden ignoriert. Beachten Sie, dass der Versatz nicht Z sein darf. Andere Anmerkungen im Format [key=value] werden ebenfalls ignoriert und dürfen nicht das kritische Flag haben.

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

Konstruktor

Temporal.PlainDateTime() Experimentell

Erstellt ein neues Temporal.PlainDateTime-Objekt durch direkte Angabe der zugrunde liegenden Daten.

Statische Methoden

Temporal.PlainDateTime.compare() Experimentell

Gibt eine Zahl (-1, 0 oder 1) zurück, die angibt, ob die erste Datum-Uhrzeit vor, gleich oder nach der zweiten Datum-Uhrzeit ist. Entspricht zuerst dem Vergleich ihrer Daten und dann dem Vergleich ihrer Uhrzeiten, wenn die Daten gleich sind.

Temporal.PlainDateTime.from() Experimentell

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

Instanzeigenschaften

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

Temporal.PlainDateTime.prototype.calendarId Experimentell

Gibt einen String zurück, der den Kalender repräsentiert, der verwendet wird, um das interne ISO 8601-Datum zu interpretieren.

Temporal.PlainDateTime.prototype.constructor

Die Konstrukturfunktion, die das Instanzobjekt erstellt hat. Bei Temporal.PlainDateTime-Instanzen ist der Anfangswert der Temporal.PlainDateTime()-Konstruktor.

Temporal.PlainDateTime.prototype.day Experimentell

Gibt eine positive Ganzzahl zurück, die den 1-basierten Tagindex im Monat dieses Datums darstellt, was derselbe Tag ist, den Sie im Kalender sehen würden. Kalender-abhängig. Beginnt in der Regel bei 1 und ist fortlaufend, aber nicht immer.

Temporal.PlainDateTime.prototype.dayOfWeek Experimentell

Gibt eine positive Ganzzahl zurück, die den 1-basierten Tagindex in der Woche dieses Datums darstellt. Tage in einer Woche sind fortlaufend von 1 bis daysInWeek nummeriert, wobei jede Zahl ihrem Namen zugeordnet ist. Kalender-abhängig. 1 repräsentiert normalerweise Montag im Kalender, auch wenn Kalender, die das Kalendersystem verwenden, möglicherweise einen anderen Tag als den ersten Tag der Woche betrachten (siehe Intl.Locale.prototype.getWeekInfo()).

Temporal.PlainDateTime.prototype.dayOfYear Experimentell

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

Temporal.PlainDateTime.prototype.daysInMonth Experimentell

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

Temporal.PlainDateTime.prototype.daysInWeek Experimentell

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

Temporal.PlainDateTime.prototype.daysInYear Experimentell

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

Temporal.PlainDateTime.prototype.era Experimentell

Gibt einen kalender-spezifischen 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 zusammen identifizieren ein Jahr in einem Kalender eindeutig, auf die gleiche Weise, wie es year tut. Kalender-abhängig. Für Gregorianisch ist es entweder "gregory" oder "gregory-inverse".

Temporal.PlainDateTime.prototype.eraYear Experimentell

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

Temporal.PlainDateTime.prototype.hour Experimentell

Gibt eine Ganzzahl von 0 bis 23 zurück, die die Stundenkomponente dieser Uhrzeit darstellt.

Temporal.PlainDateTime.prototype.inLeapYear Experimentell

Gibt einen Booleschen Wert zurück, der anzeigt, ob dieses Datum in einem Schaltjahr liegt. Ein Schaltjahr ist ein Jahr, das mehr Tage (aufgrund eines Schaltjahrestags oder Schaltmonats) als ein gemeinsames Jahr hat. Kalender-abhängig.

Temporal.PlainDateTime.prototype.microsecond Experimentell

Gibt eine Ganzzahl von 0 bis 999 zurück, die die Mikrosekunde (10^-6 Sekunde) Komponente dieser Uhrzeit darstellt.

Temporal.PlainDateTime.prototype.millisecond Experimentell

Gibt eine Ganzzahl von 0 bis 999 zurück, die die Millisekunde (10^-3 Sekunde) Komponente dieser Uhrzeit darstellt.

Temporal.PlainDateTime.prototype.minute Experimentell

Gibt eine Ganzzahl von 0 bis 59 zurück, die die Minutenkomponente dieser Uhrzeit darstellt.

Temporal.PlainDateTime.prototype.month Experimentell

Gibt eine positive Ganzzahl zurück, die den 1-basierten Monatsindex im Jahr dieses Datums darstellt. 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 auf 1 basiert. Wenn der Kalender Schaltmonate hat, dann können die Monate mit dem gleichen monthCode in verschiedenen Jahren unterschiedliche month-Indexe haben.

Temporal.PlainDateTime.prototype.monthCode Experimentell

Gibt einen kalender-spezifischen String zurück, der den Monat dieses Datums repräsentiert. Kalender-abhängig. Normalerweise ist es M plus eine zweistellige Monatsnummer. Bei Schaltmonaten ist es der vorherige Monatscode, gefolgt von L. Wenn der Schaltmonat der erste Monat des Jahres ist, ist der Code M00L.

Temporal.PlainDateTime.prototype.monthsInYear Experimentell

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

Temporal.PlainDateTime.prototype.nanosecond Experimentell

Gibt eine Ganzzahl von 0 bis 999 zurück, die die Nanosekunde (10^-9 Sekunde) Komponente dieser Uhrzeit darstellt.

Temporal.PlainDateTime.prototype.second Experimentell

Gibt eine Ganzzahl von 0 bis 59 zurück, die die Sekundenkomponente dieser Uhrzeit darstellt.

Temporal.PlainDateTime.prototype.weekOfYear Experimentell

Gibt eine positive Ganzzahl zurück, die den 1-basierten Wochenindex im yearOfWeek dieses Datums darstellt, oder undefined, wenn der Kalender kein wohldefiniertes Wochensystem hat. Die erste Woche des Jahres ist 1. Kalender-abhängig. Beachten Sie, dass für ISO 8601 die ersten und letzten Tage des Jahres möglicherweise der letzten Woche des vorherigen Jahres oder der ersten Woche des nächsten Jahres zugeordnet werden.

Temporal.PlainDateTime.prototype.year Experimentell

Gibt eine Ganzzahl zurück, die die Anzahl der Jahre dieses Datums relativ zum Beginn eines kalender-spezifischen Epoche-Jahres darstellt. Kalender-abhängig. Normalerweise ist Jahr 1 entweder das erste Jahr der neuesten Ära oder das ISO 8601-Jahr 0001. Wenn die Epoche in der Mitte des Jahres liegt, hat dieses Jahr vor und nach dem Startdatum der Ära denselben Wert.

Temporal.PlainDateTime.prototype.yearOfWeek Experimentell

Gibt eine Ganzzahl zurück, die das Jahr darstellt, das mit der weekOfYear dieses Datums gepaart werden soll, oder undefined, wenn der Kalender kein wohldefiniertes 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 vorherigen Jahres oder der ersten Woche des nächsten Jahres zugeordnet werden, was dazu führt, dass sich das 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.

Instanzmethoden

Temporal.PlainDateTime.prototype.add() Experimentell

Gibt ein neues Temporal.PlainDateTime-Objekt zurück, das dieses Datum-Uhrzeit um eine gegebene Dauer nach vorne verschoben darstellt (in einer Form, die durch Temporal.Duration.from() umwandelbar ist).

Temporal.PlainDateTime.prototype.equals() Experimentell

Gibt true zurück, wenn diese Datum-Uhrzeit in Bezug auf eine andere Datum-Uhrzeit gleichwertig ist (in einer Form, die durch Temporal.PlainDateTime.from() umwandelbar ist), andernfalls false. Sie werden sowohl nach ihren Daten- und Uhrzeitwerten als auch nach ihren Kalendern verglichen, sodass zwei Datum-Uhrzeiten aus verschiedenen Kalendern möglicherweise von Temporal.PlainDateTime.compare() als gleich angesehen werden, aber nicht von equals().

Temporal.PlainDateTime.prototype.round() Experimentell

Gibt ein neues Temporal.PlainDateTime-Objekt zurück, das dieses Datum-Uhrzeit auf die angegebene Einheit gerundet darstellt.

Temporal.PlainDateTime.prototype.since() Experimentell

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

Temporal.PlainDateTime.prototype.subtract() Experimentell

Gibt ein neues Temporal.PlainDateTime-Objekt zurück, das dieses Datum-Uhrzeit um eine gegebene Dauer rückwärts verschoben darstellt (in einer Form, die durch Temporal.Duration.from() umwandelbar ist).

Temporal.PlainDateTime.prototype.toJSON() Experimentell

Gibt einen String zurück, der diese Datum-Uhrzeit im gleichen RFC 9557 Format darstellt wie der Aufruf von toString(). Soll implizit durch JSON.stringify() aufgerufen werden.

Temporal.PlainDateTime.prototype.toLocaleString() Experimentell

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

Temporal.PlainDateTime.prototype.toPlainDate() Experimentell

Gibt ein neues Temporal.PlainDate-Objekt zurück, das den Datumsanteil (Jahr, Monat, Tag) dieser Datum-Uhrzeit im selben Kalendersystem darstellt.

Temporal.PlainDateTime.prototype.toPlainTime() Experimentell

Gibt ein neues Temporal.PlainTime-Objekt zurück, das den Uhrzeitsanteil (Stunde, Minute, Sekunde und Untersekundenkomponenten) dieser Datum-Uhrzeit darstellt.

Temporal.PlainDateTime.prototype.toString() Experimentell

Gibt einen String zurück, der dieses Datum-Uhrzeit im RFC 9557 Format darstellt.

Temporal.PlainDateTime.prototype.toZonedDateTime() Experimentell

Gibt eine neue Temporal.ZonedDateTime-Instanz zurück, die dieselbe Datum-Uhrzeit wie dieses einfache Datum-Uhrzeit, aber in der angegebenen Zeitzone darstellt.

Temporal.PlainDateTime.prototype.until() Experimentell

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

Temporal.PlainDateTime.prototype.valueOf() Experimentell

Wirft einen TypeError, der verhindert, dass Temporal.PlainDateTime-Instanzen implizit in primitive Werte konvertiert werden, wenn sie in arithmetischen oder Vergleichsoperationen verwendet werden.

Temporal.PlainDateTime.prototype.with() Experimentell

Gibt ein neues Temporal.PlainDateTime-Objekt zurück, das diese Datum-Uhrzeit mit einigen durch neue Werte ersetzten Feldern darstellt.

Temporal.PlainDateTime.prototype.withCalendar() Experimentell

Gibt ein neues Temporal.PlainDateTime-Objekt zurück, das diese Datum-Uhrzeit im neuen Kalendersystem interpretiert darstellt.

Temporal.PlainDateTime.prototype.withPlainTime() Experimentell

Gibt ein neues Temporal.PlainDateTime-Objekt zurück, das diese Datum-Uhrzeit mit dem Uhrzeitsanteil vollständig durch die neue Uhrzeit ersetzt darstellt (in einer Form, die durch Temporal.PlainTime.from() umwandelbar ist).

Spezifikationen

Browser-Kompatibilität

Siehe auch

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