Limited availability
Experimentell: Dies ist eine experimentelle Technologie
Ãberprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Das Temporal.PlainDateTime
-Objekt repräsentiert ein Datum (Kalenderdatum) und eine Uhrzeit (Uhrzeit) ohne Zeitzone. Es wird grundsätzlich als Kombination aus einem Datum (mit einem zugehörigen Kalendersystem) und einer Uhrzeit dargestellt.
Ein PlainDateTime
ist im Wesentlichen die Kombination aus einem Temporal.PlainDate
und einem Temporal.PlainTime
. Da die Datum- und Zeitinformationen kaum interagieren, sind alle allgemeinen Informationen zu Datumseigenschaften im PlainDate
-Objekt dokumentiert, und alle allgemeinen Informationen zu Zeiteigenschaften sind im PlainTime
-Objekt dokumentiert.
Wenn das Datum-Zeit einen bestimmten Zeitpunkt darstellt, der über Zeitzonen hinweg unveränderlich bleiben sollte, 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 einen anderen Zeitpunkt haben kann.
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 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 sein.
T
Optional
Der Datum-Zeit-Separator, der T
, t
oder ein Leerzeichen sein kann. Vorhanden, wenn und nur wenn HH
vorhanden ist.
HH
Optional
Eine zweistellige Zahl von 00
bis 23
. Standardwert ist 00
.
mm
Optional
Eine zweistellige Zahl von 00
bis 59
. Standardwert ist 00
.
ss.sssssssss
Optional
Eine zweistellige Zahl von 00
bis 59
. Kann optional von einem .
oder ,
und einer bis neun Ziffern gefolgt werden. Standardwert ist 00
. Die HH
, mm
und ss
Komponenten können durch :
oder nichts getrennt sein. Sie können entweder nur ss
oder sowohl ss
als auch mm
weglassen, sodass die Zeit in drei Formen vorliegen kann: HH
, HH:mm
oder HH:mm:ss.sssssssss
.
[u-ca=calendar_id]
Optional
Ersetzen Sie calendar_id
mit dem zu verwendenden Kalender. Siehe Intl.supportedValuesOf()
für eine Liste der häufig unterstützten Kalendertypen. Standardwert ist [u-ca=iso8601]
. Kann eine kritische Flagge haben, indem der Schlüssel mit !
vorangestellt wird: z. B. [!u-ca=iso8601]
. Diese Flagge sagt anderen Systemen im Allgemeinen, dass sie nicht ignoriert werden kann, wenn sie nicht unterstützt wird. Der Temporal
-Parser wird einen Fehler auslösen, wenn die Anmerkungen zwei oder mehr Kalenderanmerkungen enthalten und eine davon kritisch ist. Beachten Sie, dass YYYY-MM-DD
immer als ein ISO 8601-Kalenderdatum interpretiert und dann in den angegebenen Kalender konvertiert wird.
Als Eingabe können Sie optional den Offset und die Zeitzonenkennung im selben Format wie ZonedDateTime
einfügen, aber sie werden ignoriert. Beachten Sie, dass der Offset nicht Z
sein darf. Andere Anmerkungen im [key=value]
Format werden ebenfalls ignoriert, und sie dürfen nicht die kritische Flagge haben.
Bei der Serialisierung können Sie die Bruchteile von Sekunden, ob die Kalender-ID angezeigt wird, und ob eine kritische Flagge dafür gesetzt wird, konfigurieren.
KonstruktorTemporal.PlainDateTime()
Experimentell
Erstellt ein neues Temporal.PlainDateTime
-Objekt, indem die zugrunde liegenden Daten direkt bereitgestellt werden.
Temporal.PlainDateTime.compare()
Experimentell
Gibt eine Zahl (-1, 0 oder 1) zurück, die angibt, ob das erste Datum-Zeit vor dem zweiten Datum-Zeit liegt, mit ihm übereinstimmt oder nach ihm liegt. Entspricht zuerst dem Vergleich ihrer Daten und dann dem Vergleich ihrer Zeiten, wenn die Daten gleich sind.
Temporal.PlainDateTime.from()
Experimentell
Erstellt ein neues Temporal.PlainDateTime
-Objekt aus einem anderen Temporal.PlainDateTime
-Objekt, einem Objekt mit Datum- und Zeiteigenschaften oder einem RFC 9557-String.
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 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 anfängliche Wert der Temporal.PlainDateTime()
-Konstruktor.
Temporal.PlainDateTime.prototype.day
Experimentell
Gibt eine positive ganze Zahl zurück, die den 1-basierten Tagesindex im Monat dieses Datums darstellt, was der gleiche Tag ist, den Sie in einem Kalender sehen würden. Kalender-abhängig. Beginnt im Allgemeinen bei 1 und ist kontinuierlich, aber nicht immer.
Temporal.PlainDateTime.prototype.dayOfWeek
Experimentell
Gibt eine positive ganze Zahl zurück, die den 1-basierten Tagesindex in der Woche dieses Datums darstellt. Tage in einer Woche sind von 1
bis daysInWeek
nummeriert, wobei jede Nummer ihrem Namen zugeordnet ist. Kalender-abhängig. 1 repräsentiert normalerweise Montag im Kalender, auch wenn von dem Kalender verwendete Lokalisierungen möglicherweise einen anderen Tag als den ersten Wochentag betrachten (siehe Intl.Locale.prototype.getWeekInfo()
).
Temporal.PlainDateTime.prototype.dayOfYear
Experimentell
Gibt eine positive ganze Zahl 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
Experimentell
Gibt eine positive ganze Zahl zurück, die die Anzahl der Tage im Monat dieses Datums darstellt. Kalender-abhängig.
Temporal.PlainDateTime.prototype.daysInWeek
Experimentell
Gibt eine positive ganze Zahl 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 unterschiedlich sein.
Temporal.PlainDateTime.prototype.daysInYear
Experimentell
Gibt eine positive ganze Zahl 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 Kleinbuchstabenstring zurück, der die Epoche dieses Datums repräsentiert, oder undefined
, wenn der Kalender keine Epochen verwendet (z. B. ISO 8601). era
und eraYear
identifizieren zusammen 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 ganze Zahl zurück, die das Jahr dieses Datums innerhalb der Epoche darstellt, oder undefined
, wenn der Kalender keine Epochen verwendet (z. B. ISO 8601). Der Jahresindex beginnt normalerweise bei 1 (häufiger) oder 0, und die Jahre in einer Epoche 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 es year
tut. Kalender-abhängig.
Temporal.PlainDateTime.prototype.hour
Experimentell
Gibt eine ganze Zahl von 0 bis 23 zurück, die die Stundenkomponente dieser Uhrzeit darstellt.
Temporal.PlainDateTime.prototype.inLeapYear
Experimentell
Gibt einen booleschen Wert zurück, der angibt, ob dieses Datum in einem Schaltjahr liegt. Ein Schaltjahr ist ein Jahr, das mehr Tage hat (aufgrund eines Schalttags oder -monats) als ein normales Jahr. Kalender-abhängig.
Temporal.PlainDateTime.prototype.microsecond
Experimentell
Gibt eine ganze Zahl von 0 bis 999 zurück, die die Mikrosekunde (10-6 Sekunde) Komponente dieser Uhrzeit darstellt.
Temporal.PlainDateTime.prototype.millisecond
Experimentell
Gibt eine ganze Zahl von 0 bis 999 zurück, die die Millisekunde (10-3 Sekunde) Komponente dieser Uhrzeit darstellt.
Temporal.PlainDateTime.prototype.minute
Experimentell
Gibt eine ganze Zahl von 0 bis 59 zurück, die die Minutenkomponente dieser Uhrzeit darstellt.
Temporal.PlainDateTime.prototype.month
Experimentell
Gibt eine positive ganze Zahl 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 dem gleichen monthCode
unterschiedliche month
-Indizes für verschiedene Jahre haben.
Temporal.PlainDateTime.prototype.monthCode
Experimentell
Gibt einen kalender-spezifischen String zurück, der den Monat dieses Datums repräsentiert. Kalender-abhängig. In der Regel ist es M
plus eine zweistellige 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
Experimentell
Gibt eine positive ganze Zahl 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 unterschiedlich sein.
Temporal.PlainDateTime.prototype.nanosecond
Experimentell
Gibt eine ganze Zahl von 0 bis 999 zurück, die die Nanosekunde (10-9 Sekunde) Komponente dieser Uhrzeit darstellt.
Temporal.PlainDateTime.prototype.second
Experimentell
Gibt eine ganze Zahl von 0 bis 59 zurück, die die Sekundenkomponente dieser Uhrzeit darstellt.
Temporal.PlainDateTime.prototype.weekOfYear
Experimentell
Gibt eine positive ganze Zahl zurück, die den 1-basierten Wochenindex im yearOfWeek
dieses Datums darstellt, oder undefined
, wenn der Kalender kein gut 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 zugeschrieben werden können.
Temporal.PlainDateTime.prototype.year
Experimentell
Gibt eine Ganzzahl zurück, die die Anzahl der Jahre dieses Datums relativ zum Beginn eines kalender-spezifischen Epochjahres darstellt. Kalender-abhängig. In der Regel 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 denselben Wert vor und nach dem Startdatum der Ãra.
Temporal.PlainDateTime.prototype.yearOfWeek
Experimentell
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. In der Regel 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 zugeschrieben werden, wodurch sich yearOfWeek
um 1 unterscheidet.
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.
Temporal.PlainDateTime.prototype.add()
Experimentell
Gibt ein neues Temporal.PlainDateTime
-Objekt zurück, das dieses Datum-Zeit um eine gegebene Dauer (in einer Form, die durch Temporal.Duration.from()
umwandelbar ist) vorwärts bewegt.
Temporal.PlainDateTime.prototype.equals()
Experimentell
Gibt true
zurück, wenn dieses Datum-Zeit in Wert einem anderen Datum-Zeit (in einer Form, die durch Temporal.PlainDateTime.from()
umwandelbar ist) entspricht, und false
andernfalls. Sie werden sowohl nach ihren Datum- und Zeitwerten als auch nach ihren Kalendern verglichen, sodass zwei Datum-Zeiten aus verschiedenen Kalendern von Temporal.PlainDateTime.compare()
als gleich angesehen werden können, aber nicht von equals()
.
Temporal.PlainDateTime.prototype.round()
Experimentell
Gibt ein neues Temporal.PlainDateTime
-Objekt zurück, das dieses Datum-Zeit 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-Zeit (in einer Form, die durch Temporal.PlainDateTime.from()
umwandelbar ist) zu diesem Datum-Zeit darstellt. Die Dauer ist positiv, wenn das andere Datum-Zeit vor diesem Datum-Zeit liegt, und negativ, wenn danach.
Temporal.PlainDateTime.prototype.subtract()
Experimentell
Gibt ein neues Temporal.PlainDateTime
-Objekt zurück, das dieses Datum-Zeit um eine gegebene Dauer (in einer Form, die durch Temporal.Duration.from()
umwandelbar ist) rückwärts bewegt.
Temporal.PlainDateTime.prototype.toJSON()
Experimentell
Gibt einen String zurück, der dieses Datum-Zeit im gleichen RFC 9557-Format wie der Aufruf von toString()
darstellt. Soll implizit von JSON.stringify()
aufgerufen werden.
Temporal.PlainDateTime.prototype.toLocaleString()
Experimentell
Gibt einen String mit einer sprachlich sensiblen Darstellung dieses Datum-Zeit zurück.
Temporal.PlainDateTime.prototype.toPlainDate()
Experimentell
Gibt ein neues Temporal.PlainDate
-Objekt zurück, das den Datenteil (Jahr, Monat, Tag) dieses Datum-Zeit im gleichen Kalendersystem darstellt.
Temporal.PlainDateTime.prototype.toPlainTime()
Experimentell
Gibt ein neues Temporal.PlainTime
-Objekt zurück, das den Zeitteil (Stunde, Minute, Sekunde und Untersekundenkomponenten) dieses Datum-Zeit darstellt.
Temporal.PlainDateTime.prototype.toString()
Experimentell
Gibt einen String zurück, der dieses Datum-Zeit im RFC 9557-Format darstellt.
Temporal.PlainDateTime.prototype.toZonedDateTime()
Experimentell
Gibt eine neue Temporal.ZonedDateTime
-Instanz zurück, die dasselbe Datum-Zeit wie dieses einfache Datum-Zeit, aber in der angegebenen Zeitzone darstellt.
Temporal.PlainDateTime.prototype.until()
Experimentell
Gibt ein neues Temporal.Duration
-Objekt zurück, das die Dauer von diesem Datum-Zeit bis zu einem anderen Datum-Zeit (in einer Form, die durch Temporal.PlainDateTime.from()
umwandelbar ist) darstellt. Die Dauer ist positiv, wenn das andere Datum-Zeit nach diesem Datum-Zeit 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 dieses Datum-Zeit mit einigen durch neue Werte ersetzten Feldern darstellt.
Temporal.PlainDateTime.prototype.withCalendar()
Experimentell
Gibt ein neues Temporal.PlainDateTime
-Objekt zurück, das dieses Datum-Zeit im neuen Kalendersystem interpretiert darstellt.
Temporal.PlainDateTime.prototype.withPlainTime()
Experimentell
Gibt ein neues Temporal.PlainDateTime
-Objekt zurück, das dieses Datum-Zeit mit dem vollständig durch die neue Zeit ersetzten Zeitteil darstellt (in einer Form, die durch Temporal.PlainTime.from()
umwandelbar ist).
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4