如何在javascript中处理日期与时间_从Date对象到Moment.js库的演进【教程】

13次阅读

原生 date 够用但易出错;Moment.js 已停更,新项目应避免。推荐 date-fns(轻量、不可变、tree-shakable)或 luxon(强时区支持),并统一团队时间语义认知。

如何在javascript中处理日期与时间_从Date对象到Moment.js库的演进【教程】

原生 Date 对象够用,但写业务逻辑时容易出错;Moment.js 曾是事实标准,但已进入维护模式,不建议新项目引入。

为什么原生 Date 经常让人踩坑

它没有不可变性、解析行为不一致、时区处理模糊,且 API 设计反直觉。比如:

  • new Date('2023-10-01')safarichrome 中可能解析为 UTC 或本地时区,取决于格式是否含时分秒
  • getMonth() 返回 0–11,getDay() 返回 0–6(星期几),不是日期数字
  • setFullYear(2023, 1, 30) 设置 2 月 30 日会自动溢出到 3 月 2 日,但没人告诉你它悄悄改了
  • 没有内置的格式化方法,toLocaleString() 输出受系统 locale 和选项影响大,难以稳定控制

Intl.DateTimeFormat 替代 Moment 格式化

现代浏览器支持良好(IE 除外),可精准控制语言、时区、粒度,且不引入第三方包。

const date = new Date('2023-05-15T14:30:00Z'); const formatter = new Intl.DateTimeFormat('zh-CN', {   year: 'numeric',   month: '2-digit',   day: '2-digit',   hour: '2-digit',   minute: '2-digit',   second: '2-digit',   timeZone: 'Asia/Shanghai' }); console.log(formatter.format(date)); // "2023-05-15 22:30:00"
  • 时区必须显式传 timeZone,否则用用户本地时区
  • 格式键(如 month: 'short')不支持自定义模板,要拼字符串得靠 formatToParts()
  • 若需 ISO 8601 字符串(含时区),直接用 date.toISOString(),但注意它永远输出 UTC

date-fns 替代 Moment 的计算与操作

Moment 是单个大对象 + 原型链修改,date-fns 是纯函数、不可变、tree-shakable,体积小得多。

立即学习Java免费学习笔记(深入)”;

import { addDays, format, parseISO, isAfter } from 'date-fns';  const d = parseISO('2023-09-20'); const tomorrow = addDays(d, 1); console.log(format(tomorrow, 'yyyy-MM-dd')); // "2023-09-21" console.log(isAfter(tomorrow, d)); // true
  • 所有函数第一个参数都是 Date 实例,不接受字符串(除非用 parseISO 等专用解析函数)
  • 无全局状态,不用担心多处调用互相污染
  • 不处理时区转换 —— 它把时区问题留给开发者明确决定:用 zonedTimeToUtc(来自 date-fns-tz)或自己用 toLocaleString + timeZone

新项目该选什么:date-fns 还是 luxon

如果项目需要强时区支持(如跨地区日程调度)、又不想手写时区逻辑,luxon 更合适;否则 date-fns 足够轻量可靠。

  • luxonDateTime 对象自带时区信息,DateTime.fromISO('2023-01-01', { zone: 'Europe/London' }) 可稳定构造
  • date-fns 默认所有操作都在本地时区,utcToZonedTime 需额外依赖 date-fns-tz,配置略繁琐
  • 两者都不再需要 Moment 的 moment().add(1, 'day') 这类魔数字符串,类型更安全

真正难的是统一团队对“时间语义”的理解:这个时间是用户本地时间?服务器时间?UTC 时间?存数据库用什么格式?前端展示要不要自动换算?库只是工具,没解决这个问题之前,换哪个库都还会出错。

text=ZqhQzanResources