Temporal.PlainTime.prototype.equals()
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.
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.PlainTime instance representing the other time to compare. It is converted to a
Temporal.PlainTimeobject using the same algorithm as Temporal.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
Browser compatibility
See also
- Temporal.PlainTime
- Temporal.PlainTime.compare()