Temporal.PlainTime.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.PlainTime instances returns true if this time is equivalent in value to another time (in a form convertible by Temporal.PlainTime.from()), and false otherwise. They are compared by their time values. It is equivalent to Temporal.PlainTime.compare(this, other) === 0.
Syntax
equals(other)
Parameters
other-
A string, an object, or a
Temporal.PlainTimeinstance representing the other time to compare. It is converted to aTemporal.PlainTimeobject using the same algorithm asTemporal.PlainTime.from().
Return value
true if this time is equal to other both in their time value and their calendar, false otherwise.
Examples
Using equals()
const time1 = Temporal.PlainTime.from("12:34:56");
const time2 = Temporal.PlainTime.from({ hour: 12, minute: 34, second: 56 });
console.log(time1.equals(time2)); // true
const time3 = Temporal.PlainTime.from("00:34:56");
console.log(time1.equals(time3)); // false
Specifications
| Specification |
|---|
| Temporal proposal # sec-temporal.plaintime.prototype.equals |
Browser compatibility
BCD tables only load in the browser