VIII.异步 - 40.日期（Date） - 《[译] 写给不耐烦程序员的 JavaScript》

40.日期（Date）

40.日期（`Date`）

原文： http://exploringjs.com/impatient-js/ch_dates.html

本章介绍 JavaScript 用于处理日期的 API - Date。

40.1。最佳实践：不要使用当前的内置 API

JavaScript Date API 使用起来很麻烦。因此，最好依靠图书馆来处理与日期相关的任何事情。热门图书馆包括：

请参阅博客文章“为什么你不应该使用 Moment.js ……”了解这些库的优缺点。

此外，TC39 正在开发 JavaScript 的新日期 API： temporal 。

40.2。背景：UTC 与 GMT

UTC（协调世界时）和 GMT（格林威治标准时间）具有相同的当前时间，但它们是不同的东西：

UTC：是所有时区所基于的时间标准。它们是相对于它指定的。也就是说，没有状态或地区将 UTC 作为其本地时区。
GMT：是一些欧洲和非洲状态使用的时区。

资料来源：“TimeTndDate.com 上的 GMT 和 UTC 之间的差异”

40.3。背景：日期时间格式（ISO）

日期时间格式描述：

接受的字符串：
- Date.parse()
- new Date()
返回的字符串（总是最长的格式）：
- Date.prototype.toISOString()

以下是.toISOString()返回的日期时间字符串的示例：

日期时间格式具有以下结构：

日期格式：Y =年份; M =月; d =天
```
YYYY-MM-DD
YYYY-MM
YYYY
```
时间格式：T =分隔符（字符串'T'）; H =小时; M =分钟; s =秒和毫秒; Z =时区是 UTC（字符串'Z'）
```
THH:mm:ss.sss
THH:mm:ss.sssZ
THH:mm:ss
THH:mm:ssZ
THH:mm
THH:mmZ
```
日期时间格式：日期格式后跟时间格式。
- 例如（最长）：YYYY-MM-DDTHH:mm:ss.sssZ

Z的替代方案 - 相对于 UTC 的时区：

+hh:mm
-hh:mm

40.4。时间值

时间值 表示自 1970 年 1 月 1 日 00:00:00 UTC 以来的毫秒数的日期。

时间值可用于创建日期：

将日期强制转换为数字会返回其时间值：

订购运算符将他们的操作数强制转换为数字。因此，您可以使用这些运算符来比较日期：

40.4.1。创建时间值

以下方法创建时间值：

Date.now(): number

返回当前时间作为时间值。
Date.parse(dateTimeString): number（当地时区）

解析dateTimeString并返回相应的时间值。
Date.UTC(year, month, date?, hours?, minutes?, seconds?, milliseconds?): number

返回指定的 UTC 日期时间的时间值。

40.4.2。获取和设置时间值

Date.prototype.getTime(): number

返回与 Date 对应的时间值。
Date.prototype.setTime(timeValue)

将this设置为timeValue编码的日期。

40.5。创建日期

new Date(year: number, month: number, date?: number, hours?: number, minutes?: number, seconds?: number, milliseconds?: number)（当地时区）
new Date(dateTimeStr: string)（UTC）
new Date(timeValue: number)
new Date()（与new Date(Date.now())相同）

40.6。吸气剂和二传手

40.6.1。时间单位吸气剂和二传手

日期有时间单位的 getter 和 setter。例如：

Date.prototype.getFullYear()
Date.prototype.setFullYear(num)

这些 getter 和 setter 符合以下模式：

当地时间：
- Date.prototype.get«Unit»()
- Date.prototype.set«Unit»(num)
世界时间：
- Date.prototype.getUTC«Unit»()
- Date.prototype.setUTC«Unit»(num)

这些是支持的时间单位：

日期
- FullYear
- Month：月（0-11）。 陷阱： 0 是 1 月等
- Date：每月的某一天（1-31）
- Day（仅限吸气剂）：星期几（0-6）; 0 是星期天
时间
- Hours：小时（0-23）
- Minutes：分钟（0-59）
- Seconds：秒（0-59）
- Milliseconds：毫秒（0-999）

还有一个吸气剂不符合前面提到的模式：

Date.prototype.getTimezoneOffset()

返回本地时间和 UTC 之间的时差，以分钟为单位。例如，对于 CET，它返回-60。

40.7。将日期转换为字符串

示例日期：

40.7.1。随着时间的推移

Date.prototype.toTimeString()（当地时区）
Date.prototype.toLocaleTimeString()（参见 ECMAScript 国际化 API ）

40.7.2。带日期的字符串

Date.prototype.toDateString()（当地时区）
Date.prototype.toLocaleDateString()（ ECMAScript 国际化 API ）

40.7.3。带有日期和时间的字符串

Date.prototype.toString()（当地时区）
Date.prototype.toLocaleString()（参见 ECMAScript 国际化 API ）
Date.prototype.toUTCString()（UTC）
Date.prototype.toISOString()（UTC）

练习：创建日期字符串

exercises/dates/create_date_string_test.js

40.8。 Date API 的陷阱

您无法指定本地时区。如果您不小心，这可能会导致特定于位置的错误。例如，以下交互会导致不同的结果，具体取决于执行的位置。我们在 CET 中执行它，这就是为什么 ISO 字符串（UTC）具有不同的一天（26 对 27）。
1 月是 0，2 月是 1，等等：
多年y0≤y≤99，增加了 1900：