JavaScript自定义日期字符串解析与格式化教程

/**
 * 解析自定义格式的日期字符串（例如 "gen. 02, 2023"），并将其格式化为 "YYYY-MM-DD" 格式。
 *
 * @param {string} dateString - 待解析的日期字符串，例如 "gen. 02, 2023"。
 * @returns {string} 格式化后的日期字符串 (YYYY-MM-DD)，如果解析失败则返回错误信息。
 */
function formatCustomDateString(dateString) {
    // 1. 定义月份缩写到0-based索引的映射表
    const monthMap = {
        'jan': 0, 'feb': 1, 'mar': 2, 'apr': 3, 'may': 4, 'jun': 5,
        'jul': 6, 'aug': 7, 'sep': 8, 'oct': 9, 'nov': 10, 'dec': 11,
        'gen': 0 // 特别处理 'gen.' 作为 January 的缩写
    };

    // 2. 使用正则表达式从输入字符串中提取组件
    // 正则表达式解释:
    //   ([a-z]{3,})\.?  : 捕获至少3个字母的月份缩写，可选的后面跟一个点。
    //   \s+            : 匹配一个或多个空格。
    //   (\d{1,2})      : 捕获1或2位数字的日期。
    //   ,\s+           : 匹配逗号和一个或多个空格。
    //   (\d{4})        : 捕获4位数字的年份。
    //   'i' 标志         : 使匹配不区分大小写。
    const match = dateString.toLowerCase().match(/([a-z]{3,})\.?\s+(\d{1,2}),\s+(\d{4})/);

    if (!match) {
        console.error(`错误：无法解析日期字符串 "${dateString}"。期望格式类似 "Mon. DD, YYYY"。`);
        return "无效日期字符串";
    }

    const monthAbbr = match[1]; // 例如 'gen'
    const day = parseInt(match[2], 10); // 例如 2
    const year = parseInt(match[3], 10); // 例如 2023

    const monthIndex = monthMap[monthAbbr];

    if (typeof monthIndex === 'undefined') {
        console.error(`错误：日期字符串 "${dateString}" 中包含未知的月份缩写 "${monthAbbr}"。`);
        return "无效月份缩写";
    }

    // 3. 使用提取的组件构造一个 Date 对象
    // 注意：new Date(year, monthIndex, day) 构造函数期望 monthIndex 是0-based。
    const dateObj = new Date(year, monthIndex, day);

    // 4. 验证创建的 Date 对象是否有效
    // isNaN(dateObj.getTime()) 是检查 Date 对象是否有效的可靠方法。
    if (isNaN(dateObj.getTime())) {
        console.error(`错误：无法从组件创建有效的日期对象：年=${year}, 月索引=${monthIndex}, 日=${day}。`);
        return "无效日期对象";
    }

    // 5. 将有效的 Date 对象格式化为 YYYY-MM-DD
    const formattedYear = dateObj.getFullYear();
    // getMonth() 返回 0-11，所以需要加 1 得到实际的月份数字 (1-12)
    const formattedMonth = String(dateObj.getMonth() + 1).padStart(2, '0');
    const formattedDay = String(dateObj.getDate()).padStart(2, '0');

    return `${formattedYear}-${formattedMonth}-${formattedDay}`;
}

// 示例用法：
console.log(formatCustomDateString("gen. 02, 2023")); // 输出: 2023-01-02
console.log(formatCustomDateString("Jan. 15, 2024")); // 输出: 2024-01-15
console.log(formatCustomDateString("Dec 25, 2023"));  // 输出: 2023-12-25
console.log(formatCustomDateString("Feb 29, 2024"));  // 输出: 2024-02-29 (闰年)
console.log(formatCustomDateString("invalid date string")); // 输出: 错误信息及 "无效日期字符串"
console.log(formatCustomDateString("Mar 32, 2023")); // 输出: 错误信息及 "无效日期对象" (日期超出范围)