萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 字串日期 'yyyy-MM-dd' 轉 Date 物件的跨瀏覽器最佳實踐

核心問題

Date.parse('2024-01-15') 在舊版 Safari/IE 中回傳 NaN,因 ECMAScript 5 前未強制規定 ISO 8601 格式解析。即使現代瀏覽器支援,時區處理也不一致 (當地時間 vs UTC)。

推薦方案:手動解析 (零依賴、零時區坑)

/**
 * 將 'YYYY-MM-DD' 或 'YYYY-MM-DD HH:mm:ss' 解析為當地時間 Date
 * @param {string} str - 日期字串
 * @returns {Date|null} 解析成功回傳 Date,格式錯誤回傳 null
 */
function parseLocalDate(str) {
    if (!str) return null;
    // 支援 '2024-01-15'、'2024-01-15 14:30:00'、'2024/01/15'
    var parts = str.split(/[-\s/:]/);
    if (parts.length < 3) return null;
    
    var year = parseInt(parts[0], 10);
    var month = parseInt(parts[1], 10) - 1; // JS 月份 0-based
    var day = parseInt(parts[2], 10);
    var hour = parseInt(parts[3] || '0', 10);
    var minute = parseInt(parts[4] || '0', 10);
    var second = parseInt(parts[5] || '0', 10);
    
    // 基本合法性檢查
    if (isNaN(year) || isNaN(month) || isNaN(day) || month < 0 || month > 11 || day < 1 || day > 31) return null;
    
    var date = new Date(year, month, day, hour, minute, second);
    // 驗證日期有效性 (如 2024-02-30 會自動轉成 3月1日)
    if (date.getFullYear() !== year || date.getMonth() !== month || date.getDate() !== day) return null;
    
    return date;
}

// 測試
console.log(parseLocalDate('2024-01-15'));           // Mon Jan 15 2024 00:00:00 GMT+0800
console.log(parseLocalDate('2024-01-15 14:30:00'));  // Mon Jan 15 2024 14:30:00 GMT+0800
console.log(parseLocalDate('2024/01/15'));           // 同支援
console.log(parseLocalDate('invalid'));              // null

替代方案:new Date('YYYY/MM/DD') 字串替換

function parseDateReplace(str) {
    if (!str) return null;
    // 將 - 替換為 /,瀏覽器統一支援 'YYYY/MM/DD' 視為當地時間
    var normalized = str.replace(/-/g, '/');
    var date = new Date(normalized);
    return isNaN(date.getTime()) ? null : date;
}

⚠️ 注意:new Date('2024-01-15') (含連字號) 在 ES5+ 視為 UTC,會導致時區偏移;替換為斜線後視為當地時間。

時區陷阱與對策

輸入格式ES5+ 解析為建議
2024-01-15UTC 零點避免直接用,或手動補時區
2024/01/15當地時間零點推薦 (手動 replace)
2024-01-15T00:00:00當地時間 (無 Z)ISO 8601 標準,明確
2024-01-15T00:00:00ZUTC明確 UTC

傳輸層建議:統一用 Timestamp (毫秒數)

// 前端 → 後端
var timestamp = date.getTime(); // 毫秒數,時區中立
// 後端 → 前端
var date = new Date(timestampFromServer); // 瀏覽器自動按當地時區顯示

日期格式化輸出 (無依賴)

function formatDate(date, fmt = 'YYYY-MM-DD') {
    if (!(date instanceof Date) || isNaN(date)) return '';
    var o = {
        'YYYY': date.getFullYear(),
        'MM': String(date.getMonth() + 1).padStart(2, '0'),
        'DD': String(date.getDate()).padStart(2, '0'),
        'HH': String(date.getHours()).padStart(2, '0'),
        'mm': String(date.getMinutes()).padStart(2, '0'),
        'ss': String(date.getSeconds()).padStart(2, '0')
    };
    return fmt.replace(/YYYY|MM|DD|HH|mm|ss/g, m => o[m]);
}

生產環境建議

  • 專案若涉大量日期運算、時區轉換、相對時間顯示,直接引入 date-fns (模組化、Tree-shaking) 或 Luxon (現代 API、Intl 整合)。
  • 輕量專案僅需解析/格式化,上述 parseLocalDate + formatDate 足夠,壓縮後 < 1KB。
copyright © 萬盛學電腦網 all rights reserved