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

在 JavaScript 中處理日期可能會(huì)很復(fù)雜，我們一起學(xué)習(xí) Dates 所有的怪癖并掌握如何使用它。

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

JavaScript 通過(guò)一個(gè)強(qiáng)大的Date對(duì)象對(duì)我們提供了日期處理功能。

Date 對(duì)象實(shí)例表示單個(gè)時(shí)間點(diǎn).

盡管名為 Date, 它同樣被用來(lái)處理時(shí)間。

我們通過(guò)下述代碼初始化一個(gè) Date 對(duì)象：

new Date()

上述代碼創(chuàng)建了一個(gè)表征當(dāng)前時(shí)刻的日期對(duì)象。

在內(nèi)部, 日期表示自 1970年1月1日 (UTC) 起到現(xiàn)在的毫秒數(shù) 。這個(gè)時(shí)間很重要, 因?yàn)榫陀?jì)算機(jī)而言, 這是其起始之時(shí)。

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

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

如果我們有一個(gè) UNIX 時(shí)間戳，我們可以通過(guò)下述方法初始化一個(gè) JavaScript 日期對(duì)象：

const timestamp = 1530826365
new Date(timestamp * 1000)

如果我們傳入的是0，我們將會(huì)獲得表示 Jan 1st 1970 (UTC) 這個(gè)時(shí)間點(diǎn)的日期。

new Date(0)

如果我們傳入的是一個(gè)字符串而非一個(gè)數(shù)值，那么 Date 對(duì)象會(huì)使用 parse 方法來(lái)判明你傳入的究竟是哪個(gè)日期，如：

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 上不能識(shí)別
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ù)內(nèi)添加或省略前導(dǎo)零.

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

使用 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 會(huì)返回毫秒表示的時(shí)間戳而非一個(gè) Date 對(duì)象

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

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

最少需要傳入三個(gè)參數(shù)，不過(guò)大多 JavaScript 引擎也可以解析少于 三個(gè)參數(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)

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

JavaScript 在沒(méi)有任何有關(guān)時(shí)區(qū)的信息的情況下, 會(huì)將日期視為 UTC, 結(jié)果會(huì)自動(dòng)針對(duì)當(dāng)前的計(jì)算機(jī)時(shí)區(qū)進(jìn)行轉(zhuǎn)換。

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

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

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

傳入代表日期的字符串；

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

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

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

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

如果在解析時(shí)傳入了錯(cuò)誤的時(shí)區(qū)名稱，JavaScript 會(huì)默認(rèn)使用 UTC 并不會(huì)報(bào)錯(cuò)。

如果傳入了錯(cuò)誤格式的數(shù)值，JavaScript會(huì)報(bào) Invaild Date 錯(cuò)誤。

對(duì)于一個(gè)給定的日期對(duì)象，存在很多方法可以基于該日期生產(chǎn)字符串

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 對(duì)象提供了幾種檢查其值的方法。這些方法的結(jié)果都都取決于計(jì)算機(jī)的當(dāng)前時(shí)區(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

上述方法存在對(duì)應(yīng)的獲取 UTC 時(shí)間的版本：

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 對(duì)象提供了若干編輯日期值得方法

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

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

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

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

如果你想獲取以毫秒為單位的當(dāng)前時(shí)間戳，推薦使用下述方法：

Date.now()

而不是

new Date().getTime()

上面已經(jīng)提到過(guò)，你傳入的天數(shù)會(huì)影響到總的日期，這不會(huì)報(bào)錯(cuò)，會(huì)直接更新月份

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

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

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

本地化方法通過(guò)，通過(guò) Int1 對(duì)象暴露，這個(gè)對(duì)象還可以用來(lái)幫助本地化數(shù)值，字符串以及貨幣。

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

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

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

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

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

Intl.DateTimeFormat 方法還接收一個(gè)可選的參數(shù)用以自定義輸出格式，可以用來(lái)展示 小時(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"

點(diǎn)擊這個(gè)鏈接可以查看所有可以用到的屬性

可以通過(guò) Date.getTime() 獲取兩個(gè)日期之間的差別

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

同樣也可以通過(guò)這個(gè)方法檢測(cè)兩個(gè)日期是否相同：

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 并不相等。不過(guò)你可以通過(guò) setHours(0, 0, 0, 0) 來(lái)重置時(shí)間。

原文地址：The definitive guide to JavaScript Dates

本文在 GitHub 上的地址