差異
此方法用於計算兩個日期時間之間的差值,並以指定的單位返回結果。
若要取得以毫秒為單位的差值,請使用 dayjs#diff
。
js
const date1 = dayjs('2019-01-25');
const date2 = dayjs('2018-06-05');
date1.diff(date2); // 20214000000 預設為毫秒
若要取得以其他單位表示的差值,請將單位作為第二個參數傳遞。
js
const date1 = dayjs('2019-01-25');
date1.diff('2018-06-05', 'month'); // 7
預設情況下,dayjs#diff
會將結果截斷為整數,捨棄小數部分。 如果需要浮點數結果,請將 true
作為第三個參數傳入。
js
const date1 = dayjs('2019-01-25');
date1.diff('2018-06-05', 'month', true); // 7.645161290322581
所有可用單位
單位不區分大小寫,支援複數形式和簡寫形式。 請注意,簡寫形式區分大小寫。
單位 | 簡寫 | 描述 |
---|---|---|
day | d | 天 |
week | w | 週 |
quarter | Q | 季度 |
month | M | 月 |
year | y | 年 |
hour | h | 小時 |
minute | m | 分鐘 |
second | s | 秒 |
millisecond | ms | 毫秒 |