СПРАВОЧНИК
Объект Date в JavaScript
Работа с датами и временем
Объект Date в JavaScript хранит момент времени как число миллисекунд, прошедших с полуночи 1 января 1970 года UTC (эпоха Unix). С его помощью создают, читают и изменяют даты и время, форматируют их для пользователя и вычисляют интервалы. В этом справочнике собраны основные способы создания объектов Date, методы-геттеры и сеттеры, средства форматирования, работа с UTC и приём для вычисления разницы между датами.
Геттеры 10
Date.prototype.getDate()
date.getDate()Возвращает день месяца по местному времени: число от 1 до 31.Date.prototype.getDay()
date.getDay()Возвращает день недели по местному времени: от 0 (воскресенье) до 6 (суббота).Date.prototype.getFullYear()
date.getFullYear()Возвращает год даты по местному времени в виде четырёхзначного числа.Date.prototype.getHours()
date.getHours()Возвращает часы по местному времени: число от 0 до 23.Date.prototype.getMilliseconds()
date.getMilliseconds()Возвращает миллисекунды по местному времени: число от 0 до 999.Date.prototype.getMinutes()
date.getMinutes()Возвращает минуты по местному времени: число от 0 до 59.Date.prototype.getMonth()
date.getMonth()Возвращает номер месяца по местному времени: от 0 (январь) до 11 (декабрь).Date.prototype.getSeconds()
date.getSeconds()Возвращает секунды по местному времени: число от 0 до 59.Date.prototype.getTime()
date.getTime()Возвращает число миллисекунд от эпохи Unix для данного объекта Date.Date.prototype.getTimezoneOffset()
date.getTimezoneOffset()Возвращает разницу между местным временем и UTC в минутах.Сеттеры 7
Date.prototype.setDate()
date.setDate(день)Устанавливает день месяца; значения вне диапазона сдвигают месяц — удобно для арифметики дат.Date.prototype.setFullYear()
date.setFullYear(год[, месяц, день])Устанавливает год (и опционально месяц и день) по местному времени, изменяя объект.Date.prototype.setHours()
date.setHours(часы[, мин, сек, мс])Устанавливает часы (и опционально минуты, секунды, мс) по местному времени.Date.prototype.setMinutes()
date.setMinutes(минуты[, сек, мс])Устанавливает минуты (и опционально секунды и мс) по местному времени.Date.prototype.setMonth()
date.setMonth(месяц[, день])Устанавливает месяц (0–11) по местному времени; при выходе за границы год пересчитывается.Date.prototype.setSeconds()
date.setSeconds(секунды[, мс])Устанавливает секунды (и опционально миллисекунды) по местному времени.Date.prototype.setTime()
date.setTime(миллисекунды)Полностью задаёт момент времени числом миллисекунд от эпохи Unix.Создание 4
Date.now()
Date.now()Возвращает текущее время в миллисекундах с начала эпохи Unix (число, а не объект).Date.parse()
Date.parse(строка)Разбирает строку с датой и возвращает число миллисекунд от эпохи или NaN при ошибке.Date.UTC()
Date.UTC(год, месяц, день, часы, минуты, секунды, мс)Возвращает миллисекунды от эпохи для указанных компонентов даты, трактуя их как UTC.new Date()
new Date([значение])Создаёт новый объект Date: текущий момент, из строки, из числа миллисекунд или из компонентов.Форматирование 6
Date.prototype.toDateString()
date.toDateString()Возвращает дату в человекочитаемом англоязычном виде без времени.Date.prototype.toISOString()
date.toISOString()Возвращает дату в стандартном формате ISO 8601 в зоне UTC (с суффиксом Z).Date.prototype.toLocaleDateString()
date.toLocaleDateString([локаль, опции])Возвращает дату как строку с учётом локали и заданных опций форматирования.Date.prototype.toLocaleString()
date.toLocaleString([локаль, опции])Возвращает дату и время вместе как строку с учётом локали и опций.Date.prototype.toLocaleTimeString()
date.toLocaleTimeString([локаль, опции])Возвращает время как строку с учётом локали и заданных опций форматирования.Date.prototype.toTimeString()
date.toTimeString()Возвращает время в человекочитаемом виде с указанием часового пояса, без даты.UTC 3
Date.prototype.getUTCFullYear()
date.getUTCFullYear()Возвращает год по времени UTC, без влияния местного часового пояса.Date.prototype.setUTCHours()
date.setUTCHours(часы[, мин, сек, мс])Устанавливает часы по времени UTC; есть UTC-версии и у остальных сеттеров.Разница между датами
date2 - date1 // миллисекундыВычитание двух объектов Date даёт разницу в миллисекундах, которую переводят в дни, часы и минуты.