Temporal.Instant.compare()
靜態方法 Temporal.Instant.compare() 返回一個數字(-1、0 或 1),指示第一個瞬間是否早於、等於或晚於第二個瞬間。它等同於比較兩個瞬間的 epochNanoseconds。
語法
js
Temporal.Instant.compare(instant1, instant2)
引數
instant1-
一個字串或一個
Temporal.Instant例項,表示要比較的第一個瞬間。它使用與Temporal.Instant.from()相同的演算法轉換為Temporal.Instant物件。 instant2-
要比較的第二個瞬間,使用與
instant1相同的演算法轉換為Temporal.Instant物件。
返回值
如果 instant1 早於 instant2,則返回 -1;如果它們相等,則返回 0;如果 instant1 晚於 instant2,則返回 1。
示例
使用 Temporal.Instant.compare()
js
const instant1 = Temporal.Instant.from("2021-08-01T12:34:56Z");
const instant2 = Temporal.Instant.from("2021-08-01T12:34:56Z");
console.log(Temporal.Instant.compare(instant1, instant2)); // 0
const instant3 = Temporal.Instant.from("2021-08-01T13:34:56Z");
console.log(Temporal.Instant.compare(instant1, instant3)); // -1
對瞬間陣列進行排序
此 compare() 函式的目的是作為比較器,傳遞給 Array.prototype.sort() 和相關函式。
js
const instants = [
Temporal.Instant.from("2021-08-01T12:34:56Z"),
Temporal.Instant.from("2021-08-01T12:34:56+01:00"),
Temporal.Instant.from("2021-08-01T12:34:56-01:00"),
];
instants.sort(Temporal.Instant.compare);
console.log(instants.map((instant) => instant.toString()));
// [ '2021-08-01T11:34:56Z', '2021-08-01T12:34:56Z', '2021-08-01T13:34:56Z' ]
規範
| 規範 |
|---|
| Temporal # sec-temporal.instant.compare |
瀏覽器相容性
載入中…