摘要：對象對象實例表示單個時間點盡管名為它同樣被用來處理時間。在內部日期表示自年月日起到現(xiàn)在的毫秒數(shù)。這意味著傳入相同的參數(shù)在不同電腦上可能會有不同的結果。在沒有任何有關時區(qū)的信息的情況下會將日期視為結果會自動針對當前的計算機時區(qū)進行轉換。

在 JavaScript 中處理日期可能會很復雜，我們一起學習 Dates 所有的怪癖并掌握如何使用它。

在 JavaScript 中處理日期可能會很復雜，無論開發(fā)者技術如何，往往都會感到痛苦。

JavaScript 通過一個強大的Date對象對我們提供了日期處理功能。

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

盡管名為 Date, 它同樣被用來處理時間。

我們通過下述代碼初始化一個 Date 對象：

new Date()

上述代碼創(chuàng)建了一個表征當前時刻的日期對象。

在內部, 日期表示自 1970年1月1日 (UTC) 起到現(xiàn)在的毫秒數(shù) 。這個時間很重要, 因為就計算機而言, 這是其起始之時。

您可能熟悉 UNIX 時間戳: 這表示自該著名日期以來過去的秒數(shù)。

注意 UNIX 時間戳 以秒為單位，JavaScript 日期以 毫秒為單位

如果我們有一個 UNIX 時間戳，我們可以通過下述方法初始化一個 JavaScript 日期對象：

const timestamp = 1530826365
new Date(timestamp * 1000)

如果我們傳入的是0，我們將會獲得表示 Jan 1st 1970 (UTC) 這個時間點的日期。

new Date(0)

如果我們傳入的是一個字符串而非一個數(shù)值，那么 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") // 在 Safari11.1.2 上不能識別
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

這里很靈活。您可以在月份或天數(shù)內添加或省略前導零.

需要注意 月/日 的位置，否則可能會把月份解析為日期。

使用 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 對象

你還可以按照順序傳入值來表示日期的每一部分，參數(shù)順序如下：年份，月份（從0開始），日期，小時，分鐘，秒，毫秒

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

最少需要傳入三個參數(shù)，不過大多 JavaScript 引擎也可以解析少于 三個參數(shù)的情況

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)

上述代碼的最終結果是依賴于你的電腦的時區(qū)的相對值。這意味著傳入相同的參數(shù)在不同電腦上可能會有不同的結果。

JavaScript 在沒有任何有關時區(qū)的信息的情況下, 會將日期視為 UTC, 結果會自動針對當前的計算機時區(qū)進行轉換。

總結一下，有四種方法可以讓你創(chuàng)建一個新的 Date 對象：

不傳參數(shù)，會基于當前時間創(chuàng)建 Date 對象；

傳入代表自 1 Jan 1970 00:00 GMT 過去的毫秒數(shù)的數(shù)值；

傳入代表日期的字符串；

傳入一系列分別代表各項的參數(shù)；

初始化日期時, 您也可以傳入時區(qū), 此時日期不假定為 UTC, 然后轉換為本地時區(qū)。

可以通過 +HPURS 格式 或者添加時區(qū)名稱的方式傳入時區(qū)。

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

如果在解析時傳入了錯誤的時區(qū)名稱，JavaScript 會默認使用 UTC 并不會報錯。

如果傳入了錯誤格式的數(shù)值，JavaScript會報 Invaild 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 對象提供了幾種檢查其值的方法。這些方法的結果都都取決于計算機的當前時區(qū)

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 時間的版本：

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 都從數(shù)值 0 開始 處理，比如三月應該為數(shù)值 2

這里有一個冷知識: 這些方法會 “重疊”, 所以比如說如果你使用了 date.setHours (48), 結果會影響到天。

還有一個冷知識，你可以為 setHours() 方法傳入多個參數(shù)，用以設置分鐘，秒，毫秒，如setHours(0, 0, 0, 0), setMinutes 和 setSeconds 存在類似的情況。

類似于眾多獲取日期的方法一樣，設置日期的方法也存在對于的 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()

上面已經提到過，你傳入的天數(shù)會影響到總的日期，這不會報錯，會直接更新月份

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

上述現(xiàn)象在日期，小時，分鐘，秒以及毫秒同樣生效

Internationalization API 在現(xiàn)代瀏覽器中有很好的支持(除了 UC瀏覽器)，允許你轉換日期。

本地化方法通過，通過 Int1 對象暴露，這個對象還可以用來幫助本地化數(shù)值，字符串以及貨幣。

這里我們用到的是 Intl.DateTimeFormat()

我們可以通過下述方法來依據(jù)電腦的本地情況格式化一個日期：

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

也可以依據(jù)不同的時區(qū)格式化日期：

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

Intl.DateTimeFormat 方法還接收一個可選的參數(shù)用以自定義輸出格式，可以用來展示 小時，分鐘和秒

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 date2 = new Date("July 10, 2018 07:22:13")
if (date2.getTime() === date1.getTime()) {
  //dates are equal
}

需要注意的是，getTime() 方法比較的是毫秒，所以 July 10, 2018 07:22:13 和 July 10, 2018 并不相等。不過你可以通過 setHours(0, 0, 0, 0) 來重置時間。

原文地址：The definitive guide to JavaScript Dates

本文在 GitHub 上的地址