JavaScript中日期字符串怎么准确转换为Epoch时间戳

在JavaScript开发中，把日期字符串转换为Epoch时间戳是高频需求，Epoch时间戳指的是从1970年1月1日00:00:00 UTC开始经过的毫秒数，很多场景都需要用到这个数值做时间相关的处理。

基础转换方法

对于符合ISO 8601标准的日期字符串，比如2024-05-20T12:30:00Z，可以直接使用Date.parse()方法或者new Date()构造函数来获取时间戳。

// 符合ISO标准的日期字符串转换
const dateStr1 = '2024-05-20T12:30:00Z';
const timestamp1 = Date.parse(dateStr1);
console.log(timestamp1); // 输出对应的毫秒级Epoch时间戳

const dateObj1 = new Date(dateStr1);
const timestamp2 = dateObj1.getTime();
console.log(timestamp2); // 和上面结果一致

非标准日期字符串的处理

如果日期字符串是类似2024/05/20 12:30:00或者2024-05-20 12:30:00这种非ISO格式，不同浏览器的Date.parse()表现可能不一致，更稳妥的方式是手动拆分字符串再构造时间对象。

// 处理yyyy-MM-dd HH:mm:ss格式的日期字符串
function parseDateStrToTimestamp(dateStr) {
    // 拆分日期和时间部分
    const [datePart, timePart] = dateStr.split(' ');
    const [year, month, day] = datePart.split('-').map(Number);
    const [hour, minute, second] = timePart ? timePart.split(':').map(Number) : [0, 0, 0];
    // 注意月份是从0开始计数的，所以要减1
    const dateObj = new Date(year, month - 1, day, hour, minute, second);
    return dateObj.getTime();
}

const dateStr2 = '2024-05-20 12:30:00';
const timestamp3 = parseDateStrToTimestamp(dateStr2);
console.log(timestamp3); // 输出本地时区对应的毫秒级时间戳

时区问题的处理

默认情况下，new Date()构造的时间对象会基于本地时区解析，如果需要明确使用UTC时区，可以在构造时传入UTC相关的参数，或者对时间做偏移调整。

// 处理UTC时区的非标准日期字符串
function parseUTCDateStrToTimestamp(dateStr) {
    const [datePart, timePart] = dateStr.split(' ');
    const [year, month, day] = datePart.split('-').map(Number);
    const [hour, minute, second] = timePart ? timePart.split(':').map(Number) : [0, 0, 0];
    // 使用Date.UTC方法构造UTC时间
    return Date.UTC(year, month - 1, day, hour, minute, second);
}

const dateStr3 = '2024-05-20 12:30:00';
const timestamp4 = parseUTCDateStrToTimestamp(dateStr3);
console.log(timestamp4); // 输出UTC时区对应的毫秒级时间戳

转换结果验证

转换完成后，可以通过反向把时间戳转为日期字符串的方式验证结果是否准确，避免转换过程中出现错误。

// 验证时间戳转换是否正确
function verifyTimestamp(timestamp, originalDateStr) {
    const dateObj = new Date(timestamp);
    const verifyStr = `${dateObj.getFullYear()}-${String(dateObj.getMonth() + 1).padStart(2, '0')}-${String(dateObj.getDate()).padStart(2, '0')} ${String(dateObj.getHours()).padStart(2, '0')}:${String(dateObj.getMinutes()).padStart(2, '0')}:${String(dateObj.getSeconds()).padStart(2, '0')}`;
    return verifyStr === originalDateStr;
}

const testTimestamp = parseDateStrToTimestamp('2024-05-20 12:30:00');
console.log(verifyTimestamp(testTimestamp, '2024-05-20 12:30:00')); // 输出true表示转换正确

常见错误规避

• 不要直接使用Date.parse()处理非标准格式的日期字符串，避免浏览器兼容性问题导致结果错误
• 处理月份的时候要注意JavaScript的月份是从0开始计数的，传入参数时需要减1
• 如果业务需要统一时区，要明确指定使用UTC时区还是本地时区，避免时区偏差导致时间戳错误
• 转换前可以先校验日期字符串的格式是否合法，避免传入无效字符串导致返回NaN

JavaScript日期字符串Epoch时间戳时间戳转换修改时间：2026-07-12 08:06:24