Temporal.PlainDateTime

Beschreibung

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

Falls das Datum-Uhrzeit einen spezifischen Zeitpunkt repräsentiert, der über Zeitzonen hinweg unveränderlich bleiben soll, sollten Sie das Temporal.ZonedDateTime Objekt verwenden. Nutzen Sie PlainDateTime, wenn Sie ein Ereignis repräsentieren müssen, das zu einer bestimmten Uhrzeit stattfindet, aber in verschiedenen Zeitzonen ein anderer Zeitpunkt sein kann.

RFC 9557 Format

PlainDateTime 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 (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 mit - oder ohne Trennzeichen getrennt werden.

T Optional

Der Datum-Uhrzeit-Separator, 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 von einem . oder , und einer bis neun Ziffern sein. Standardmäßig 00. Die HH, mm, und ss Komponenten können mit : oder ohne Trennzeichen getrennt werden. Sie können entweder nur ss oder sowohl ss als auch mm weglassen, sodass die Uhrzeit in einer von 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 der häufig unterstützten 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 allgemein andere Systeme darauf hin, dass es nicht ignoriert werden darf, wenn sie es nicht unterstützen. Der Temporal Parser wird einen Fehler werfen, 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 konvertiert wird.

Als Eingabe können Sie optional den Offset und die Zeitzone-Identifikator enthalten, im selben Format wie bei ZonedDateTime, aber sie werden ignoriert. Beachten Sie, dass der Offset nicht Z sein darf. Andere Anmerkungen im [key=value] Format werden ebenfalls ignoriert und dürfen das kritische Flag nicht haben.

Beim Serialisieren können Sie die Bruchteile von Sekunden, das Anzeigen der Kalender-ID und das Hinzufügen eines kritischen Flags dafür konfigurieren.

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 angibt, ob das erste Datum-Uhrzeit vor dem zweiten Datum-Uhrzeit liegt, das gleiche oder danach liegt. Entspricht zuerst dem Vergleich ihrer Daten, dann dem Vergleich ihrer Uhrzeiten, wenn die Daten gleich sind.

Temporal.PlainDateTime.from()

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

Instanz-Eigenschaften

Diese Eigenschaften sind auf Temporal.PlainDateTime.prototype definiert und werden von allen Temporal.PlainDateTime Instanzen 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 Konstruktionsfunktion, 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 darstellt, was der gleiche Tagesnummer ist, die Sie auf einem Kalender sehen würden. Kalender-abhängig. Beginnt im Allgemeinen bei 1 und ist kontinuierlich, aber nicht immer.

Temporal.PlainDateTime.prototype.dayOfWeek

Gibt eine positive Ganzzahl zurück, die den 1-basierten Tagesindex 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 typischerweise Montag im Kalender, auch wenn Lokale, die den Kalender verwenden, einen anderen Tag als ersten Wochentag betrachten könnten (siehe Intl.Locale.prototype.getWeekInfo()).

Temporal.PlainDateTime.prototype.dayOfYear

Gibt eine positive Ganzzahl zurück, die den 1-basierten Tagesindex 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

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

Temporal.PlainDateTime.prototype.daysInWeek

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 das immer 7, aber in anderen Kalendersystemen kann es von Woche zu Woche variieren.

Temporal.PlainDateTime.prototype.daysInYear

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 das 365, oder 366 in einem Schaltjahr.

Temporal.PlainDateTime.prototype.era

Gibt einen speziell für den Kalender festgelegten Kleinbuchstaben-String zurück, der die Ära dieses Datums darstellt, oder undefined, wenn der Kalender keine Äras verwendet (z.B. ISO 8601). era und eraYear identifizieren zusammen ein Jahr in einem Kalender eindeutig, ebenso wie year. Kalender-abhängig. Für den Gregorianischen Kalender ist es entweder "gregory" oder "gregory-inverse".

Temporal.PlainDateTime.prototype.eraYear

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

Temporal.PlainDateTime.prototype.hour

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

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 (aufgrund eines Schalttags oder Schaltmonats) als ein gewöhnliches Jahr hat. Kalender-abhängig.

Temporal.PlainDateTime.prototype.microsecond

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

Temporal.PlainDateTime.prototype.millisecond

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

Temporal.PlainDateTime.prototype.minute

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

Temporal.PlainDateTime.prototype.month

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 1-basiert ist. Wenn der Kalender Schaltmonate hat, dann kann der Monat mit demselben monthCode unterschiedliche month Indizes für verschiedene Jahre haben.

Temporal.PlainDateTime.prototype.monthCode

Gibt einen spezifisch für den Kalender festgelegten String zurück, der den Monat dieses Datums darstellt. Kalender-abhängig. Normalerweise ist es M plus einer zweistelligen Monatsnummer. Für Schaltmonate 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

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 differieren.

Temporal.PlainDateTime.prototype.nanosecond

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

Temporal.PlainDateTime.prototype.second

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

Temporal.PlainDateTime.prototype.weekOfYear

Gibt eine positive Ganzzahl zurück, die den 1-basierten Wochenindex im yearOfWeek dieses Datums darstellt, oder undefined, wenn der Kalender kein klar definiertes 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 der letzten Woche des vorherigen Jahres oder der ersten Woche des nächsten Jahres zugeordnet werden können.

Temporal.PlainDateTime.prototype.year

Gibt eine Ganzzahl zurück, die die Anzahl der Jahre dieses Datums relativ zum Beginn eines kalenderspezifischen Epochenjahres darstellt. Kalender-abhängig. Normalerweise ist das 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 den gleichen Wert vor und nach dem Startdatum der Ära.

Temporal.PlainDateTime.prototype.yearOfWeek

Gibt eine Ganzzahl zurück, die das Jahr darstellt, das mit der weekOfYear dieses Datums gepaart werden soll, oder undefined, wenn der Kalender kein klar definiertes Wochensystem hat. Kalender-abhängig. Normalerweise ist das 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 das yearOfWeek um 1 abweicht.

Temporal.PlainDateTime.prototype[Symbol.toStringTag]

Der anfängliche Wert 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 dieses Datum-Uhrzeit um eine gegebene Dauer (in einer Form, die durch Temporal.Duration.from() konvertierbar ist) nach vorne verschoben darstellt.

Temporal.PlainDateTime.prototype.equals()

Gibt true zurück, wenn dieses Datum-Uhrzeit einem anderen Datum-Uhrzeit gleichwertig ist (in einer Form, die durch Temporal.PlainDateTime.from() konvertierbar ist), und false andernfalls. Sie werden sowohl nach ihren Datum- und Uhrzeitwerten als auch ihren Kalendern verglichen, sodass zwei Datums-Uhrzeiten aus verschiedenen Kalendern von Temporal.PlainDateTime.compare() als gleich angesehen, aber nicht von equals() sein können.

Temporal.PlainDateTime.prototype.round()

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

Temporal.PlainDateTime.prototype.since()

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

Temporal.PlainDateTime.prototype.subtract()

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

Temporal.PlainDateTime.prototype.toJSON()

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

Temporal.PlainDateTime.prototype.toLocaleString()

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

Temporal.PlainDateTime.prototype.toPlainDate()

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

Temporal.PlainDateTime.prototype.toPlainTime()

Gibt ein neues Temporal.PlainTime Objekt zurück, das den Zeitanteil (Stunde, Minute, Sekunde und Teilsekundenkomponenten) dieses Datum-Uhrzeit darstellt.

Temporal.PlainDateTime.prototype.toString()

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

Temporal.PlainDateTime.prototype.toZonedDateTime()

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

Temporal.PlainDateTime.prototype.until()

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

Temporal.PlainDateTime.prototype.valueOf()

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

Temporal.PlainDateTime.prototype.with()

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

Temporal.PlainDateTime.prototype.withCalendar()

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

Temporal.PlainDateTime.prototype.withPlainTime()

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

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