Date

Создание

dateObj = new Date()
dateObj = new Date(dateVal)
dateObj = new Date(year, month, date[, hours, minutes, seconds, ms] )

Аргументы

dateVal
  • Если параметр является числовым, то он интерпретируется как количество миллисекунд от 1-Янв-1970 00:00.
  • Если строкой, то она разбирается и интерпретируется как дата по стандартным правилам Date.parse.
year
Год в формате YYYY.
month
Месяц от 0 (Янв) до 11 (Дек).
date
День месяца от 1 до 31.
hours
Параметр должен быть указан, если указан параметр minutes. Устанавливает кол-во часов от 0 до 23.
minutes
Параметр должен быть указан, если указан параметр seconds. Устанавливает количество минут: от 0 до 59.
seconds
Параметр должен быть указан, если указан параметр ms. Устанавливает количество секунд: от 0 до 59.
ms
Количество миллисекунд: от 0 до 999.

Дата измеряется в миллисекундах, начиная от полуночи 01 января 1970 года GMT+0. День содержит 86,400,000 миллисекунд.

Объект Date ведет себя одинаково на всех платформах.

Date поддерживает как методы для работы в зоне UTC (GMT+0), так и методы для работы с местным временем.
Местное время - это то, которое установлено на компьютере, на котором выполняется яваскрипт.


Описание, примеры

Если конструктор запущен без аргументов, то возвращается текущая дата.

Пример: получить текущую дату
var today = new Date()

При вызове с одним аргументов - строкой, строка разбирается и интерпретируется как дата, так же, как и в методе Date.parse.

Пример: создать дату из строки
var date = new Date("21 May 1958 10:12") // используется редко

При объявлении с несколькими аргументами, отсутствующие аргументы автоматически считаются равными 0.

Пример: объявление даты с несколькими аргументами
Выделить все
new Date(1)
// Thu Jan 01 1970 03:00:00 GMT+0300 (Russian Standard Time)
new Date(1,2)
// Fri Mar 01 1901 00:00:00 GMT+0300 (Russian Standard Time)
new Date(1,2,3)
// Sun Mar 03 1901 00:00:00 GMT+0300 (Russian Standard Time)
new Date(1,2,3,4)
// Sun Mar 03 1901 04:00:00 GMT+0300 (Russian Standard Time)
new Date(1,2,3,4,5)
//Sun Mar 03 1901 04:05:00 GMT+0300 (Russian Standard Time)
new Date(1,2,3,4,5,6)
//Sun Mar 03 1901 04:05:06 GMT+0300 (Russian Standard Time)

Методы

Date.UTC
Вычисляет количество миллисекунд, истекших с полуночи 1 января 1970 года до указанной даты, используя время в диапазоне формата UTC.
Date.parse
Анализирует строку, содержащую дату, и возвращает количество миллисекунд, прошедших с полуночи 1 января 1970 г. UTC до указанной даты.
toLocaleString
Возвращает дату, преобразованную в строковую величину в соответствии с текущими локальными установками.
getDate
Возвращает день месяца для указанной даты (согласно местному времени)
getDay
Возвращает день недели для указанной даты (согласно местному времени)
getFullYear
Возвращает год для указанной даты (согласно местному времени)
getMilliseconds
Возвращает количество миллисекунд для указанной даты (согласно местному времени)
getMinutes
Возвращает значение минут для указанной даты (согласно местному времени)
getMonth
Возвращает месяц для указанной даты (согласно местному времени)
getSeconds
Возвращает значение секунд для указанной даты (согласно местному времени)
getTime
Возвращает численное значение для указанной даты (согласно универсальному времени)
getTimezoneOffset
Возвращает смещение универсального времени относительно местного в минутах
getUTCDate
Возвращает день месяца для указанной даты (согласно универсальному времени)
getUTCDay
Возвращает день недели для указанной даты (согласно универсальному времени)
getUTCHours
Возвращает час для указанной даты (согласно универсальному времени)
getHours
Возвращает час для указанной даты (согласно местному времени)
getUTCMilliseconds
Возвращает количество миллисекунд для указанной даты (согласно универсальному времени)
getUTCMonth
Возвращает месяц для указанной даты (согласно универсальному времени)
getUTCMinutes
Возвращает значение минут для указанной даты (согласно универсальному времени)
getUTCSeconds
Возвращает значение секунд для указанной даты (согласно универсальному времени)
getYear
Возвращает сокращённое значение года для указанной даты (согласно местному времени)
setSeconds
Устанавливает для указанной даты значение секунд равным указанному (согласно местному времени)
setFullYear
Устанавливает для указанной даты год равным указанному значению (согласно местному времени)
setMilliseconds
Устанавливает для указанной даты значение миллисекунд равным указанному (согласно местному времени)
setTime
Устанавливает численное значение для указанной даты в миллисекундах, прошедших после полночи 1 января 1970 года (по универсальному времени)
setYear
Устанавливает для указанной даты год равным указанному значению (согласно местному времени)
setDate
Устанавливает день месяца равным указанному значению (согласно местному времени)
setUTCDate
Устанавливает день месяца равным указанному значению (согласно местному времени)
setUTCHours
Устанавливает для указанной даты час равным указанному значению (согласно универсальному времени)
setHours
Устанавливает для указанной даты час равным указанному значению (согласно местному времени)
setUTCMilliseconds
Устанавливает для указанной даты значение миллисекунд равным указанному (согласно местному времени)
setUTCMinutes
Устанавливает для указанной даты значение минут равным указанному (согласно универсальному времени)
setMinutes
Устанавливает для указанной даты значение минут равным указанному (согласно местному времени)
setMonth
Устанавливает для указанной даты месяц равным указанному значению (согласно местному времени)
setUTCSeconds
Устанавливает для указанной даты значение секунд равным указанному (согласно местному времени)
setUTCFullYear
Устанавливает для указанной даты год равным указанному значению (согласно универсальному времени)
setUTCMonth
Устанавливает для указанной даты месяц равным указанному значению (согласно местному времени)
toGMTString
Преобразовывает дату в строку (согласно времени по Гринвичу)
toLocaleFormat
Преобразовывает дату в строку согласно текущим языковым настройкам и указанному формату
toLocaleTimeString
Возвращает информацию о дате в виде текстовой строки согласно языковым настройкам системы
toLocaleDateString
Возвращает информацию о дате в виде текстовой строки согласно языковым настройкам системы
toString
Возвращает строку, представляющую текущий объект Date.
toTimeString
Возвращает информацию о дате в виде текстовой строки в американском формате записи даты
toDateString
Возвращает информацию о дате в виде текстовой строки в американском формате записи даты
toUTCString
Преобразовывает дату в строку (согласно универсальному времени)
valueOf
Возвращает примитивное значение объекта Date
getUTCFullYear
Возвращает год для указанной даты (согласно универсальному времени)

См. также