JavaScript 日期权威指南

作者  | _小生_

来源 | segmentfault.com/a/1190000016098130

 

简介

JavaScript通过强大的对象为我们提供日期处理功能：日期。

本文确实不是谈论Moment.js，我认为它是处理日期的最佳库，你应该在处理日期时几乎总是使用它。

Date对象

Date对象实例表示单个时间点。

尽管被命名为Date，它也处理时间。

初始化Date对象

我们使用初始化Date对象：

1. new Date()

这将创建一个指向当前时刻的Date对象。

在内部，日期以1970年1月1日（UTC）以来的毫秒数表示。这个日期很重要，因为就计算机而言，这就是一切开始的地方。

您可能熟悉UNIX时间戳：它表示自该着名日期以来经过的seconds数。

重要：UNIX时间戳的原因以秒为单位。JavaScript以毫秒为单位记录原因。

如果我们有UNIX时间戳，我们可以使用实例化JavaScript Date对象：

1. const timestamp = 1530826365

2. new Date(timestamp * 1000)

如果我们传递0，我们将得到一个Date对象，表示1970年1月1日（UTC）的时间：

1. new Date(0)

如果我们传递一个字符串而不是一个数字，那么Date对象使用parse方法来确定您传递的日期。例子：

1. new Date('2018-07-22')

2. new Date('2018-07') //July 1st 2018, 00:00:00

3. new Date('2018') //Jan 1st 2018, 00:00:00

4. new Date('07/22/2018')

5. new Date('2018/07/22')

6. new Date('2018/7/22')

7. new Date('July 22, 2018')

8. new Date('July 22, 2018 07:22:13')

9. new Date('2018-07-22 07:22:13')

10. new Date('2018-07-22T07:22:13')

11. new Date('25 March 2018')

12. new Date('25 Mar 2018')

13. new Date('25 March, 2018')

14. new Date('March 25, 2018')

15. new Date('March 25 2018')

16. new Date('March 2018') //Mar 1st 2018, 00:00:00

17. new Date('2018 March') //Mar 1st 2018, 00:00:00

18. new Date('2018 MARCH') //Mar 1st 2018, 00:00:00

19. new Date('2018 march') //Mar 1st 2018, 00:00:00

这里有很多灵活性。您可以在几个月或几天内添加或省略前导零。

小心月/日的位置，或者你可能最终将月份误解为当天。

你也可以使用Date.parse：

1. Date.parse('2018-07-22')

2. Date.parse('2018-07') //July 1st 2018, 00:00:00

3. Date.parse('2018') //Jan 1st 2018, 00:00:00

4. Date.parse('07/22/2018')

5. Date.parse('2018/07/22')

6. Date.parse('2018/7/22')

7. Date.parse('July 22, 2018')

8. Date.parse('July 22, 2018 07:22:13')

9. Date.parse('2018-07-22 07:22:13')

10. Date.parse('2018-07-22T07:22:13')

Date.parse将返回一个时间戳（以毫秒为单位）而不是Date对象。

您还可以传递一组代表日期各部分的有序值：年，月（从0开始），日，小时，分钟，秒和毫秒：

1. new Date(2018, 6, 22, 7, 22, 13, 0)

2. new Date(2018, 6, 22)

最小值应该是3个参数，但是大多数JavaScript引擎的解释都比这些少：

1. new Date(2018, 6) //Sun Jul 01 2018 00:00:00 GMT+0200 (Central European Summer Time)

2. new Date(2018) //Thu Jan 01 1970 01:00:02 GMT+0100 (Central European Standard Time)

在任何这些情况下，生成的日期都相对于计算机的时区。这意味着两台不同的计算机可能会为同一日期对象输出不同的值。

JavaScript没有任何关于时区的信息，会将日期视为UTC，并自动执行到当前计算机时区的转换。

因此，总结一下，您可以通过4种方式创建新的Date对象：

• 不传参数，创建一个表示“现在”的Date对象

• 传递number，表示从格林威治标准时间1970年1月1日00:00开始的毫秒数

• 传递一个字符串，代表一个日期

• 传递一组参数，它们代表日期的不同部分

时区

初始化日期时，您可以传递时区，因此日期不会被假定为UTC，然后转换为您当地的时区。

您可以通过以+ HOURS格式添加时区来指定时区，或者通过添加括在括号中的时区名称来指定时区：

1. new Date('July 22, 2018 07:22:13 +0700')

2. new Date('July 22, 2018 07:22:13 (CET)')

如果在括号中指定了错误的时区名称，则JavaScript将默认为UTC而不会报错。

如果您指定了错误的数字格式，JavaScript将报“无效日期”的错误。

日期转换和格式设置

给定Date对象，有很多方法将从该日期生成一个字符串：

1. const date = new Date('July 22, 2018 07:22:13')

2.  

3. date.toString() // "Sun Jul 22 2018 07:22:13 GMT+0200 (Central European Summer Time)"

4. date.toTimeString() //"07:22:13 GMT+0200 (Central European Summer Time)"

5. date.toUTCString() //"Sun, 22 Jul 2018 05:22:13 GMT"

6. date.toDateString() //"Sun Jul 22 2018"

