萬盛學電腦網

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

JavaScript 獲取日期範圍內所有日期的工具函數

需求場景

給定起始日期與結束日期,生成包含範圍內每一天的日期陣列(格式化字串),常用於報表、日曆、統計圖表的 X 軸資料準備。

核心實現

// 為 Date 原型擴充加天方法(不修改原對象,返回新對象)
Date.prototype.addDays = function(days) {
    var dat = new Date(this.valueOf());
    dat.setDate(dat.getDate() + days);
    return dat;
};

// 格式化輸出:YYYY-MM-DD
Date.prototype.formatDate = function() {
    var y = this.getFullYear();
    var m = (this.getMonth() + 1).toString().padStart(2, '0');
    var d = this.getDate().toString().padStart(2, '0');
    return y + '-' + m + '-' + d;
};

// 主函數:獲取日期範圍陣列
function getDates(startDate, stopDate) {
    var dateArray = [];
    var currentDate = new Date(startDate); // 複製避免污染原對象
    var endDate = new Date(stopDate);

    while (currentDate <= endDate) {
        dateArray.push(currentDate.formatDate());
        currentDate = currentDate.addDays(1);
    }
    return dateArray;
}

// 使用範例
var dates = getDates('2024-01-01', '2024-01-05');
console.log(dates);
// ["2024-01-01", "2024-01-02", "2024-01-03", "2024-01-04", "2024-01-05"]

ES6+ 現代寫法(推薦)

function getDatesModern(start, end) {
    const startDate = new Date(start);
    const endDate = new Date(end);
    const dates = [];

    for (let d = new Date(startDate); d <= endDate; d.setDate(d.getDate() + 1)) {
        dates.push(d.toISOString().split('T')[0]); // 直接取 YYYY-MM-DD
    }
    return dates;
}

// 或使用生成器(記憶體友善)
function* dateRangeGenerator(start, end) {
    for (let d = new Date(start); d <= new Date(end); d.setDate(d.getDate() + 1)) {
        yield d.toISOString().split('T')[0];
    }
}

// 用法
[...dateRangeGenerator('2024-01-01', '2024-01-05')];

注意事項

  • 時區陷阱:`new Date('2024-01-01')` 解析為 UTC 午夜,可能導致時區偏移。建議用 `new Date(year, monthIndex, day)` 構造。
  • 效能:超大範圍(如跨年)建議用生成器或分批處理。
  • 不可變性:`addDays` 返回新對象,避免副作用。
  • 格式化:`toLocaleDateString('zh-TW')` 可依地區自動格式化。

TypeScript 類型定義

function getDates(startDate: Date | string, stopDate: Date | string): string[];
function getDates(startDate: Date | string, stopDate: Date | string, formatFn: (d: Date) => string): string[];
copyright © 萬盛學電腦網 all rights reserved