JavaScript объект Date
Описание объекта
Объекты Date основаны на значении времени, которое является числом миллисекунд с 00:00:00 1 января 1970 UTC. Эти объекты обладают большим количеством методов для выполнения различных вычислений с участием дат. Объект Date обеспечивает единообразное поведение на разных платформах. Значение времени может передаваться между системами для создания даты, представляющей один и тот же момент времени.
Объект Date поддерживает ряд UTC (универсальных) методов, а также методов локального времени. UTC, также известный как среднее время по Гринвичу (GMT), относится к времени, установленному мировым стандартом времени. Местное время это время на компьютере, на котором выполняется JavaScript. Для создания объектов Date в языке JavaScript имеется специальный конструктор Date(), который рассмотрен ниже.
Синтаксис конструктора объекта
new Date(); // создает объект Date со значением, равным текущим дате и времени new Date(value); // числовой аргумент new Date(dateString); //строковый аргумент new Date(year, monthIndex, day, hours, minutes, seconds, milliseconds); // от 2 до 7 числовых аргументов value - Integer dateString - String year, monthIndex, day, hours, minutes, seconds, milliseconds - Integer
Обратите внимание на то, что объекты Date могут быть созданы только путем вызова Date в качестве конструктора, в случае вызова в качестве обычной функции (без использования оператора new), то в качестве возвращаемого значения мы получим строку, а не объект Date. При таком вызове Date() (как функция - без оператора new) игнорирует любые переданные аргументы. В отличие от других типов объектов JavaScript, объекты Date не имеют литерального синтаксиса.
Конструктор Date(), вызванный без аргументов создаст объект Date со значением, которое будет соответствовать текущей дате и времени.
Если конструктору передается единственный числовой аргумент, то это значение используется как внутреннее числовое представление даты в миллисекундах. Это значение аналогично значению, которое возвращается с использованием метода getTime().
Если конструктору передается единственный строковый аргумент, то это значение рассматривается как строковое представление даты в формате, принимаемом методом parse().
Конструктору Date() допускается так же передать от двух до семи числовых аргументов, которые определяют индивидуальные настройки даты и времени. Используя этот синтаксис, обратите внимание на то, что все аргументы, кроме первых двух (год и месяц) не являются обязательными. Полное описание аргументов конструктора представлено ниже.
Значение параметров
| Параметр | Описание |
|---|---|
| value | Целое значение, представляющее количество миллисекунд с 00:00:00 1 января 1970 по UTC. |
| dateString | Строковое значение, представляющее дату. Строка должна быть в формате, распознаваемом методом parse() (совместимые с IETF RFC 2822 временные метки, а также ISO8601). |
| year | Целое значение, представляющее год. Значения от 0 до 99 соответствуют годам с 1900 по 1999. |
| monthIndex | Целое значение, представляющее месяц. Значение 0 соответствует январю, а 11 декабрю. |
| day | День месяца, заданный в виде целого значения от 1 до 31. Необязательный аргумент. |
| hours | Часы, заданные в виде целого от 0 (полночь) до 23 (11 часов вечера). Необязательный аргумент. |
| minutes | Целое значение от 0 до 59, представляющее минутный отрезок времени. Необязательный аргумент. |
| seconds | Целое значение от 0 до 59, представляющее секундный отрезок времени. Необязательный аргумент. |
| milliseconds | Целое значение от 0 до 999, представляющее миллисекундный отрезок времени. Необязательный аргумент. |
Методы объекта Date
| Метод | Описание |  Chrome |  Firefox |  Opera |  Safari |  IExplorer |  Edge |
|---|---|---|---|---|---|---|---|
| getDate() | Возвращает числовое значение (1-31), которое соответствует дню месяца для указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| getDay() | Возвращает числовое значение (0-6), которое соответствует дню недели для указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| getFullYear() | Возвращает числовое значение, которое соответствует году из указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| getHours() | Возвращает числовое значение (0-23), которое соответствует определенному часу для указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| getMilliseconds() | Возвращает числовое значение (0-999), которое соответствует миллисекундам для указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| getMinutes() | Возвращает числовое значение (0-59), которое соответствует минутам для указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| getMonth() | Возвращает числовое значение (0-11), которое соответствует месяцу для указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| getSeconds() | Возвращает числовое значение (0-59), которое соответствует секундам для указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| getTime() | Возвращает числовое значение указанной даты в виде количества миллисекунд, прошедших с 00:00:00 1 января 1970 года по UTC. | Да | Да | Да | Да | Да | Да |
| getTimezoneOffset() | Возвращает смещение часового пояса относительно часового пояса UTC в минутах для текущей локали. | Да | Да | Да | Да | Да | Да |
| getUTCDate() | Возвращает числовое значение (1-31), которое соответствует дню месяца для указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| getUTCDay() | Возвращает числовое значение (0-6), которое соответствует дню недели для указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| getUTCFullYear() | Возвращает числовое значение, которое соответствует году из указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| getUTCHours() | Возвращает числовое значение (0-23), которое соответствует часу для указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| getUTCMilliseconds() | Возвращает числовое значение (0-999), которое соответствует миллисекундам для указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| getUTCMinutes() | Возвращает числовое значение (0-59), которое соответствует минутам для указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| getUTCMonth() | Возвращает числовое значение (0-11), которое соответствует месяцу для указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| getUTCSeconds() | Возвращает числовое значение (0-59), которое соответствует секундам для указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| now() | Возвращает числовое значение, соответствующее текущему времени - количество миллисекунд, прошедших с 00:00:00 1 января 1970 по UTC. | Да | Да | Да | Да | 9.0 | Да |
| parse() | Анализирует строковое представление даты и возвращает количество миллисекунд, прошедших с 00:00:00 1 января 1970 года по UTC, или возвращает значение NaN (англ. Not-a-Number, "не число"), если строка не распознана или содержит недопустимые значения даты. | Да | Да | Да | Да | Да | Да |
| setDate() | Устанавливает день месяца для указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| setFullYear() | Устанавливает полный год для указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| setHours() | Устанавливает часы для указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| setMilliseconds() | Устанавливает миллисекунды для указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| setMinutes() | Устанавливает минуты для указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| setMonth() | Устанавливает месяц для указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| setSeconds() | Устанавливает секунды для указанной даты по местному времени. | Да | Да | Да | Да | Да | Да |
| setTime() | Устанавливает для объекта Date значение времени, представленное числом миллисекунд с 00:00:00 1 января 1970 года по UTC. | Да | Да | Да | Да | Да | Да |
| setUTCDate() | Устанавливает день месяца для указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| setUTCFullYear() | Устанавливает полный год для указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| setUTCHours() | Устанавливает часы для указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| setUTCMilliseconds() | Устанавливает миллисекунды для указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| setUTCMinutes() | Устанавливает минуты для указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| setUTCMonth() | Устанавливает месяц для указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| setUTCSeconds() | Устанавливает секунды для указанной даты по всемирному времени. | Да | Да | Да | Да | Да | Да |
| toDateString() | Возвращает часть, содержащую только дату объекта Date в виде удобочитаемой строки. | Да | Да | Да | Да | Да | Да |
| toISOString() | Преобразует дату в строку в формате ISO 8601. | Да | Да | Да | Да | 9.0 | Да |
| toJSON() | Возвращает строку, представляющую дату отформатированную в JSON (с помощью метода toISOString()). | Да | Да | Да | Да | 9.0 | Да |
| toLocaleDateString() | Возвращает строку с чувствительным к локале представлением части даты на основе системных параметров. | Да | Да | Да | Да | Да | Да |
| toLocaleString() | Возвращает строку с чувствительным к локале представлением даты. | Да | Да | Да | Да | Да | Да |
| toLocaleTimeString() | Возвращает строку с чувствительным к локале представлением временной части даты на основе системных параметров. | Да | Да | Да | Да | Да | Да |
| toString() | Возвращает строку, представляющую указанный объект Date. | Да | Да | Да | Да | Да | Да |
| toTimeString() | Возвращает часть времени, содержащую только время объекта Date в виде человеко-читаемой строки на американском английском. | Да | Да | Да | Да | Да | Да |
| toUTCString() | Преобразует дату в строку с использованием часового пояса UTC. | Да | Да | Да | Да | Да | Да |
| UTC() | Возвращает количество миллисекунд между указанной датой и 00:00:00 1 января 1970 года по UTC. | Да | Да | Да | Да | Да | Да |
| valueOf() | Возвращает примитивное значение объекта Date. | Да | Да | Да | Да | Да | Да |