Створює екземпляр об'єкта JavaScript Date
, який відображає єдиний момент часу у незалежному від платформи форматі. Об'єкти Date
містять число, яке відображає кількість мілісекунд від 1 січня 1970 року (UTC).
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Синтаксис
new Date() new Date(value) new Date(dateString) new Date(year, monthIndex [, day [, hours [, minutes [, seconds [, milliseconds]]]]])
Заувага: Єдиним правильним способом створити новий екземпляр об'єкта Date
є використання оператора new
. Якщо ви просто викличете безпосередньо об'єкт Date
, наприклад, так now = Date()
, то повернеться рядок, а не об'єкт Date
.
Параметри
Існують чотири основні форми конструктора Date()
:
-
Без параметрів
Коли не надано жодних параметрів, новостворений об'єкт
Date
відображає поточну дату та час на момент його створення. -
Значення часу або часова мітка
value
- Ціле число, що відображає кількість мілісекунд від 1 січня 1970 року, 00:00:00 UTC (час ECMAScript, еквівалент часу UNIX), при цьому високосні секунди ігноруються. Пам'ятайте, що більшість функцій часової мітки UNIX мають точність лише до найближчої секунди.
-
Рядок з часовою міткою
dateString
- Рядкове значення дати, надане у форматі, що розпізнається методом
Date.parse()
. (Ці формати є часовими мітками стандарту RFC 2822, що відповідають IEНF, а також рядками у варіації формату ISO8601.)Заувага: Розбір рядків дати за допомогою конструктора
Date
(та методуDate.parse()
, який працює так само) наполегливо не рекомендується через відмінності та невідповідності між переглядачами.- Підтримка формату рядків RFC 2822 є лише домовленістю.
- Підтримка форматів ISO 8601 відрізняється в тому, що рядки, які містять лише дату (наприклад,
"1970-01-01"
), сприймаються як UTC, а не як локальний формат.
-
Значення окремих компонентів дати та часу
Маючи принаймні рік та місяць, ця форма
Date()
вертає об'єктDate
, чиї значення компонентів (рік, місяць, день, години, хвилини, секунди та мілісекунди) усі взяті з наступних параметрів. Будь-яким відсутнім полям надається найменше можливе значення (1
для дня (day
) та0
для усіх інших компонентів).year
-
Ціле число, що відображає рік.
Значення з
0
по99
відповідають рокам з1900
по1999
. Усі інші значення дорівнюють вказаному року. monthIndex
- Ціле число, що відображає місяць, починаючи з
0
для січня, по11
для грудня. day
Optional- Ціле число, що відображає день місяця. За замовчуванням
1
. hours
Optional- Ціле число, що відображає значення години. За замовчуванням
0
(північ). minutes
Optional- Ціле число, що відображає значення хвилин. За замовчуванням
0
хвилин з початку години. seconds
Optional- Ціле число, що відображає значення секунд. За замовчуванням
0
секунд з початку хвилини. milliseconds
Optional- Ціле число, що відображає значення мілісекунд. За замовчуванням
0
мілісекунд з початку секунди.
Приклади
Кілька способів створити об'єкт Date
Наступні приклади демонструють кілька способів створити дати JavaScript:
Заувага: Розбір рядків дати за допомогою конструктора Date
(а також методу Date.parse
, вони еквівалентні) наполегливо не рекомендується через відмінності та невідповідності між переглядачами.
let today = new Date()
let birthday = new Date('December 17, 1995 03:24:00')
let birthday = new Date('1995-12-17T03:24:00')
let birthday = new Date(1995, 11, 17) // нумерація місяців починається з 0
let birthday = new Date(1995, 11, 17, 3, 24, 0)
Специфікації
Сумісність з веб-переглядачами
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.