Difference
これは、指定された単位で 2 つの日付の差を計算します。
ミリ秒単位で差を取得するには、dayjs#diff
を使用します。
js
const date1 = dayjs('2019-01-25');
const date2 = dayjs('2018-06-05');
date1.diff(date2); // 20214000000 (ミリ秒)
別の単位で差分を取得するには、第 2 引数に単位を指定します。
js
const date1 = dayjs('2019-01-25');
date1.diff('2018-06-05', 'month'); // 7
デフォルトでは、dayjs#diff
は計算結果を切り捨て、整数値を返します。浮動小数点数が必要な場合は、第 3 引数に true
を渡します。
js
const date1 = dayjs('2019-01-25');
date1.diff('2018-06-05', 'month', true); // 7.645161290322581
List of all available units
単位は大文字と小文字を区別しません。複数形と短縮形が使用できます。ただし、短縮形は大文字と小文字を区別します。
Unit | Shorthand | Description |
---|---|---|
day | d | 日 |
week | w | 週 |
quarter | Q | 四半期 |
month | M | 月 |
year | y | 年 |
hour | h | 時 |
minute | m | 分 |
second | s | 秒 |
millisecond | ms | ミリ秒 |