JavaScript 日期与时间戳转换的 5 种方法及最佳实践

// 获取当前毫秒时间戳（13位）
const millis = Date.now();
console.log(millis);  // 1704067200000

// 获取当前秒级时间戳（10位）
const seconds = Math.floor(Date.now() / 1000);
console.log(seconds);  // 1704067200

// 兼容旧浏览器的 polyfill
if (!Date.now) {
    Date.now = function() {
        return new Date().getTime();
    };
}

// 不推荐：隐式转换，可读性差
const ts1 = +new Date();

// 不推荐：同样依赖隐式转换
const ts2 = Number(new Date());

// 推荐：显式调用，意图明确
const ts3 = new Date().getTime();
const ts4 = Date.now();

// 假设你的电脑时区是北京时间（UTC+8）
const ts = 1704067200000;  // 2024-01-01 00:00:00 UTC
const date = new Date(ts);

console.log(date.toString());
// "Mon Jan 01 2024 08:00:00 GMT+0800 (中国标准时间)"
// 注意：显示的是北京时间 08:00，而非 UTC 00:00

const ts = 1704067200000;
const date = new Date(ts);

// 显示为北京时间
console.log(date.toLocaleString('zh-CN', {
    timeZone: 'Asia/Shanghai',
    year: 'numeric', month: '2-digit', day: '2-digit',
    hour: '2-digit', minute: '2-digit', second: '2-digit',
    hour12: false
}));
// "2024/01/01 08:00:00"

// 显示为 UTC 时间
console.log(date.toLocaleString('en-GB', {
    timeZone: 'UTC',
    year: 'numeric', month: '2-digit', day: '2-digit',
    hour: '2-digit', minute: '2-digit', second: '2-digit',
    hour12: false
}));
// "01/01/2024, 00:00:00"

// ✅ 推荐：ISO 8601 格式，所有现代浏览器一致解析
new Date('2024-01-01T00:00:00Z').getTime();       // 带 Z 表示 UTC
new Date('2024-01-01T08:00:00+08:00').getTime();  // 带时区偏移

// ⚠️ 谨慎：本地时间格式，可能被解析为 UTC 或本地时区
new Date('2024/01/01 08:00:00').getTime();  // 行为不一致

// ❌ 避免：非标准格式，Safari 可能返回 Invalid Date
new Date('01-01-2024');   // 美国格式，部分地区解析错误
new Date('2024.01.01');   // 非标准分隔符

/**
 * 将日期字符串转为时间戳（兼容所有浏览器）
 * @param {string} str - 格式：YYYY-MM-DD HH:mm:ss
 * @returns {number} 毫秒时间戳
 */
function parseDateToTimestamp(str) {
    const [datePart, timePart = '00:00:00'] = str.split(' ');
    const [year, month, day] = datePart.split('-').map(Number);
    const [hour, minute, second] = timePart.split(':').map(Number);

    // 注意：month 在 Date 构造函数中是 0-11
    return new Date(year, month - 1, day, hour, minute, second).getTime();
}

parseDateToTimestamp('2024-01-01 08:00:00');  // 1704067200000

/**
 * 时间戳工具集
 * 兼容浏览器与 Node.js 环境
 */
const TimestampUtil = {
    /** 获取当前秒级时间戳（10位） */
    nowSeconds: () => Math.floor(Date.now() / 1000),

    /** 获取当前毫秒级时间戳（13位） */
    nowMillis: () => Date.now(),

    /** 时间戳转格式化字符串（默认北京时间） */
    format: (ts, fmt = 'yyyy-MM-dd HH:mm:ss') => {
        const d = new Date(typeof ts === 'string' ? parseInt(ts) : ts);
        const pad = n => String(n).padStart(2, '0');
        const map = {
            'yyyy': d.getFullYear(),
            'MM': pad(d.getMonth() + 1),
            'dd': pad(d.getDate()),
            'HH': pad(d.getHours()),
            'mm': pad(d.getMinutes()),
            'ss': pad(d.getSeconds())
        };
        return fmt.replace(/yyyy|MM|dd|HH|mm|ss/g, match => map[match]);
    },

    /** 判断时间戳是秒级还是毫秒级 */
    detectUnit: ts => {
        const n = typeof ts === 'string' ? parseInt(ts) : ts;
        return n < 10000000000 ? 'seconds' : 'millis';
    },

    /** 统一转为毫秒时间戳 */
    toMillis: ts => {
        const n = typeof ts === 'string' ? parseInt(ts) : ts;
        return n < 10000000000 ? n * 1000 : n;
    },

    /** 计算两个时间戳之间的时间差（返回天数） */
    diffDays: (ts1, ts2) => {
        const msPerDay = 24 * 60 * 60 * 1000;
        return Math.floor(Math.abs(TimestampUtil.toMillis(ts1) - TimestampUtil.toMillis(ts2)) / msPerDay);
    }
};

// 使用示例
TimestampUtil.format(1704067200000);  // "2024-01-01 08:00:00"
TimestampUtil.detectUnit(1704067200);    // "seconds"
TimestampUtil.detectUnit(1704067200000);  // "millis"