7. date.toISOString() //"2018-07-22T05:22:13.000Z" (ISO 8601 format)

8. date.toLocaleString() //"22/07/2018, 07:22:13"

9. date.toLocaleTimeString()    //"07:22:13"

10. date.getTime() //1532236933000

11. date.getTime() //1532236933000

Date对象的getter方法

Date对象提供了几种检查其值的方法。这些都取决于计算机的当前时区：

1. const date = new Date('July 22, 2018 07:22:13')

2.  

3. date.getDate() //22

4. date.getDay() //0 (0 means sunday, 1 means monday..)

5. date.getFullYear() //2018

6. date.getMonth() //6 (starts from 0)

7. date.getHours() //7

8. date.getMinutes() //22

9. date.getSeconds() //13

10. date.getMilliseconds() //0 (not specified)

11. date.getTime() //1532236933000

12. date.getTimezoneOffset() //-120 (will vary depending on where you are and when you check - this is CET during the summer). Returns the timezone difference expressed in minutes

这些方法有等效的UTC版本，它们返回UTC值而不是适合您当前时区的值：

1. date.getUTCDate() //22

2. date.getUTCDay() //0 (0 means sunday, 1 means monday..)

3. date.getUTCFullYear() //2018

4. date.getUTCMonth() //6 (starts from 0)

5. date.getUTCHours() //5 (not 7 like above)

6. date.getUTCMinutes() //22

7. date.getUTCSeconds() //13

8. date.getUTCMilliseconds() //0 (not specified)

编辑日期

Date对象提供了几种编辑日期值的方法：

1. const date = new Date('July 22, 2018 07:22:13')

2.  

3. date.setDate(newValue)

4. date.setDay(newValue)

5. date.setFullYear(newValue) //note: avoid setYear(), it's deprecated

6. date.setMonth(newValue)

7. date.setHours(newValue)

8. date.setMinutes(newValue)

9. date.setSeconds(newValue)

10. date.setMilliseconds(newValue)

11. date.setTime(newValue)

12. date.setTimezoneOffset(newValue)

setDay和setMonth从0开始编号，因此例如March是2月。

你可以在setHours（）中添加多个参数来设置分钟，秒和毫秒：setHours（0,0,0,0） - 这同样适用于setMinutes和setSeconds。

至于get，set方法也有UTC等价物：

1. const date = new Date('July 22, 2018 07:22:13')

2.  

3. date.setUTCDate(newalue)

4. date.setUTCDay(newValue)

5. date.setUTCFullYear(newValue)

6. date.setUTCMonth(newValue)

7. date.setUTCHours(newValue)

8. date.setUTCMinutes(newValue)

9. date.setUTCSeconds(newValue)

10. date.setUTCMilliseconds(newValue)

获取当前时间戳

如果要以毫秒为单位获取当前时间戳，可以使用速记

1. Date.now()

代替

1. new Date().getTime()

JavaScript 关于日期的容错处理

请注意。如果您使用天数计算超过一个月，则不会出现错误，日期将转到下个月：

1. new Date(2018, 6, 40) //Thu Aug 09 2018 00:00:00 GMT+0200 (Central European Summer Time)

数月，小时，分钟，秒和毫秒都是如此。

根据区域设置格式化日期

现代浏览器中的支持良好国际化API（值得注意的例外：UC浏览器）允许您翻译日期。

它是由Intl Object 暴露出来的，这也有助于本地化数字，字符串。

我来看看Intl.DateTimeFormat（）。

以下是如何使用它。

根据计算机默认区域设置格式化日期：

1. // "12/22/2017"

2. const date = new Date('July 22, 2018 07:22:13')

3. new Intl.DateTimeFormat().format(date) //"22/07/2018" in my locale

根据不同的区域设置格式化日期：

1. new Intl.DateTimeFormat('en-US').format(date) //"7/22/2018"

2.  

3. Intl.DateTimeFormat方法采用可选参数，允许您自定义输出显示小时，分钟和秒：

4.  

5. const options = {

6.  year: 'numeric',

7.  month: 'numeric',

8.  day: 'numeric',

9.  hour: 'numeric',

10.  minute: 'numeric',

11.  second: 'numeric'

12. }

13.  

14. new Intl.DateTimeFormat('en-US', options).format(date) //"7/22/2018, 7:22:13 AM"

15. new Intl.DateTimeFormat('it-IT', options2).format(date) //"22/7/2018, 07:22:13"

这里是您可以使用的所有属性的参考。

比较两个日期

您可以使用Date.getTime（）计算两个日期之间的差异：

1. const date1 = new Date('July 10, 2018 07:22:13')

2. const date2 = new Date('July 22, 2018 07:22:13')

3. const diff = date2.getTime() - date1.getTime() //difference in milliseconds

以同样的方式，您可以检查两个日期是否相等：

1. const date1 = new Date('July 10, 2018 07:22:13')

2. const date2 = new Date('July 10, 2018 07:22:13')

3. if (date2.getTime() === date1.getTime()) {

4.  //dates are equal

5. }

请记住，getTime（）返回的毫秒数，因此您需要在比较中考虑时间因素。2018年7月10日07:22:13 不等于2018年7月10日。在这种情况下，您可以使用setHours（0,0,0,0）重置时间。