Add
指定された時間を加算した新しい Day.js オブジェクトを返します。元の Day.js オブジェクトは変更されません。
js
const a = dayjs();
const b = a.add(7, 'day');
// a -> 元の値 (変更なし)
// b -> 操作結果
単位は、大文字・小文字を区別せず、複数形と短縮形に対応しています。ただし、短縮形は大文字・小文字が区別されます。
使用可能な単位一覧
単位 | 短縮形 | 説明 |
---|---|---|
day | d | 日 |
week | w | 週 |
month | M | 月 |
quarter | Q | 四半期(QuarterOfYear プラグインが必要) |
year | y | 年 |
hour | h | 時 |
minute | m | 分 |
second | s | 秒 |
millisecond | ms | ミリ秒 |
また、durations を使用して Day.js オブジェクトに加算することもできます。
js
result = dayjs().add(dayjs.duration({ days: 1 }));
days や weeks に小数値が渡された場合、加算前に最も近い整数に丸められます。