JavaScript 無內建 AddDays 等方法,**統一轉換為毫秒時間戳進行加減**,再格式化輸出。
提供 dateFormat(date, mask, utc) 和 Date.prototype.format(mask),支持豐富掩碼:
yyyy-MM-dd HH:mm:ss、isoDateTime、shortDate 等預設格式。d, dd, ddd, dddd(日)、m, mm, mmm, mmmm(月)、h, HH, M, s, S, l, L, t, T, Z 等。dayNames、monthNames 可自定義中文「星期一」等。// 當前時間
var now = new Date();
// 加 7 天
var future = new Date(now.getTime() + 7 * 24 * 60 * 60 * 1000);
console.log(future.format("yyyy-MM-dd")); // 2024-01-22
// 減 30 分鐘
var past = new Date(now.getTime() - 30 * 60 * 1000);
console.log(past.format("HH:mm:ss")); // 14:00:45
// 加 1 年(近似)
var nextYear = new Date(now.getFullYear() + 1, now.getMonth(), now.getDate());
console.log(nextYear.format("yyyy年")); // 2025年
function dateAdd(date, amount, unit) {
// unit: 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second' | 'millisecond'
const d = new Date(date.getTime()); // 複製
switch (unit) {
case 'year': d.setFullYear(d.getFullYear() + amount); break;
case 'month': d.setMonth(d.getMonth() + amount); break;
case 'day': d.setDate(d.getDate() + amount); break;
case 'hour': d.setHours(d.getHours() + amount); break;
case 'minute': d.setMinutes(d.getMinutes() + amount); break;
case 'second': d.setSeconds(d.getSeconds() + amount); break;
case 'millisecond': d.setTime(d.getTime() + amount); break;
}
return d;
}
// 使用
const tomorrow = dateAdd(new Date(), 1, 'day');
const nextMonth = dateAdd(new Date(), 1, 'month');
console.log(tomorrow.format("yyyy-MM-dd"));
console.log(nextMonth.format("yyyy-MM-dd"));
優勢:自動處理月份天數差異(setDate(32) 自動進位下月)、閏年、夏令時等邊界情況。
// date-fns
import { addDays, addMonths, format } from 'date-fns';
format(addDays(new Date(), 7), 'yyyy-MM-dd');
format(addMonths(new Date(), 1), 'yyyy-MM-dd');
// dayjs (鏈式、不可變、兼容 moment API)
dayjs().add(7, 'day').format('YYYY-MM-DD');
dayjs().add(1, 'month').format('YYYY-MM-DD');
new Date(2024, 0, 31).setMonth(1) → 2024-03-02(2月無31日自動進位)。setHours 而非毫秒加減。getTime() 返回 UTC 毫秒,格式化時注意本地/UTC 模式。