Moment.js格式化ISO日期时日期显示异常的原因咨询

问题重现 #

我们有两个UTC时区的ISO格式日期：

const startedAt = '2023-10-18T14:03:36.150Z';
const closedAt = '2023-10-18T18:13:33.150Z';

计算时间差时结果符合预期：

const duration = moment.duration(moment(closedAt).diff(startedAt));
const days = duration.days(); // 0
const hours = duration.hours(); // 4
const minutes = duration.minutes(); // 9
const seconds = duration.seconds(); // 57

但格式化后closedAt的日期异常：

const start = moment(startedAt).format('DD, dddd, hh:mm:ss');
const end = moment(closedAt).format('DD, dddd, hh:mm:ss');
// start: 18, wednesday, 08:03:36 (+6GMT)
// end: 19, thursday, 12:13:33 (+6GMT)

原因分析 #

问题核心是时区转换：

• ISO日期末尾的Z代表这是UTC时区的时间
• Moment.js默认会将UTC时间转换为你的本地时区（这里是+6GMT）
• 计算closedAt的本地时间：UTC的2023-10-18T18:13:33.150加上6小时，就变成了2023-10-19T00:13:33.150+06:00，因此日期跳转到19号，星期也从周三变为周四
• 而计算时间差时，diff方法基于时间戳的差值计算，不受时区转换影响，所以结果正常

解决方法 #

根据需求选择以下方式：

1. 保持UTC时区格式化 #

用moment.utc()解析日期，强制使用UTC时区处理：

const start = moment.utc(startedAt).format('DD, dddd, hh:mm:ss [UTC]');
const end = moment.utc(closedAt).format('DD, dddd, hh:mm:ss [UTC]');
// 输出：
// start: 18, Wednesday, 02:03:36 UTC
// end: 18, Wednesday, 06:13:33 UTC

2. 明确显示时区偏移 #

格式化时添加时区标识，方便排查时区问题：

const start = moment(startedAt).format('DD, dddd, hh:mm:ss ZZ');
const end = moment(closedAt).format('DD, dddd, hh:mm:ss ZZ');
// 输出：
// start: 18, Wednesday, 08:03:36 +0600
// end: 19, Thursday, 12:13:33 +0600

3. 指定特定时区解析（需moment-timezone插件） #

如果需要转换到非本地的特定时区，先安装moment-timezone插件，再指定时区：

const start = moment.tz(startedAt, 'Asia/Shanghai').format('DD, dddd, hh:mm:ss');
const end = moment.tz(closedAt, 'Asia/Shanghai').format('DD, dddd, hh:mm:ss');

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