作者:UC 国际研发 浩浩
在做国际化项目的时候,时间日期是绕不过的槛,哪我们就一起来了解一下前端国际化时间日期和业务中的实践。
时间概念
首先我们需要搞明白时间概念。
国际标准
GMT 格林威治标准时间
GMT 时间就是英国格林威治时间,也就是世界标准时间,是本初子午线上的地方时,是 0 时区的区时。
当执行 new Date().toString() 时,会返回一个美式英语日期格式的字符串,里面包含了GMT 的描述。
UTC 世界协调时间
UTC 是通用协调时 (UTC, Universal Time Coordinated),理论上与 GMT 时间相等(除非出现了闰秒,日常使用上可以忽略不计)。
JavaScript 的 Date 对象提供了数个 UTC 时间的方法。
CST,PST
- CST: UTC +8,可以同时表示美国、澳大利亚、中国、古巴四个国家的标准时间
- PST: UTC -8,太平洋标准时间(西八区)
DST(夏令时)
目前实行夏令时的地区,详情请查看维基百科:https://zh.wikipedia.org/wiki/%E5%A4%8F%E6%97%B6%E5%88%B6#%E7%9B%AE%E5%89%8D%E5%AE%9E%E8%A1%8C%E5%A4%8F%E6%97%B6%E5%88%B6%E7%9A%84%E5%9C%B0%E5%8D%80
日期时间语法
RFC2822
ISO 8601
两者之间的差别
1、当在不指定时区的情况下,RFC2822 写法会使用 UTC 时间来解析,而 ISO 8601 写法则当作本地时区处理。
2、RFC2822 相对来说写法更加宽松,甚至可以兼容 Mon, 06 Mar 2017 21:22:23 +0000 这样的写法
3、RFC2822 的时区表示用四位数字(+0800),而 ISO 8601 的时区表示用 HH:MM (+08:00)
时区
UTC 时区
如果时间是以协调世界时(UTC)表示,则在时间后面直接加上一个 “Z”(不加空格)。“Z” 是协调世界时中 0 时区的标志。比如 09:30 UTC 相当于 09:30Z。
UTC 偏移量
UTC偏移量代表了某个具体的时间值与UTC时间之间的差异。用 ±[hh]:[mm] 或者 ±[hh]:[mm] 或者±[hh] 的形式表示。比如北京时间的时区会表达成 +08:00 / +0800 / UTC+8 。
时区缩写
时区也可以用字母缩写形式来表示,例如 “EST、WST、CST” 等。但是它们并不是 ISO 8601 标准的一部分,不建议使用。
TZ 数据库
形如 Asia/Shanghai 这样的写法,在 JavaScript 里不常见。
https://en.wikipedia.org/wiki/List_of_tz_database_time_zones有列出所有的可选项。
注意这里是按照 洲/城市 来划分的,而一个 tz 有可能对应多个不同的 UTC 偏差量(比如当地实行夏令时)。
时间戳
Unix 时间戳
unix时间戳是从1970年1月1日(UTC/GMT的00时00分00秒)开始所经过的秒数,不考虑闰秒。获取方法:
JavaScript 时间戳
JavaScript内的时间戳指的是当前时间到1970年1月1日00:00:00 UTC对应的毫秒数,跟 unix 时间戳相差了 1000 倍,跟其他语言/系统合作的时候需要留意。
获取方式有很多种:
其中性能最好的是 Date.now(),可以在 https://jsperf.com/date-now-vs-new-date-gettime/43 跑个分看看。
Date
Date 是 JavaScript 标准库里的对象,可以放心使用。但毕竟部分结果取决于宿主实现,在不同的宿主环境上还是有一定的差异(比如 Date.parse())。
需要注意的是,Date() 跟 new Date() 的表现是不一样的:
Date() 返回当前时间的字符串,且无视参数
new Date() 会根据传入参数返回一个日期对象
解析
new Date()
当不带参数时,会根据系统设置的当前时间来创建一个 Date 对象。
new Date(1524662090537)
当传入 JavaScript 时间戳数字时,返回解析成对应的 Date 对象。注意这里不是 unix 时间戳。
new Date('December 17, 1995 03:24:00')
new Date('1995-12-17T03:24:00')
当传入值是日期字符串时,该字符串应该能被 Date.parse() 方法识别,也就是需要符合 RFC2822 或 ISO 8601。
new Date(1995, 11, 17, 3, 24, 0)
当传入多个参数时,由于形参里没有时区概念,所以定义参数代表的是当地时间。
如果数值大于合理范围时,相邻的数值会被调整。如 new Date(2018, 0, 32) 表达的是二月一日。
运算
get / set
Date 原型上带有很多 get / set 方法,需要注意的是:
- Date.prototype.getMonth 返回 0-11 的整数值。如 0 代表一月份,1 代表二月份 (反直觉啊..
- set 方法有个特性,会将超过范围的参数自动折算。如将日期推后两天,只需要
比较
两个 Date 实例可以直接比较,也可以做减法。但不要做加法,否则变成了字符串拼接。
一般会使用时间戳相减,避免时区差异
格式化显示
Date 原型上也带有很多 toXXX 的方法,可以将 Date 对象转化成字符串或数字。具体 API 看文档就好,这里不做搬运啦。
本地化
日期与时间
浏览器获取的当前用户所在时区、当前日期时间等信息,与系统的设置有关。也就是东八区的用户设置了西四区,那获取出来的时区也是西四区的。
Date.prototype.getTimezoneOffset 可以获取当前时区与 UTC 时区的差值,单位是分钟。通过这个方法可以猜出用户所在哪个时区。
语言与地区
系统的这个设置会影响所有 .toLocale 方法,而且在不同浏览器下获取的不一定一致,需要输出给用户的时候最好自己实现。
业务实践
国际化配置
国际活动常用时区
印度: +05:30
印尼: +07:00
俄罗斯: +03:00
巴基斯坦: +05:00
孟加拉: +06:00
越南: +07:00
常用时间日期表达方式
印度:May 6, 2018, 00:00:00 (IST)
印尼:May 30, 2018 23:59:59 (WIB)
对外显示
对于多国家/多语言的站点,接口建议返回时间戳,然后在前端展示时才转换成当时时间显示。
对内配置
- 对于一些对内的时间点,比如定时脚本配置,可以约定使用北京时间配置,方便国内同学辨识。
- 对于一些涉及当地重要时间点的,比如斋月节的新月时间,应当约定使用当地时间进行配置,避免时区转换带来的隐性风险。
技术影响
浏览器时间校对
由于浏览器端时间不可控,有可能被用户修改系统设置从而故意绕过业务逻辑,所以一律使用服务器时间:
- 通过同步渲染的方式把服务器时间戳下发到页面
- 心跳 Ajax 获取服务器时间进行对时
服务器网络时间同步
NTP(Network Time Protocol,网络时间协议)是用来使网络中的各个计算机时间同步的一种协议。它的用途是把计算机的时钟同步到 UTC。Linux 系统中,为了避免主机时间因为在长时间运行下所导致的时间偏差,一般使用 NTP 服务来同步不同机器的时时间。
MySQL 时间
有时间精度要求的业务,可以使用 datetime(6); 对精度没要求的,设置为 datetime。时间操作应该直接用 MySQL 内置函数。
参考文档
Date - JavaScript | MDN:
https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date
JS原生Date类型方法的一些冷知识 | 我很好奇:
http://chitanda.me/2015/08/21/the-trivia-of-js-date-function