背景
JavaScript 的对象在内部以 UTC 格式跟踪时间,但通常接受输入,并在运行它的计算机的本地时间生成输出。它几乎没有其他时区处理时间的设施。Date
对象的内部表示是一个数字,表示自 以来经过的毫秒数,而不考虑闰秒。Date
1970-01-01 00:00:00 UTC
Date 对象本身中没有存储任何时区或字符串格式。
当使用对象的各种功能时,计算机的本地时区将应用于内部表示。如果该函数生成字符串,则可以考虑计算机的区域设置信息,以确定如何生成该字符串。细节因函数而异,有些是特定于实现的。Date
该对象可以对非本地时区执行的唯一操作是:Date
-
它可以分析包含来自任何时区的数字 UTC 偏移量的字符串。它使用它来调整正在解析的值,并存储 UTC 等效项。原始本地时间和偏移量不会保留在生成的对象中。例如:Date
var d = new Date("2020-04-13T00:00:00.000+08:00");
d.toISOString() //=> "2020-04-12T16:00:00.000Z"
d.valueOf() //=> 1586707200000 (this is what is actually stored in the object)
-
在已实现 ECMASCript 国际化 API(也称为“Intl”)的环境中,对象可以生成特定于区域设置的字符串,该字符串已调整为给定的时区标识符。这是通过选项 to 及其变体实现的。大多数实现将支持 IANA 时区标识符,例如 .例如:Date
timeZone
toLocaleString
'America/New_York'
var d = new Date("2020-04-13T00:00:00.000+08:00");
d.toLocaleString('en-US', { timeZone: 'America/New_York' })
//=> "4/12/2020, 12:00:00 PM"
// (midnight in China on Apring 13th is noon in New York on April 12th)
大多数现代环境都支持全套 IANA 时区标识符(请参阅此处的兼容性表)。但是,请记住,Intl 支持的唯一标识符是 ,因此您应该仔细检查是否需要支持较旧的浏览器或非典型环境(例如,轻量级 IoT 设备)。'UTC'
图书馆
有几个库可用于处理时区。虽然他们仍然无法使对象的行为有任何不同,但他们通常实现标准的IANA时区数据库,并提供在JavaScript中使用它的函数。现代库使用由 Intl API 提供的时区数据,但较旧的库通常具有开销,尤其是在 Web 浏览器中运行时,因为数据库可能会变得有点大。其中一些库还允许您有选择地减少数据集,无论是按支持的时区和/或按您可以使用的日期范围。Date
以下是要考虑的库:
基于国际的图书馆
新开发应从以下实现之一中进行选择,这些实现依赖于 Intl API 作为其时区数据:
非国际图书馆
这些库是维护的,但承担了打包自己的时区数据的负担,这些数据可能相当大。
*虽然之前推荐了Moment和Moment-Timezone,但Moment团队现在更喜欢用户选择Luxon进行新的开发。
已停产的图书馆
这些图书馆已正式停产,不应再使用。
未来提案
TC39 时态提案旨在提供一组新的标准对象,用于在 JavaScript 语言本身中处理日期和时间。这将包括对时区感知对象的支持。