JavaScript 日期權威指南

發表於2018-09-05

JavaScript

簡介

JavaScript通過強大的物件為我們提供日期處理功能：日期。

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

Date物件

Date物件例項表示單個時間點。

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

初始化Date物件

我們使用初始化Date物件

new Date()

1	new Date()

這將建立一個指向當前時刻的Date物件。

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

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

重要：UNIX時間戳的原因以秒為單位。JavaScript以毫秒為單位記錄原因。

如果我們有UNIX時間戳，我們可以使用例項化JavaScript Date物件

const timestamp = 1530826365
new Date(timestamp * 1000)

1 2	const timestamp = 1530826365 new Date(timestamp * 1000)

如果我們傳遞0，我們將得到一個Date物件，表示1970年1月1日（UTC）的時間：

new Date(0)

1	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

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('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)

1 2	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)

1 2	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)')

1 2	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

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物件的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

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.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)

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)

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()

1	Date.now()

代替

new Date().getTime()

1	new Date().getTime()

JavaScript 關於日期的容錯處理

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

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

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（）。

以下是如何使用它。

根據計算機預設區域設定格式化日期：

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

// "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"

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 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
}

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）重置時間。

[譯] JAVASCRIPT 日期權威指南
2018-09-14
JavaScript
JavaScript權威指南（6）——物件
2019-07-24
JavaScript物件
javascript權威指南——函式篇
2018-12-18
JavaScript函式
JavaScript權威指南（8）——函式
2019-08-07
JavaScript函式
JavaScript權威指南（7）——陣列
2019-08-02
JavaScript陣列
JavaScript權威指南（9）——類和模組
2019-08-19
JavaScript
JavaScript權威指南（2）——詞法結構
2019-07-20
JavaScript
JavaScript權威指南（11）——JavaScript的子集和擴充套件
2019-10-08
JavaScript套件
JavaScript權威指南（4）——表示式和運算子
2019-07-20
JavaScript
JavaScript 權威指南第七版（GPT 重譯）（一）
2024-03-22
JavaScriptGPT
JavaScript 權威指南第七版（GPT 重譯）（二）
2024-03-22
JavaScriptGPT
JavaScript 權威指南第七版（GPT 重譯）（三）
2024-03-22
JavaScriptGPT
JavaScript 權威指南第七版（GPT 重譯）（四）
2024-03-22
JavaScriptGPT
JavaScript 權威指南第七版（GPT 重譯）（五）
2024-03-22
JavaScriptGPT
JavaScript權威指南（10）——正規表示式的模式匹配
2019-09-17
JavaScript模式
Java 13權威指南 - CodeFX
2019-09-20
Java
Elasticsearch 權威指南（中文版）
2019-01-26
Elasticsearch
HBase權威指南【中文版】
2018-07-16
微服務入門權威指南
2018-03-20
微服務
《Excelize 權威指南》新書釋出
2024-08-03
Excelize新書
《Android Gradle權威指南》之Gradle入門
2019-03-04
AndroidGradle
《IDA pro權威指南》閱讀筆記
2024-10-04
筆記
留學指南權威乾貨與攻略！
2022-01-20
HTML5權威指南——CSS的長度
2020-10-23
HTMLCSS
Hadoop權威指南第4章關於YARN
2020-10-21
HadoopYarn
Elasticsearch搜尋調優權威指南（1/3）
2019-06-20
Elasticsearch
表格儲存Tablestore權威指南（持續更新）
2019-05-05
Elasticsearch搜尋調優權威指南（2/3）
2019-07-04
Elasticsearch
【Kafka】《Kafka權威指南》——提交和偏移量
2019-06-06
Kafka
Netty權威指南：Java的I/O演進
2021-04-06
NettyJava
HTML5權威指南 12.WebRTC通訊
2020-04-05
HTMLWeb
Netty權威指南：I/O 多路複用技術
2021-04-05
Netty
《Spring Batch 權威指南》之“批處理和 Spring”
2021-02-02
SpringBAT
Oracle Database 12cR2多租戶權威指南
2018-10-24
OracleDatabase
Kubernetes權威指南第一章：Kubernetes入門
2019-12-05
讀書筆記【JS 權威指南】14.1 計時器
2019-08-03
筆記JS
《MongoDB權威指南》迷你書連載一－入門篇
2020-04-07
MongoDB
Netty權威指南：Linux網路 I/O 模型簡介
2021-04-02
NettyLinux模型

JavaScript 日期權威指南

簡介

Date物件

初始化Date物件

時區

日期轉換和格式設定

Date物件的getter方法

編輯日期

獲取當前時間戳

JavaScript 關於日期的容錯處理

根據區域設定格式化日期

比較兩個日期

相關文章