JavaScript 日期權威指南

簡介

JavaScript經過強大的對象爲咱們提供日期處理功能：日期。

本文確實_不是_談論 Moment.js ，我認爲它是處理日期的最佳庫，你應該在處理日期時幾乎老是使用它。

Date對象

Date對象實例表示單個時間點。

儘管被命名爲Date，它也處理時間。

初始化Date對象

咱們使用初始化Date對象

new Date()

這將建立一個指向當前時刻的Date對象。

在內部，日期以1970年1月1日（UTC）以來的毫秒數表示。這個日期很重要，由於就計算機而言，這就是一切開始的地方。

您可能熟悉UNIX時間戳：它表示自該着名日期以來通過的seconds數。

重要：UNIX時間戳的緣由以秒爲單位。JavaScript以毫秒爲單位記錄緣由。

若是咱們有UNIX時間戳，咱們能夠使用實例化JavaScript Date對象

const timestamp = 1530826365
new Date(timestamp * 1000)

若是咱們傳遞0，咱們將獲得一個Date對象，表示1970年1月1日（UTC）的時間：

new Date(0)

若是咱們傳遞一個字符串而不是一個數字，那麼Date對象使用parse方法來肯定您傳遞的日期。例子：

new Date('2018-07-22')
new Date('2018-07') //July 1st 2018, 00:00:00
new Date('2018') //Jan 1st 2018, 00:00:00
new Date('07/22/2018')
new Date('2018/07/22')
new Date('2018/7/22')
new Date('July 22, 2018')
new Date('July 22, 2018 07:22:13')
new Date('2018-07-22 07:22:13')
new Date('2018-07-22T07:22:13')
new Date('25 March 2018')
new Date('25 Mar 2018')
new Date('25 March, 2018')
new Date('March 25, 2018')
new Date('March 25 2018')
new Date('March 2018') //Mar 1st 2018, 00:00:00
new Date('2018 March') //Mar 1st 2018, 00:00:00
new Date('2018 MARCH') //Mar 1st 2018, 00:00:00
new Date('2018 march') //Mar 1st 2018, 00:00:00

這裏有不少靈活性。您能夠在幾個月或幾天內添加或省略前導零。

當心月/日的位置，或者你可能最終將月份誤解爲當天。

你也能夠使用Date.parse：

Date.parse('2018-07-22')
Date.parse('2018-07') //July 1st 2018, 00:00:00
Date.parse('2018') //Jan 1st 2018, 00:00:00
Date.parse('07/22/2018')
Date.parse('2018/07/22')
Date.parse('2018/7/22')
Date.parse('July 22, 2018')
Date.parse('July 22, 2018 07:22:13')
Date.parse('2018-07-22 07:22:13')
Date.parse('2018-07-22T07:22:13')

Date.parse將返回一個時間戳（以毫秒爲單位）而不是Date對象。

您還能夠傳遞一組表明日期各部分的有序值：年，月（從0開始），日，小時，分鐘，秒和毫秒：

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

最小值應該是3個參數，可是大多數JavaScript引擎的解釋都比這些少：

new Date(2018, 6) //Sun Jul 01 2018 00:00:00 GMT+0200 (Central European Summer Time)
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格式添加時區來指定時區，或者經過添加括在括號中的時區名稱來指定時區：

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

若是在括號中指定了錯誤的時區名稱，則JavaScript將默認爲UTC而不會報錯。

若是您指定了錯誤的數字格式，JavaScript將報「無效日期」的錯誤。

日期轉換和格式設置

給定Date對象，有不少方法將從該日期生成一個字符串：

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

date.toString() // "Sun Jul 22 2018 07:22:13 GMT+0200 (Central European Summer Time)"
date.toTimeString() //"07:22:13 GMT+0200 (Central European Summer Time)"
date.toUTCString() //"Sun, 22 Jul 2018 05:22:13 GMT"
date.toDateString() //"Sun Jul 22 2018"
date.toISOString() //"2018-07-22T05:22:13.000Z" (ISO 8601 format)
date.toLocaleString() //"22/07/2018, 07:22:13"
date.toLocaleTimeString()    //"07:22:13"
date.getTime() //1532236933000
date.getTime() //1532236933000

