jQuery datetimepicker月末日期显示异常问题求助

问题根源 #

十有八九是时区解析不匹配导致的：你用JS计算的日期是本地时区的正确值，但datetimepicker组件内部可能默认按UTC时间解析，或者你传递的日期格式和组件预期格式不统一，最终导致显示的日期偏移了一天。控制台打印正确是因为JS的Date对象基于本地时间，而组件解析时做了UTC转换，才出现了一天的差值。

直接可用的解决方案 #

1. 避免传递Date对象，改用格式化字符串赋值 #

不少版本的datetimepicker对Date对象的时区处理存在bug，直接传递YYYY-MM-DD格式的字符串能彻底规避这个问题：

// 基准日期：2025-04-22
const baseDate = new Date('2025-04-22');
// 构造当月第一天字符串：2025-04-01
const startStr = `${baseDate.getFullYear()}-${String(baseDate.getMonth()+1).padStart(2, '0')}-01`;
// 构造当月最后一天字符串：2025-04-30
const endDate = new Date(baseDate.getFullYear(), baseDate.getMonth()+1, 0);
const endStr = `${baseDate.getFullYear()}-${String(baseDate.getMonth()+1).padStart(2, '0')}-${endDate.getDate()}`;

// 给datetimepicker赋值
$('#startPicker').datetimepicker('setDate', startStr);
$('#endPicker').datetimepicker('setDate', endStr);

2. 统一组件的日期格式配置 #

检查组件初始化代码，确保format参数和你传递的字符串格式完全匹配，同时禁用自动填充当前时间的配置，避免时区干扰：

$('.datetimepicker').datetimepicker({
    format: 'YYYY-MM-DD', // 和传递的字符串格式严格对应
    useCurrent: false, // 关闭自动使用当前时间的逻辑
    locale: 'zh-CN' // 用中文locale避免格式解析偏差
});

3. 强制组件使用本地时区 #

如果业务不需要跨时区处理，直接给组件设置时区为local：

$('.datetimepicker').datetimepicker({
    timeZone: 'local',
    format: 'YYYY-MM-DD'
});

4. 排查UTC相关转换代码 #

检查你计算日期的逻辑里，有没有用到getUTCDate()、toUTCString()这类UTC相关方法，如果有，替换成本地时间的对应方法（比如getDate()、toLocaleDateString()）。

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