JavaScript 在 1.1 就支持 Date 对象，所有主流浏览器都支持。 和其他语言类似，Date、Time 的表现会受到时区的影响，在编写跨时区网站的页面脚本时，或者单元测试在其他时区的持续集成服务上运行时，都需要熟悉 Date 对象里的时区概念。 本文介绍 Date 对象的初始化字符串会被当做怎样的时区解释，Date 上的方法哪些是时区相关的，以及如何编写在所有时区都能运行的代码。

UTC 时间

UTC、GMT、当地时间（LT）这些概念就不重复了，大概 UTC 和 GMT 都等于零时区的当地时间。具体可以参考 Linux/Windows 时间不一致问题。 在多数语言和数据库里，DateTime 的存储都采用 UTC 时间，不存具体的时区信息。 因为 UTC 时间就是零时区的当地时间，下文把这个时间称为绝对时间。

JavaScript 的 Date 对象也一样，它的内存表示就是绝对时间，当调用 .getHours()，.toString() 时再根据操作系统时区设置来解释。 Web 中的时间采用格里历（公历），Date 可以用数字来初始化，其零点 new Date(0) 为 1970-01-01T00:00:00.0Z，可以用负数来表示 1970-01-01 之前的日期。 这个数字表示从 1970-01-01 到此经过的毫秒数（注意 Unix TimeStamp 或 Seconds since the Epoch 都是精确到秒），即 new Date(1000) 为 1970-01-01T00:00:01.0Z。

Date 初始化

Date 有最多 7 个构造参数，我们不去展开具体语法（参考MDN Date）。 数字和无参数初始化的含义都很明确，但使用日期字符串初始化时会比较隐晦，MDN 提到日期字符串初始化还存在浏览器见不一致的问题。 JavaScript 的主流实现中，日期字符串采用 RFC2822 规范，也存在采用 ISO8601 规范的实现。 虽然不建议使用字符串初始化 Date，但我们还是要举例说明在 V8 下哪些情况被解释为 UTC 时间（绝对时间），哪些情况被解释为当地时间。

以下会被解释为 UTC 时间：

  • "2019-12-15"
  • "2019-12-15T00:00:00Z"
  • "2019-12-15T00:00:00.0Z"
  • "2019-12-15T00:00:00.00Z"

以下会被解释为当地时间：

  • "2019-12-15T00:00:00"
  • "2019-12-15 00:00:00"
  • "2019-12-15 00:00:00 +0800"
  • "Sun Dec 15 2019 00:00:00 GMT+0800 (China Standard Time)"
  • "Sun Dec 15 2019 00:00:00 +0800"

写明 CST、+0800 的都比较没有歧义，主要关注其他的字符串里，只要没有写 T 和 Z 的都会被解释为当地时间，这一点和 ISO8601 也不一致。

时区相关的方法

多数方法都是依赖时区的，因为这样用起来才方便。Ruby、PHP 里的 strftime 中多数格式化字符（比如 %H, %m 等）也都是依赖时区的。 比如我这里（中国北京） new Date(0).getHours() 是 8，因为 1970-01-01T00:00:00.0Z 时 GMT 时间是零点，对应北京当地时间是 8 点。 在 JavaScript Date 里，对应的不依赖时区的（绝对时间）对应方法都叫做 getUTCxxx()。比如：

  • getHours() 是当地时间，getUTCHours() 是 UTC 时间。
  • getMonth() 是当地时间，getUTCMonth() 是 UTC 时间。
  • getDay() 是当地时间，getUTCDay() 是 UTC 时间。

编写时区无关的代码

由于多数方法都是时区相关的，我们可以很容易编写出在不同时区下有不同展示的 Web 页面。 现在的挑战是如何编写在任何时区都有一致表现的代码，比如你的单元测试在全球的任何服务器上都能跑通。

  1. 只关心运算的场景，统一使用绝对时间初始化。如果 Date 在你的系统里只是用来比较大小、计算差值，就应该多使用绝对时间的初始化方式。比如：new Date(3422200000)。
  2. 只关心呈现的场景，统一使用当地时间初始化。如果你会大量地创建对象并查看它的字符串表示（toString(), strftime 格式化等），就应多使用当地时间来初始化。虽然内部表示会随着时区变化，但初始化和呈现时总是一致的。比如 new Date('2016-07-01') 在任何时区里 toString 后仍然是 07/01/2016。

本文采用 知识共享署名 4.0 国际许可协议（CC-BY 4.0）进行许可，转载注明来源即可： https://harttle.land/2019/12/15/javascript-date-timezone.html。如有疏漏、谬误、侵权请通过评论或 邮件 指出。