может также вызываться как функция (без оператора new). При таком вызове
Date
игнорирует любые переданные аргументы и возвращает текущие дату и время.
Аргументы
миллисекунды
Количество миллисекунд между нужной датой и полночью 1 января 1970 года (UTC). Например, передав в качестве аргумента число 5000, мы создадим дату, обозначающую пять секунд после полуночи 1 января 1970 года.
строка_даты
Единственный аргумент,
задающий дату и (необязательно) время в виде строки. Строка должна иметь формат, понятный для Date.parse.
год
Год в виде четырех цифр. Например, 2001 для 2001 года. Для совместимости с более ранними реализациями JavaScript к аргументу добавляется 1900, если значение аргумента находится между 0 и 99.
месяц
Месяц, заданный в виде целого от 0 (январь) до 11 (декабрь).
день
День месяца, заданный в виде целого от 1 до 31. Обратите внимание, что наименьшее из значений этого аргумента равно 1, а остальных аргументов - 0. Необязательный аргумент.
часы
Часы, заданные в виде целого от 0 (полночь) до 23 (11 часов вечера). Необязательный аргумент.
минуты
Минуты в часах, указанные в виде целого от 0 до 59. Необязательный аргумент.
секунды
Секунды в минутах, указанные в виде целого от 0 до 59. Необязательный аргумент.
мс
Миллисекунды в секунде, указанные в виде целого от 0 до 999. Необязательный аргумент.
Методы
У объекта
Date
нет доступных для записи или чтения свойств; вместо этого доступ к значениям даты и времени выполняется через методы. Большинство методов объекта
Date
имеют две формы: одна для работы с локальным временем, другая - с универсальным временем (UTC или GMT). Если в имени метода присутствует строка «UTC», он работает с универсальным временем. Эти пары методов указываются в приведенном далее списке вместе. Например, обозначение
get[UTC]Day
относится к двум методам:
getDay
и
getUTCDay.
Методы объекта
Date
могут вызываться только для объектов типа
Date
и генерируют исключение
TypeError
, если вызывать их для объектов другого типа.
get[UTC]Date
Возвращает день месяца из объекта
Date
в соответствии с локальным или универсальным временем.
get[UTC]Day
Возвращает день недели из объекта
Date
в соответствии с локальным или универсальным временем.
get[UTC]FullYear
Возвращает год даты в полном четырехзначном формате в локальном или универсальном времени.
get[UTC]Hours
Возвращает поле часов в объекте
Date
в локальном или универсальном времени.
get[UTC]Milliseconds
Возвращает
поле миллисекунд в объекте
Date
в локальном или универсальном времени.
get[UTC]Minutes
Возвращает поле минут в объекте
Date
в локальном или универсальном времени.
get[UTC]Month
Возвращает поле месяца в объекте
Date
в локальном или универсальном времени.
get[UTC]Seconds
Возвращает поле секунд в объекте
Date
в локальном или универсальном времени.
getTime
Возвращает внутреннее представление (миллисекунды) объекта
Date
. Обратите внимание: это значение не зависит от часового пояса, следовательно, отдельный метод
getUTCTime
не нужен.
getTimezoneOffset
Возвращает разницу в минутах между локальным и универсальным представлениями даты. Обратите внимание: возвращаемое значение зависит от того, действует ли для указанной даты летнее время.
getYear
Возвращает поле года в объекте
Date
. Признан устаревшим, рекомендуется вместо него применять метод
getFullYear
.
set[UTC]Date
Устанавливает день месяца в
Date
в соответствии с локальным или универсальным временем.
set[UTC]FullYear
Устанавливает год (и, возможно, месяц и день) в
Date
в соответствии с локальным или универсальным временем.
set[UTC]Hours
Устанавливает час (и, возможно, поля минут, секунд и миллисекунд) в
Date
в соответствии с локальным или универсальным временем.
set[UTC]Milliseconds
Устанавливает поле миллисекунд в
Date
в соответствии с локальным или универсальным временем.
set[UTC]Minutes
Устанавливает поле минут (и, возможно, поля секунд и миллисекунд) в
Date
в соответствии с локальным или универсальным временем.
set[UTC]Month
Устанавливает поле месяца (и, возможно, дня месяца) в
Date
в соответствии с локальным или универсальным временем.
set[UTC]Seconds
Устанавливает поле секунд (и, возможно, поле миллисекунд) в
Date
в соответствии с локальным или универсальным временем.