Temporal.ZonedDateTime.prototype.equals()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die equals() Methode von Temporal.ZonedDateTime Instanzen gibt true zurück, wenn diese Datum-Uhrzeit in Wert einer anderen Datum-Uhrzeit entspricht (in einer Form, die von Temporal.ZonedDateTime.from() konvertierbar ist), und false andernfalls. Sie werden sowohl anhand ihrer Instant-Werte, Zeitzonen als auch ihrer Kalender verglichen, sodass zwei Datum-Uhrzeiten aus unterschiedlichen Kalendern oder Zeitzonen möglicherweise von Temporal.ZonedDateTime.compare() als gleich betrachtet werden, jedoch nicht von equals().
Syntax
equals(other)
Parameter
other-
Ein String, ein Objekt oder eine
Temporal.ZonedDateTimeInstanz, die die andere Datum-Uhrzeit zum Vergleichen darstellt. Es wird mit dem gleichen Algorithmus wieTemporal.ZonedDateTime.from()in einTemporal.ZonedDateTimeObjekt umgewandelt.
Rückgabewert
true, wenn diese Datum-Uhrzeit sowohl im Instant-Wert, in der Zeitzone als auch im Kalender gleich other ist, andernfalls false.
Beachten Sie, dass die Zeitzonen vor dem Vergleich kanonisiert werden. Wenn ihre Zeitzonen-IDs sowohl benannt sind als auch die gleiche Zeitzone identifizieren, werden sie als gleich angesehen, selbst wenn die genauen Namen möglicherweise Aliase voneinander sind. Offset-Identifikatoren werden anhand der Offset-Werte verglichen, die sie repräsentieren. Offset-Identifikatoren sind niemals gleich benannten Identifikatoren, selbst wenn die benannte Zeitzone immer diesen Offset verwendet.
Beispiele
Verwendung von equals()
// Asia/Kolkata and Asia/Calcutta are aliases of each other
const dt1 = Temporal.ZonedDateTime.from(
"2021-07-01T12:34:56+05:30[Asia/Kolkata]",
);
const dt2 = Temporal.ZonedDateTime.from(
"2021-07-01T12:34:56+05:30[Asia/Calcutta]",
);
console.log(dt1.equals(dt2)); // true
const dt3 = Temporal.ZonedDateTime.from("2021-07-01T12:34:56+05:30[+05:30]");
console.log(dt1.equals(dt3)); // false
const dt4 = Temporal.ZonedDateTime.from(
"2021-07-01T12:34:56+05:30[Asia/Kolkata][u-ca=buddhist]",
);
console.log(dt1.equals(dt4)); // false
Testen, ob zwei Zeitzonen-Identifikatoren gleichwertig sind
function sameTimeZone(timeZone1, timeZone2) {
const dt1 = Temporal.ZonedDateTime.from({
year: 2021,
month: 7,
day: 1,
timeZone: timeZone1,
});
const dt2 = Temporal.ZonedDateTime.from({
year: 2021,
month: 7,
day: 1,
timeZone: timeZone2,
});
return dt1.equals(dt2);
}
console.log(sameTimeZone("Asia/Kolkata", "Asia/Calcutta")); // true
console.log(sameTimeZone("Asia/Shanghai", "Asia/Taipei")); // false
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.zoneddatetime.prototype.equals |