如何用Kendo将OLE日期转为GMT/UTC格式的JavaScript日期？

问题核心 #

JavaScript的Date对象本质存储UTC时间戳，但默认格式化方法（包括kendo.toString）会自动转换为本地时区。要保留UTC时区的日期格式，关键是让格式化工具读取UTC的日期分量，而非本地时区的分量。

方法一：复用kendo格式化（推荐） #

通过构建一个"伪本地时间"的Date对象，把UTC的日期分量当作本地时间分量传入，让kendo直接使用这些值格式化，避免时区转换。

function excelOleDateToJavaScriptString(excelDateValue, format) {
    // 转换Excel OLE日期为UTC时间戳
    const utcTimestamp = (excelDateValue - 25569) * 86400 * 1000;
    const utcDate = new Date(utcTimestamp);
    
    // 构建伪本地时间：将UTC的年/月/日/时等分量作为本地时间分量
    const fakeLocalDate = new Date(
        utcDate.getUTCFullYear(),
        utcDate.getUTCMonth(),
        utcDate.getUTCDate(),
        utcDate.getUTCHours(),
        utcDate.getUTCMinutes(),
        utcDate.getUTCSeconds(),
        utcDate.getUTCMilliseconds()
    );
    
    // 用kendo格式化伪本地时间，得到UTC对应的格式结果
    return kendo.toString(fakeLocalDate, format);
}

原理 #

这个fakeLocalDate的内部时间戳是本地时区的时刻，但它的年、月、日等可见分量完全匹配UTC时间。kendo.toString读取这些本地分量时，就会输出我们需要的UTC日期格式，不会出现时区偏移。

方法二：手动解析格式字符串 #

如果不想依赖kendo的格式化逻辑，可以自己解析格式字符串，替换为UTC的日期分量，完全控制格式化过程。

function excelOleDateToJavaScriptString(excelDateValue, format) {
    // 转换为UTC时间戳并提取UTC分量
    const utcTimestamp = (excelDateValue - 25569) * 86400 * 1000;
    const date = new Date(utcTimestamp);
    const utc = {
        year: date.getUTCFullYear(),
        month: date.getUTCMonth() + 1, // 转为1-12的月份
        date: date.getUTCDate(),
        hours: date.getUTCHours(),
        minutes: date.getUTCMinutes(),
        seconds: date.getUTCSeconds(),
        dayOfWeek: date.getUTCDay(),
        ampm: date.getUTCHours() < 12 ? 'AM' : 'PM'
    };
    
    // 补零辅助函数
    const pad = (num, len = 2) => num.toString().padStart(len, '0');
    // 月份/星期名称（可替换为多语言版本）
    const monthNames = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
    const fullMonthNames = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
    const dayNames = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
    const fullDayNames = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
    
    // 按优先级替换格式符（长格式先替换，避免截断）
    return format
        // 年份
        .replace(/yyyy/g, utc.year)
        .replace(/yy/g, utc.year.toString().slice(-2))
        // 月份
        .replace(/MMMM/g, fullMonthNames[utc.month - 1])
        .replace(/MMM/g, monthNames[utc.month - 1])
        .replace(/MM/g, pad(utc.month))
        .replace(/M/g, utc.month)
        // 日期
        .replace(/dd/g, pad(utc.date))
        .replace(/d/g, utc.date)
        // 小时（24/12小时制）
        .replace(/HH/g, pad(utc.hours))
        .replace(/H/g, utc.hours)
        .replace(/hh/g, pad(utc.hours % 12 || 12))
        .replace(/h/g, utc.hours % 12 || 12)
        // 分钟/秒
        .replace(/mm/g, pad(utc.minutes))
        .replace(/m/g, utc.minutes)
        .replace(/ss/g, pad(utc.seconds))
        .replace(/s/g, utc.seconds)
        // AM/PM
        .replace(/tt/g, utc.ampm)
        .replace(/t/g, utc.ampm.charAt(0))
        // 星期
        .replace(/dddd/g, fullDayNames[utc.dayOfWeek])
        .replace(/ddd/g, dayNames[utc.dayOfWeek]);
}

适用场景 #

适合需要完全自定义格式规则，或者项目中不想依赖kendo库的场景，可根据需求扩展更多格式符支持。

内容的提问来源于stack exchange，提问作者CuriousGeo66