Temporal.PlainDateTime.prototype.equals()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The equals()
method of Temporal.PlainDateTime
instances returns true
if this date-time is equivalent in value to another date-time (in a form convertible by Temporal.PlainDateTime.from()
), and false
otherwise. They are compared both by their date and time values and their calendars, so two date-times from different calendars may be considered equal by Temporal.PlainDateTime.compare()
but not by equals()
.
Syntax
equals(other)
Parameters
other
-
A string, an object, or a
Temporal.PlainDateTime
instance representing the other date-time to compare. It is converted to aTemporal.PlainDateTime
object using the same algorithm asTemporal.PlainDateTime.from()
.
Return value
true
if this date-time is equal to other
both in their date/time value and their calendar, false
otherwise.
Examples
Using equals()
const dt1 = Temporal.PlainDateTime.from("2021-08-01");
const dt2 = Temporal.PlainDateTime.from({ year: 2021, month: 8, day: 1 });
console.log(dt1.equals(dt2)); // true
const dt3 = Temporal.PlainDateTime.from("2021-08-01[u-ca=japanese]");
console.log(dt1.equals(dt3)); // false
const dt4 = Temporal.PlainDateTime.from("2021-08-01T01:00:00");
console.log(dt1.equals(dt4)); // false
Specifications
Specification |
---|
Temporal proposal # sec-temporal.plaindatetime.prototype.equals |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
equals |
Legend
Tip: you can click/tap on a cell for more information.
- No support
- No support
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- User must explicitly enable this feature.