核心方法:Date.parse() + 毫秒換算
<input type="text" id="startDate" value="2024-01-01" />
<input type="text" id="endDate" value="2024-12-31" />
<button onclick="calcDays()">計算天數</button>
<script>
function calcDays() {
var start = $('#startDate').val();
var end = $('#endDate').val();
// Date.parse 解析字串為毫秒時間戳 (UTC)
var t1 = Date.parse(start);
var t2 = Date.parse(end);
if (isNaN(t1) || isNaN(t2)) {
alert('日期格式錯誤,請使用 YYYY-MM-DD');
return;
}
// 毫秒轉天數:1天 = 24*60*60*1000 = 86,400,000 ms
var diffDays = Math.floor((t2 - t1) / 86400000);
alert('相差 ' + diffDays + ' 天');
}
</script>
注意事項
- Date.parse 格式敏感:標準支援
YYYY-MM-DD、YYYY/MM/DD、MM/DD/YYYY。建議統一用 YYYY-MM-DD。
- 時區影響:
Date.parse 解析無時區字串視為 UTC。若輸入本地時間,跨時區可能差 1 天。嚴謹場景請用 new Date(year, month-1, day) 指定本地時間。
- 閏年/月份長短:毫秒換算法自動處理,無需手動計算每月天數。
進階:使用 Date 物件建構 (避免時區歧義)
function parseLocalDate(str) {
// str: "YYYY-MM-DD"
var parts = str.split('-');
return new Date(parts[0], parts[1] - 1, parts[2]); // 月份 0-based
}
function diffDaysLocal(startStr, endStr) {
var d1 = parseLocalDate(startStr);
var d2 = parseLocalDate(endStr);
// 歸零時間部分,避免夏令時間導致非整天
d1.setHours(0,0,0,0);
d2.setHours(0,0,0,0);
return Math.round((d2 - d1) / 86400000);
}
現代化:使用 Temporal API (提案階段) / date-fns / dayjs
// date-fns (推薦輕量)
import { differenceInDays, parseISO } from 'date-fns';
var days = differenceInDays(parseISO(end), parseISO(start));
// dayjs (API 類 moment.js 但僅 2KB)
import dayjs from 'dayjs';
var days = dayjs(end).diff(dayjs(start), 'day');
應用範例:倒數計時器
function countdown(targetDateStr) {
var target = parseLocalDate(targetDateStr);
target.setHours(23,59,59,999); // 當天結束
var timer = setInterval(function() {
var now = new Date();
var diff = target - now;
if (diff <= 0) {
clearInterval(timer);
$('#countdown').text('時間到!');
return;
}
var days = Math.floor(diff / 86400000);
var hours = Math.floor((diff % 86400000) / 3600000);
var mins = Math.floor((diff % 3600000) / 60000);
var secs = Math.floor((diff % 60000) / 1000);
$('#countdown').text(days + '天 ' + hours + '時 ' + mins + '分 ' + secs + '秒');
}, 1000);
}