Skip to content

JavaScript Date API

JavaScript Date 方法,用于读取和格式化日期与时间。

1 class · 7 methods

Date

7 methods

表示时间中的单个时刻(自 Unix 纪元以来的毫秒数)。

date.getDate()

返回本地时间中的月份中的日期(1..31)。

Returns

number

Example

javascript
new Date('2024-06-15').getDate()  // 15
date.getMonth()

返回本地时间中的月份(0..11,其中 0 = 一月)。

Returns

number

Example

javascript
new Date('2024-06-15').getMonth()  // 5 (June)
date.getFullYear()

返回本地时间中的 4 位年份。

Returns

number

Example

javascript
new Date('2024-06-15').getFullYear()  // 2024
date.toISOString()

返回 ISO 8601 格式(UTC)的日期:YYYY-MM-DDTHH:mm:ss.sssZ。

Returns

string

Example

javascript
new Date('2024-06-15T12:00:00Z').toISOString()
// '2024-06-15T12:00:00.000Z'
date.toLocaleDateString(locale?, options?)

返回对语言敏感的日期表示字符串。

Parameters

NameTypeDescription
localestring | string[]BCP 47 语言环境标签(例如 'en-US')。
optionsobject格式化选项。

Returns

string

Example

javascript
new Date(2024, 5, 15).toLocaleDateString('en-US')
// '6/15/2024'
new Date(2024, 5, 15).toLocaleDateString('zh-CN')
// '2024/6/15'
Date.now()

静态方法。返回自 Unix 纪元以来经过的毫秒数。

Returns

number

Example

javascript
Date.now()  // e.g. 1718452800000
const start = Date.now();
// ... do work ...
console.log(Date.now() - start, 'ms');
Date.parse(dateString)

静态方法。解析日期字符串并返回自纪元以来的毫秒数,或 NaN。

Parameters

NameTypeDescription
dateStringstring日期字符串(推荐使用 ISO 8601)。

Returns

number

Example

javascript
Date.parse('2024-06-15T00:00:00Z')  // 1718409600000
Date.parse('not a date')            // NaN