Date對象的getter方法

Date對象提供了幾種檢查其值的方法。這些都取決於計算機的當前時區：

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

date.getDate() //22
date.getDay() //0 (0 means sunday, 1 means monday..)
date.getFullYear() //2018
date.getMonth() //6 (starts from 0)
date.getHours() //7
date.getMinutes() //22
date.getSeconds() //13
date.getMilliseconds() //0 (not specified)
date.getTime() //1532236933000
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值而不是適合您當前時區的值：

date.getUTCDate() //22
date.getUTCDay() //0 (0 means sunday, 1 means monday..)
date.getUTCFullYear() //2018
date.getUTCMonth() //6 (starts from 0)
date.getUTCHours() //5 (not 7 like above)
date.getUTCMinutes() //22
date.getUTCSeconds() //13
date.getUTCMilliseconds() //0 (not specified)

編輯日期

Date對象提供了幾種編輯日期值的方法：

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

date.setDate(newValue)
date.setDay(newValue)
date.setFullYear(newValue) //note: avoid setYear(), it's deprecated
date.setMonth(newValue)
date.setHours(newValue)
date.setMinutes(newValue)
date.setSeconds(newValue)
date.setMilliseconds(newValue)
date.setTime(newValue)
date.setTimezoneOffset(newValue)

setDay和setMonth從0開始編號，所以例如March是2月。

你能夠在setHours（）中添加多個參數來設置分鐘，秒和毫秒：setHours（0,0,0,0） - 這一樣適用於setMinutes和setSeconds。

至於get_，set_方法也有UTC等價物：

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

date.setUTCDate(newalue)
date.setUTCDay(newValue)
date.setUTCFullYear(newValue)
date.setUTCMonth(newValue)
date.setUTCHours(newValue)
date.setUTCMinutes(newValue)
date.setUTCSeconds(newValue)
date.setUTCMilliseconds(newValue)

獲取當前時間戳

若是要以毫秒爲單位獲取當前時間戳，能夠使用速記

Date.now()

代替

new Date().getTime()

JavaScript 關於日期的容錯處理

請注意。若是您使用天數計算超過一個月，則不會出現錯誤，日期將轉到下個月：

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

數月，小時，分鐘，秒和毫秒都是如此。

根據區域設置格式化日期

現代瀏覽器中的支持良好國際化API（值得注意的例外：UC瀏覽器）容許您翻譯日期。

它是由Intl Object 暴露出來的，這也有助於本地化數字，字符串。

我來看看Intl.DateTimeFormat（）。

如下是如何使用它。

根據計算機默認區域設置格式化日期：

// "12/22/2017"
const date = new Date('July 22, 2018 07:22:13')
new Intl.DateTimeFormat().format(date) //"22/07/2018" in my locale

根據不一樣的區域設置格式化日期：

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

Intl.DateTimeFormat方法採用可選參數，容許您自定義輸出顯示小時，分鐘和秒：

const options = {
  year: 'numeric',
  month: 'numeric',
  day: 'numeric',
  hour: 'numeric',
  minute: 'numeric',
  second: 'numeric'
}

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

這裏是您能夠使用的全部屬性的參考。

比較兩個日期

您能夠使用Date.getTime（）計算兩個日期之間的差別：

const date1 = new Date('July 10, 2018 07:22:13')
const date2 = new Date('July 22, 2018 07:22:13')
const diff = date2.getTime() - date1.getTime() //difference in milliseconds

以一樣的方式，您能夠檢查兩個日期是否相等：

const date1 = new Date('July 10, 2018 07:22:13')
const date2 = new Date('July 10, 2018 07:22:13')
if (date2.getTime() === date1.getTime()) {
  //dates are equal
}

請記住，getTime（）返回的毫秒數，所以您須要在比較中考慮時間因素。2018年7月10日07:22:13 不等於2018年7月10日。在這種狀況下，您能夠使用setHours（0,0,0,0）重置時間。