38. 日期

• Moment.js
• Day.js
• Luxon
• js-joda
• date-fns

• Tree-shaking 可以帮助减少库的大小，是一种仅将库的导出部署到Web服务器的技术，可以在某处导入。Tree-shaking对函数的影响比类更大。
• 支持时区：Date对象默认不支持时区，这会带来一些问题并且这是一个关键的弱点。确保您的日期库支持时区。

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

• UTC（协调世界时）
• 本地时区（从操作系统自动获取）

new Date(2077, 0, 27).toISOString()
'2077-01-26T23:00:00.000Z'

日期操作：UTC与本地时区

对于本章中记录的每个操作，它在日期和其他数据之间进行转换，请注意是使用UTC还是本地时区。

• 无法支持多个时区。
• 可能导致特定位置的bug。例如，前面的示例会根据执行的位置生成不同的结果。在这种特殊情况下，输入为CET，而输出则是UTC。这就是为什么这个月的日期不同（27对26）。

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

'2033-05-28T15:59:59.123Z'

• 日期格式：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

• +hh:mm
• -hh:mm

• 时间值 表示自 1970 年 1 月 1 日 00:00:00 UTC 以来的毫秒数的日期。时间值可用于创建日期：

  const timeValue = 0;
  assert.equal(
    new Date(timeValue).toISOString(),
    '1970-01-01T00:00:00.000Z');
  

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

  > Number(new Date(123))
  123
  

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

  assert.equal(new Date('1972-05-03') < new Date('2001-12-23'), true);
  // Internally:
  assert.equal(73699200000 < 1009065600000, true);
  

• Date.now(): number 返回当前时间作为时间值。
• Date.parse(dateTimeString): number（当地时区） 解析dateTimeString并返回相应的时间值。
• Date.UTC(year, month, date?, hours?, minutes?, seconds?, milliseconds?): number 返回指定的 UTC 日期时间的时间值。

• Date.prototype.getTime(): number 返回与 Date 对应的时间值。
• Date.prototype.setTime(timeValue) 将this设置为timeValue编码的日期。

• new Date(year: number, month: number, date?: number, hours?: number, minutes?: number, seconds?: number, milliseconds?: number)（当地时区）

  > new Date(2077,0,27, 21,49,58, 888).toISOString() // CET (UTC+1)
  '2077-01-27T20:49:58.888Z'
  

• new Date(dateTimeStr: string)（UTC）

  > new Date('2077-01-27').toISOString()
  '2077-01-27T00:00:00.000Z'
  

• new Date(timeValue: number)

  > new Date(0).toISOString()
  '1970-01-01T00:00:00.000Z'
  

• new Date()（与new Date(Date.now())相同）

• 对于month，0是一月
• 如果0≤year≤99，则为1900+yaer

  > new Date(12, 1, 22, 19, 11).getFullYear()
  1912
  

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

• 当地时间：
  • 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。

• 示例日期：

  const d = new Date(0);
  

• Date.prototype.toTimeString()（当地时区）

  > d.toTimeString()
  '01:00:00 GMT+0100 (Central European Standard Time)'
  

• Date.prototype.toLocaleTimeString()

• Date.prototype.toDateString()（当地时区）

  > d.toDateString()
  'Thu Jan 01 1970'
  

• Date.prototype.toLocaleDateString()

• Date.prototype.toString()（当地时区）

  > d.toString()
  'Thu Jan 01 1970 01:00:00 GMT+0100 (Central European Standard Time)
  

• Date.prototype.toLocaleString()
• Date.prototype.toUTCString()（UTC）

  > d.toUTCString()
  'Thu, 01 Jan 1970 00:00:00 GMT'
  

• Date.prototype.toISOString()（UTC）

  > d.toISOString()
  '1970-01-01T00:00:00.000Z'
  

练习：创建日期字符串

exercises/dates/create_date_string_test.js