Temporal.PlainDateTime

Beschreibung

Ein PlainDateTime ist im Wesentlichen die Kombination aus einem Temporal.PlainDate und einer Temporal.PlainTime. Da die Datums- und Zeitinformationen kaum miteinander interagieren, werden alle allgemeinen Informationen über Datumseigenschaften im PlainDate-Objekt und alle allgemeinen Informationen über Zeiteigenschaften im PlainTime-Objekt dokumentiert.

Wenn das Datum mit Uhrzeit einen bestimmten Zeitpunkt darstellt, der über Zeitzonen hinweg unverändert bleiben soll, sollten Sie stattdessen das Temporal.ZonedDateTime-Objekt verwenden. Verwenden Sie PlainDateTime, wenn Sie ein Ereignis darstellen müssen, das zu einer bestimmten Wandzeit stattfindet und in verschiedenen Zeitzonen unterschiedliche Zeitpunkte sein kann.

RFC-9557-Format

PlainDateTime-Objekte können mithilfe des RFC-9557-Formats serialisiert und geparst werden, einer Erweiterung des Formats ISO 8601 / RFC 3339. Die Zeichenfolge hat folgende Form (Leerzeichen dienen nur der Lesbarkeit und sollten in der tatsächlichen Zeichenfolge nicht enthalten 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 --Vorzeichen.

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 - getrennt werden oder ohne Trennzeichen stehen.

T Optional

Das Datum-Uhrzeit-Trennzeichen, das T, t oder ein Leerzeichen sein kann. Ist genau dann vorhanden, wenn HH vorhanden ist.

HH Optional

Eine zweistellige Zahl von 00 bis 23. Der Standardwert ist 00.

mm Optional

Eine zweistellige Zahl von 00 bis 59. Der Standardwert ist 00.

ss.sssssssss Optional

Eine zweistellige Zahl von 00 bis 59. Optional kann darauf ein . oder , und eine bis neun Ziffern folgen. Der Standardwert ist 00. Die Komponenten HH, mm und ss können durch : getrennt werden oder ohne Trennzeichen stehen. Sie können entweder nur ss oder sowohl ss als auch mm auslassen, sodass die Uhrzeit eine von 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. Eine Liste häufig unterstützter Kalendertypen finden Sie unter Intl.supportedValuesOf(). Der Standardwert ist [u-ca=iso8601]. Kann ein kritisches Flag haben, indem dem Schlüssel ein ! vorangestellt wird: beispielsweise [!u-ca=iso8601]. Dieses Flag teilt anderen Systemen im Allgemeinen mit, dass es nicht ignoriert werden kann, wenn sie es nicht unterstützen. Der Temporal-Parser löst einen Fehler aus, wenn die Annotationen zwei oder mehr Kalenderannotation enthalten und eine davon kritisch ist. Beachten Sie, dass YYYY-MM-DD immer als Kalenderdatum nach ISO 8601 interpretiert und anschließend in den angegebenen Kalender konvertiert wird.

Als Eingabe können Sie optional den Offset und den Zeitzonenbezeichner im selben Format wie bei ZonedDateTime einschließen, sie werden jedoch ignoriert. Beachten Sie, dass der Offset nicht Z sein darf. Andere Annotationen im Format [key=value] werden ebenfalls ignoriert und dürfen kein kritisches Flag haben.

Beim Serialisieren können Sie die Ziffern für Sekundenbruchteile, die Anzeige der Kalender-ID sowie das Hinzufügen eines kritischen Flags dafür konfigurieren.

Konstruktor

Temporal.PlainDateTime()

Erstellt ein neues Temporal.PlainDateTime-Objekt durch direktes Bereitstellen der zugrunde liegenden Daten.

Statische Methoden

Temporal.PlainDateTime.compare()

Gibt eine Zahl (-1, 0 oder 1) zurück, die angibt, ob das erste Datum mit Uhrzeit vor dem zweiten liegt, mit ihm identisch ist oder nach ihm liegt. Entspricht dem zunächst erfolgenden Vergleich ihrer Daten und, falls die Daten gleich sind, dem Vergleich ihrer Uhrzeiten.

Temporal.PlainDateTime.from()

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

Instanzeigenschaften

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

Temporal.PlainDateTime.prototype.calendarId

Gibt eine Zeichenfolge zurück, die den Kalender darstellt, 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 Konstruktor Temporal.PlainDateTime().

Temporal.PlainDateTime.prototype.day

Gibt eine positive Ganzzahl zurück, die den bei 1 beginnenden Tagesindex im Monat dieses Datums darstellt; dies ist dieselbe Tagesnummer, die Sie in einem Kalender sehen würden. Abhängig vom Kalender. Beginnt im Allgemeinen bei 1 und ist fortlaufend, aber nicht immer.

Temporal.PlainDateTime.prototype.dayOfWeek

Gibt eine positive Ganzzahl zurück, die den bei 1 beginnenden Tagesindex in der Woche dieses Datums darstellt. Tage in einer Woche werden fortlaufend von 1 bis daysInWeek nummeriert, wobei jede Zahl ihrem Namen entspricht. Abhängig vom Kalender. 1 steht im Kalender üblicherweise für Montag, selbst wenn Gebietsschemata, die den Kalender verwenden, einen anderen Tag als ersten Tag der Woche ansehen (siehe Intl.Locale.prototype.getWeekInfo()).

Temporal.PlainDateTime.prototype.dayOfYear

Gibt eine positive Ganzzahl zurück, die den bei 1 beginnenden Tagesindex im Jahr dieses Datums darstellt. Der erste Tag dieses Jahres ist 1, und der letzte Tag ist daysInYear. Abhängig vom Kalender.

Temporal.PlainDateTime.prototype.daysInMonth

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

Temporal.PlainDateTime.prototype.daysInWeek

Gibt eine positive Ganzzahl zurück, die die Anzahl der Tage in der Woche dieses Datums darstellt. Abhängig vom Kalender. Für den ISO-8601-Kalender ist dies immer 7, in anderen Kalendersystemen kann es jedoch 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 darstellt. Abhängig vom Kalender. Für den ISO-8601-Kalender beträgt diese Zahl 365 beziehungsweise 366 in einem Schaltjahr.

Temporal.PlainDateTime.prototype.era

Gibt eine kalenderspezifische Zeichenfolge in Kleinbuchstaben zurück, die die Ära dieses Datums darstellt, oder undefined, wenn der Kalender keine Ären verwendet (z. B. ISO 8601). era und eraYear identifizieren gemeinsam ein Jahr in einem Kalender eindeutig, auf dieselbe Weise wie year. Abhängig vom Kalender. Für den gregorianischen Kalender lautet sie entweder "ce" oder "bce".

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 Ären verwendet (z. B. ISO 8601). Der Jahresindex beginnt üblicherweise bei 1 (häufiger) oder 0, und Jahre in einer Ära können mit der Zeit abnehmen (z. B. Gregorian BCE). era und eraYear identifizieren gemeinsam ein Jahr in einem Kalender eindeutig, auf dieselbe Weise wie year. Abhängig vom Kalender.

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 booleschen Wert zurück, der angibt, ob dieses Datum in einem Schaltjahr liegt. Ein Schaltjahr ist ein Jahr, das aufgrund eines Schalttags oder Schaltmonats mehr Tage als ein gewöhnliches Jahr hat. Abhängig vom Kalender.

Temporal.PlainDateTime.prototype.microsecond

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

Temporal.PlainDateTime.prototype.millisecond

Gibt eine Ganzzahl von 0 bis 999 zurück, die die Millisekundenkomponente (10^-3 Sekunden) 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 bei 1 beginnenden Monatsindex im Jahr dieses Datums darstellt. Der erste Monat dieses Jahres ist 1, und der letzte Monat ist monthsInYear. Abhängig vom Kalender. Beachten Sie, dass der Index im Gegensatz zu Date.prototype.getMonth() bei 1 beginnt. Wenn der Kalender Schaltmonate hat, kann der Monat mit demselben monthCode für verschiedene Jahre unterschiedliche month-Indizes haben.

Temporal.PlainDateTime.prototype.monthCode

Gibt eine kalenderspezifische Zeichenfolge zurück, die den Monat dieses Datums darstellt. Abhängig vom Kalender. Üblicherweise besteht sie aus M plus einer zweistelligen Monatsnummer. Für Schaltmonate ist es der Code des vorherigen Monats, gefolgt von L. Wenn der Schaltmonat der erste Monat des Jahres ist, lautet der Code M00L.

Temporal.PlainDateTime.prototype.monthsInYear

Gibt eine positive Ganzzahl zurück, die die Anzahl der Monate im Jahr dieses Datums darstellt. Abhängig vom Kalender. Für den ISO-8601-Kalender ist dies immer 12, in anderen Kalendersystemen kann es jedoch unterschiedlich sein.

Temporal.PlainDateTime.prototype.nanosecond

Gibt eine Ganzzahl von 0 bis 999 zurück, die die Nanosekundenkomponente (10^-9 Sekunden) 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 bei 1 beginnenden Wochenindex im yearOfWeek dieses Datums darstellt, oder undefined, wenn der Kalender kein wohldefiniertes Wochensystem besitzt. Die erste Woche des Jahres ist 1. Abhängig vom Kalender. Beachten Sie, dass bei 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. Abhängig vom Kalender. Üblicherweise ist Jahr 1 entweder das erste Jahr der jüngsten Ä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

Gibt eine Ganzzahl zurück, die das Jahr darstellt, das mit weekOfYear dieses Datums kombiniert wird, oder undefined, wenn der Kalender kein wohldefiniertes Wochensystem besitzt. Abhängig vom Kalender. Üblicherweise ist dies das Jahr des Datums, aber bei 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, wodurch sich yearOfWeek um 1 unterscheiden kann.

Temporal.PlainDateTime.prototype[Symbol.toStringTag]

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

Instanzmethoden

Temporal.PlainDateTime.prototype.add()

Gibt ein neues Temporal.PlainDateTime-Objekt zurück, das dieses Datum mit Uhrzeit darstellt, nachdem es um eine bestimmte Dauer nach vorne verschoben wurde (in einer durch Temporal.Duration.from() konvertierbaren Form).

Temporal.PlainDateTime.prototype.equals()

Gibt true zurück, wenn dieses Datum mit Uhrzeit wertmäßig einem anderen Datum mit Uhrzeit entspricht (in einer durch Temporal.PlainDateTime.from() konvertierbaren Form), andernfalls false. Sowohl ihre Datums- und Zeitwerte als auch ihre Kalender werden verglichen. Daher können zwei Datum-Uhrzeit-Werte aus unterschiedlichen Kalendern von Temporal.PlainDateTime.compare() als gleich angesehen werden, aber nicht von equals().

Temporal.PlainDateTime.prototype.round()

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

Temporal.PlainDateTime.prototype.since()

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

Temporal.PlainDateTime.prototype.subtract()

Gibt ein neues Temporal.PlainDateTime-Objekt zurück, das dieses Datum mit Uhrzeit darstellt, nachdem es um eine bestimmte Dauer nach hinten verschoben wurde (in einer durch Temporal.Duration.from() konvertierbaren Form).

Temporal.PlainDateTime.prototype.toJSON()

Gibt eine Zeichenfolge zurück, die dieses Datum mit Uhrzeit im selben RFC-9557-Format wie ein Aufruf von toString() darstellt. Soll implizit von JSON.stringify() aufgerufen werden.

Temporal.PlainDateTime.prototype.toLocaleString()

Gibt eine Zeichenfolge mit einer sprachabhängigen Darstellung dieses Datums mit Uhrzeit zurück.

Temporal.PlainDateTime.prototype.toPlainDate()

Gibt ein neues Temporal.PlainDate-Objekt zurück, das den Datumsteil (Jahr, Monat, Tag) dieses Datums mit Uhrzeit im selben Kalendersystem darstellt.

Temporal.PlainDateTime.prototype.toPlainTime()

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

Temporal.PlainDateTime.prototype.toString()

Gibt eine Zeichenfolge zurück, die dieses Datum mit Uhrzeit im RFC-9557-Format darstellt.

Temporal.PlainDateTime.prototype.toZonedDateTime()

Gibt eine neue Temporal.ZonedDateTime-Instanz zurück, die dasselbe Datum mit Uhrzeit wie dieses einfache Datum mit 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 mit Uhrzeit bis zu einem anderen Datum mit Uhrzeit darstellt (in einer durch Temporal.PlainDateTime.from() konvertierbaren Form). Die Dauer ist positiv, wenn das andere Datum mit Uhrzeit nach diesem Datum mit Uhrzeit liegt, und negativ, wenn es davor liegt.

Temporal.PlainDateTime.prototype.valueOf()

Löst einen TypeError aus, wodurch verhindert wird, dass Temporal.PlainDateTime-Instanzen bei der Verwendung in arithmetischen Operationen oder Vergleichsoperationen implizit in primitive Werte konvertiert werden.

Temporal.PlainDateTime.prototype.with()

Gibt ein neues Temporal.PlainDateTime-Objekt zurück, das dieses Datum mit Uhrzeit darstellt, wobei einige Felder durch neue Werte ersetzt wurden.

Temporal.PlainDateTime.prototype.withCalendar()

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

Temporal.PlainDateTime.prototype.withPlainTime()

Gibt ein neues Temporal.PlainDateTime-Objekt zurück, das dieses Datum mit Uhrzeit darstellt, wobei der Zeitteil vollständig durch die neue Uhrzeit ersetzt wurde (in einer durch Temporal.PlainTime.from() konvertierbaren Form).

Spezifikationen

Browser-Kompatibilität

Siehe auch

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