JavaScript. Подробное руководство, 6-е издание

Флэнаган Дэвид

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

в соответствии с локальным или универсальным временем.

setTime

Устанавливает поля объекта

Date

в соответствии с миллисекундным форматом.

setYear

Устанавливает поле года объекта

Date

. Признан устаревшим, вместо него рекомендуется использовать

setFullYear

.

toDateString

Возвращает строку, представляющую дату из

Date

для локального часового пояса.

toGMTString

Преобразует

Date

в строку, беря за основу часовой пояс GMT. Признан устаревшим, вместо него рекомендован метод

toUTCString

.

toISOString

Преобразует

Date

в строку, используя стандарт ISO-8601, объединяющий формат представления даты/времени и UTC.

toJSON

Сериализует объект

Date

в формат JSON с помощью метода

toISOString

.

toLocaleDateString

Возвращает строку, представляющую дату из

Date

в локальном часовом поясе в соответствии с локальными соглашениями по форматированию дат.

toLocaleString

Преобразует

Date

в строку в соответствии с локальным часовым поясом и локальными соглашениями о форматировании дат.

toLocaleTimeString

Возвращает строку, представляющую время из

Date

в локальном часовом поясе на основе локальных соглашений о форматировании времени.

toString

Преобразует

Date

в строку в соответствии с локальным часовым поясом.

toTimeString

Возвращает строку, представляющую время из

Date

в локальном часовом поясе.

toUTCString

Преобразует

Date

в строку, используя универсальное время.

valueOf

Преобразует объект

Date

в его внутренний миллисекундный формат.

Статические методы

В дополнение к перечисленным методам экземпляра в объекте

Date

определены два статических метода. Эти методы вызываются через сам конструктор

Date,

а не через отдельные объекты

Date

:

Date.now

Возвращает текущее время в миллисекундах с начала эпохи.

Date.parse

Анализирует строковое представление даты и времени и возвращает внутреннее представление этой даты в миллисекундах.

Date.UTC

Возвращает представление указанной даты и времени UTC в миллисекундах.

Описание

Объект

Date

– это тип данных, встроенный в язык JavaScript. Объекты

Date

создаются с помощью представленного ранее синтаксиса

new Date.

После создания объекта

Date

можно воспользоваться его многочисленными методами. Многие из методов позволяют получать и устанавливать поля года, месяца, дня, часа, минуты, секунды и миллисекунды в соответствии либо с локальным временем, либо с временем UTC (универсальным, или GMT). Метод

toString

и его варианты преобразуют даты в понятные для восприятия строки.

getTime

и

setTime

преобразуют количество миллисекунд, прошедших с полуночи (GMT) 1 января 1970 года, во внутреннее представление объекта

Date

и обратно. В этом стандартном миллисекундном формате дата и время представляются одним целым, что делает дату очень простой арифметически. Стандарт ECMAScript требует, чтобы объект

Date

мог представить любые дату и время с миллисекундной точностью в пределах 100 миллионов дней до и после 01.01.1970. Этот диапазон равен ±273 785 лет, поэтому JavaScript-часы будут правильно работать до 275 755 года.