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

Date

Date

Date

работа с датами и временем (Object->Date)

Конструктор

new Date()
new Date(миллисекунды)
new Date (строка_ даты)
new Date(год, месяц, день, часы, минуты, секунды, мс)

Конструктор Date() без аргументов создает объект Date со значением, равным текущим дате и времени. Если конструктору передается единственный числовой аргумент, он используется как внутреннее числовое представление даты в миллисекундах, аналогичное значению, возвращаемому методом getTime(). Когда передается один строковый аргумент, он рассматривается как строковое представление даты в формате, принимаемом методом Date.parse(). Кроме того, конструктору можно передать от двух до семи числовых аргументов, задающих индивидуальные поля даты и времени. Все аргументы, кроме первых двух - полей года и месяца, - могут отсутствовать. Обратите внимание: эти поля даты и времени задаются на основе локального времени, а не времени UTC (Universal Coordinated Time - универсальное скоординированное время), аналогичного GMT (Greenwich Mean Time - среднее время по Гринвичу). В качестве альтернативы может использоваться статический метод Date.UTC().
Date() может также вызываться как функция (без оператора 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 в соответствии с локальным или универсальным временем.

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 года.

Пример

Известно множество методов, позволяющих работать с созданным объектом Date:

d = new Date(); // Получает текущую дату и время
document.write('Сегодня: "+d.toLocaleDateString() + '. ');// Показывает дату
document.write('Время: '+ d.toLocaleTimeString());  // Показывает время
var dayOfWeek = d.getDay();                         // День недели
var weekend = (dayOfWeek == 0) || (dayOfWeek == 6); // Сегодня выходной?

Еще одно типичное применение объекта Date - это вычитание миллисекундного представления текущего времени из другого времени для определения относительного местоположения двух временных меток. Следующий пример клиентского кода показывает два таких применения:

<script language="JavaScript">
today = new Date();     // Запомнить сегодняшнюю дату
Christmas = new Date(); // Получить дату из текущего года
Christmas.setMonth(11); // Установить месяц декабрь...
Christmas.setDate(25);  // и 25-е число
// Если Рождество еще не прошло, вычислить количество миллисекунд между текущим моментом
// и Рождеством, преобразовать его в количество дней и вывести сообщение
if (today.getTime() < Christmas.getTime()) {
  difference = Christmas.getTime() - today.getTime();
  difference = Math.floor(difference / (1000 * 60 * 60 * 24));
  document.write('Всего ' + difference + ' дней до Рождества!<p>');
}
</script>
// ... остальная часть HTML-документа ...
<script language="JavaScript">
// Здесь мы используем объекты Date для измерения времени
// Делим на 1000 для преобразования миллисекунд в секунды
now = new Date();
document.write('<р>Страница загружалась' +
               (now.getTime()-today.getTime())/1000 +
               'секунд.');
</script>

См. также

Date.parse(), Date.UTC()

Date.getDate()

возвращает значение поля дня месяца объекта Date

Синтаксис

дата. getDate()

Возвращаемое значение

День месяца даты, представляющей собой объект Date, в соответствии с локальным временем. Возвращаемые значения могут находиться в интервале между 1 и 31.

Date.getDay()

возвращает значение поля дня недели объекта Date

Синтаксис

дата.getDay()

Возвращаемое значение

День недели даты, представляющей собой объект Date, в соответствии с локальным временем. Возвращает числа от 0 (воскресенье) до 6 (суббота).

Date.getFullYear()

возвращает значение поля года объекта Date

Синтаксис

дата.getFullYear()

Возвращаемое значение

Год, получаемый, когда дата выражена в локальном времени. Возвращает четыре цифры, а не сокращение из двух цифр.

Date.getHours()

возвращает значение поля часа объекта Date

Синтаксис

дата.getHours()

Возвращаемое значение

Значение поля часа в дате, представляющей собой объект Date, в локальном времени. Возвращаемое значение находится в диапазоне между 0 (полночь) и 23 (11 часов вечера).

Date.getMilliseconds()

возвращает значение поля миллисекунд объекта Date

Синтаксис

дата.getMilliseconds()

Возвращаемое значение

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

Date.getMinutes()

возвращает значение поля минут объекта Date

Синтаксис

дата.getMinutes()

Возвращаемое значение

Поле минут в дате, представляющей собой объект Date, вычисленное в локальном времени. Возвращаемое значение может принимать значения от 0 до 59.

Date.getMonth()

возвращает значение поля месяца объекта Date

Синтаксис

дата.getMonth()

Возвращаемое значение

Поле месяца в дате, представляющей собой объект Date, вычисленное в локальном времени. Возвращаемое значение может принимать значения от 0 (январь) до 11 (декабрь).

Date.getSeconds()

возвращает значение поля секунд объекта Date

Синтаксис

дата.getSeconds()

Возвращаемое значение

Поле секунд в дате, представляющем собой объект Date, в локальном времени. Возвращаемое значение может принимать значения от 0 до 59.

Date.getTime()

возвращает значение даты в миллисекундах

Синтаксис

дата.getTime()

Возвращаемое значение

Миллисекундное представление даты, представляющей собой объект Date, т.е. число миллисекунд между полночью 01.01.1970 и датой/временем, определяемыми датой.

Описание

Метод getTime() преобразует дату и время в одно целое значение. Это удобно, когда требуется сравнить два объекта Date или определить время, прошедшее между двумя датами. Обратите внимание: миллисекундное представление даты не зависит от часового пояса, поэтому отсутствует метод getUTCTime(), дополняющий данный. Не путайте метод getTime() с методами getDay() и getDate(), возвращающими, соответственно, день недели и день месяца.

Методы Date.parse() и Date.UTC() позволяют преобразовать спецификацию даты и времени в миллисекундное представление, обходя избыточное создание объекта Date.

См. также

Date, Date.parse(), Date.setTime(), Date.UTC()

Date.getTimezoneOffset()

определяет смещение относительно GMT

Синтаксис

дата.getTimezoneOffset()

Возвращаемое значение

Разница в минутах между временем по Гринвичу (GMT) и локальным временем.

Описание

Функция getTimezoneOffset() возвращает разницу в минутах между универсальным и локальным временем, сообщая, в каком часовом поясе выполняется JavaScript-код и действует ли (или будет ли действовать) летнее время для указанной даты. Возвращаемое значение измеряется в минутах, а не в часах, поскольку в некоторых странах имеются часовые пояса, не занимающие целого часового интервала.

Date.getUTCDate()

Возвращает значение поля дня месяца объекта Date (универсальное время)

Синтаксис

дата.getUTCDate()

Возвращаемое значение

День месяца (значение между 1 и 31), полученный при вычислении даты в универсальном времени.

Date.getUTCDay()

возвращает значение поля дня недели объекта Date (универсальное время)

Синтаксис

дата. getUTCDay()

Возвращаемое значение

День недели, получаемый, когда дата выражена в универсальном времени. Возвращаемые значения могут находиться в интервале между 0 (воскресенье) и 6 (суббота).

Date.getUTCFullYear()

возвращает значение поля года объекта Date (универсальное время)

Синтаксис

дата.getUTCFullYear()

Возвращаемое значение

Год, получаемый, когда дата вычисляется в универсальном времени. Возвращаемое значение - четырехзначный номер года, а не сокращение из двух цифр.

Date.getUTCHours()

возвращает значение поля часов объекта Date (универсальное время)

Синтаксис

дата.getUTCHours()

Возвращаемое значение

Поле часов для даты₉ вычисленное в универсальном времени. Возвращаемое значение - целое между 0 (полночь) и 23 (11 часов вечера).

Date.getUTCMilliseconds()

возвращает значение поля миллисекунд объекта Date (универсальное время)

Синтаксис

дата.getUTCMilliseconds()

Возвращаемое значение

Поле миллисекунд для даты, выраженное в универсальном времени.

Date.getUTСМіnutes()

возвращает значение поля минут объекта Date (универсальное время)

Синтаксис

дата.getUTCMinutes()

Возвращаемое значение

Поле минут для даты, вычисленное в универсальном времени. Возвращает целое между 0 и 59.

Date.getUTCMonth()

возвращает значение поля месяца года объекта Date (универсальное время)

Синтаксис

дата.getUTCMonth()

Возвращаемое значение

Месяц года, получающийся, когда дата вычислена в универсальном времени. Возвращает целое между 0 (январь) и 11 (декабрь). Обратите внимание: объект Date обозначает первый день месяца цифрой 1, но первому месяцу года соответствует цифра 0.

Date.getUTCSeconds()

возвращает значение поля секунд объекта Date (универсальное время)

Синтаксис

дата.getUTCSeconds()

Возвращаемое значение

Поле секунд даты, вычисленное в универсальном времени. Возвращает целое между 0 и 59.

Date.getYear() (устарел)

возвращает значение поля года объекта Date

Синтаксис

дата.getYear()

Возвращаемое значение

Поле года для указанного даты, представляющей собой объект Date, минус 1900.

Описание

Метод getYear() возвращает поле года для указанного объекта Date минус 1900. Согласно спецификации ECMAScript v3, этот метод не является обязательным в совместимых реализациях JavaScript; используйте вместо него метод getFullYear().

Date.now() (ECMAScript 5)

возвращает текущее время в миллисекундах

Синтаксис

Date.now()

Возвращаемое значение

Текущее время в миллисекундах, прошедшее с полуночи 1 января 1970 года по Гринвичу.

Описание

До выхода спецификации ECMAScript 5 этот метод можно было реализовать следующим образом:

Date.now = function() { return (new Date()).getTime(); }

См. также

Date, Date.getTime()

Date.parse()

синтаксический разбор строки даты/времени

Синтаксис

Date.parsе(дата)

Аргументы

дата Строка для разбора, содержащая дату и время.

Возвращаемое значение

Количество миллисекунд между указанными датой/временем и полночью 1 января 1970 года по Гринвичу.

Описание

Метод Date.parse() - это статический метод объекта Date. Метод Date.parse() принимает один строковый аргумент, анализирует дату, содержащуюся в строке, и возвращает ее в виде числа миллисекунд, прошедших с начала эпохи. Это возвращаемое значение может использоваться непосредственно для создания нового объекта Date или для установки даты в существующем объекте Date с помощью Date.setTime().

Стандарт ECMAScript 5 требует, чтобы этот метод мог разбирать строки, возвращаемые методом Date.toISOString(). В ECMAScript 5 и более ранних версиях спецификации требовалось также, чтобы этот метод мог разбирать строки, возвращаемые методами toString() и toUTCString().

См. также

Date, Date.setTime(), Date.toISOString(), Date.toString()

Date.setDate()

устанавливает поле дня месяца объекта Date

Синтаксис

дата.setDatе(день_месяца)

Аргументы

день_месяца Целое между 1 и 31, используемое как новое значение (в локальном времени) поля дня месяца объекта дата.

Возвращаемое значение

Миллисекундное представление измененной даты. До выхода стандарта ECMAScript этот метод ничего не возвращал.

Date.setFullYear()

устанавливает поля года и, если явно указано, месяца и дня месяца объекта Date

Синтаксис

дата.setFullYear(год)
дата.setFullYear(год, месяц)
дата.setFullYear(год, месяц, день)

Аргументы

год Год, выраженный в локальном времени, который должен быть установлен в дате. Этот аргумент должен быть целым, включающим век, например 1999; не может быть сокращением, таким как 99.

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

день Необязательное целое между 1 и 31, используемое как новое значение поля дня месяца для даты (в локальном времени).

Возвращаемое значение

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

Date.setHours()

устанавливает значения полей часов, минут, секунд и миллисекунд объекта Date

Синтаксис

дата.setHours(часы)
дата.setHours(часы, минуты)
дата.setHours(часы, минуты, секунды)
дата.setHours(часы, минуты, секунды, миллисекунды)

Аргументы

часы Целое между 0 (полночь) и 23 (11 часов вечера) локального времени, устанавливаемое в качестве нового значения часов в дате.

минуты Необязательное целое между 0 и 59, используемое в качестве нового значения поля минут в дате (в локальном времени). Этот аргумент не поддерживался до выхода стандарта ECMAScript.

секунды Необязательное целое между 0 и 59. Представляет собой новое значение поля секунд в дате (в локальном времени). Этот аргумент не поддерживался до выхода стандарта ECMAScript.

миллисекунды Необязательное целое между 0 и 999, используемое как новое значение поля миллисекунд в дате (в локальном времени). Этот аргумент не поддерживался до выхода стандарта ECMAScript.

Возвращаемое значение

Миллисекундное представление измененной даты. До выхода стандарта ECMAScript этот метод ничего не возвращал.

Date.setMilliseconds()

устанавливает значение поля миллисекунд объекта Date

Синтаксис

дата.setMilliseconds( миллисекунды)

Аргументы

миллисекунды Поле миллисекунд, выраженное в локальном времени, для установки в дате. Этот аргумент должен быть целым между 0 и 999.

Возвращаемое значение

Миллисекундное представление измененной даты.

Date.setMinutes()

устанавливает значения полей минут, секунд и миллисекунд объекта Date

Синтаксис

дата.setMinutes (минуты)
дата.setMinutes {минуты, секунды)
дата.setMinutes {минуты, секунды, миллисекунды)

Аргументы

минуты Целое между 0 и 59, устанавливаемое в качестве значения минут (в локальном времени) в дате, представляющей собой объект Date.

секунды Необязательное целое между 0 и 59, используемое как новое значение поля секунд даты (в локальном времени). Этот аргумент не поддерживался до выхода стандарта ECMAScript.

миллисекунды Необязательное целое между 0 и 999, представляющее собой новое значение (в локальном времени) поля миллисекунд даты. Этот аргумент не поддерживался до выхода стандарта ECMAScript.

Возвращаемое значение

Миллисекундное представление измененной даты. До выхода стандарта ECMAScript этот метод ничего не возвращал.

Date.setMonth()

устанавливает поля месяца и дня месяца объекта Date

Синтаксис

дата.setMonth(месяц)
дата.setMonth(месяц, день)

Аргументы

месяц Целое между 0 (январь) и 11 (декабрь), устанавливаемое в качестве значения поля месяца (в локальном времени) в дате, представляющей собой объект Date. Обратите внимание: месяцы нумеруются, начиная с 0, а дни в месяце - с 1.

день Необязательное целое между 1 и 31, используемое как новое значение поля дня месяца в дате (в локальном времени). Этот аргумент не поддерживался до выхода стандарта ECMAScript.

Возвращаемое значение

Миллисекундное представление измененной даты. До выхода стандарта ECMAScript этот метод ничего не возвращал.

Date.setSeconds()

устанавливает значения полей секунд и миллисекунд объекта Date

Синтаксис

дата.setSeconds(секунды)
дата.setSeconds(секунды, миллисекунды)

Аргументы

секунды Целое между 0 и 59, устанавливаемое как значение секунд в дате, представляющей собой объект Date.

миллисекунды Необязательное целое между 0 и 999, используемое как новое значение поля миллисекунд в дате (в локальном времени). Этот аргумент не поддерживался до выхода стандарта ECMAScript.

Возвращаемое значение

Миллисекундное представление измененной даты. До выхода стандарта ECMAScript этот метод ничего не возвращал.

Date.setTime()

устанавливает значение даты в миллисекундах

Синтаксис

дата.setTimе(миллисекунды)

Аргументы

миллисекунды Количество миллисекунд между требуемыми датой/временем и полночью 1 января 1970 года по Гринвичу. Подобное миллисекундное значение может быть также передано конструктору Date() и получено при вызове методов Date.UTC() и Date.parse(). Представление даты в миллисекундном формате делает ее независимой от часового пояса.

Возвращаемое значение

Аргумент миллисекунды. До выхода стандарта ECMAScript метод ничего не возвращал.

Date.setUTCDate()

устанавливает значение поля дня месяца объекта Date (универсальное время)

Синтаксис

дата.setUTCDatе(день_месяца)

Аргументы

день_месяца День месяца, выраженный в универсальном времени и устанавливаемый в дате. Этот аргумент должен быть целым между 1 и 31.

Возвращаемое значение

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

Date.setUTCFullYear()

устанавливает значения полей года, месяца и дня месяца объекта Date (универсальное время)

Синтаксис

дата.setUTCFullYear(год)
дата.setUTCFullYear(год, месяц)
дата.setUTCFullYear(год, месяц, день)

Аргументы

год Год, выраженный в универсальном времени, для установки в дате. Этот аргумент должен быть целым, включающим век, например 1999, а не сокращением, как 99.

месяц Необязательное целое между 0 и 11, используемое как новое значение поля месяца даты (в универсальном времени). Обратите внимание: месяцы нумеруются, начиная с 0, тогда как нумерация дней месяцев начинается с 1.

день Необязательное целое между 1 и 31; используется как новое значение (в универсальном времени) поля «день месяца» в дате.

Возвращаемое значение

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

Date.setUTCHours()

устанавливает значения полей часов, минут, секунд и миллисекунд объекта Date (универсальное время)

Синтаксис

дата.setUTCHours(часы)
дата.setUTCHours(часы, минуты)
дата.setUTCHours(часы, минуты, секунды)
дата.setUTCHours(часы, минуты, секунды, миллисекунды)

Аргументы

часы Значение поля часов, выраженное в универсальном времени, для установки в дате. Этот аргумент должен быть целым между 0 (полночь) и 23 (11 часов вечера).

минуты Необязательное целое между 0 и 59, используемое как новое значение поля минут в дате (в универсальном времени).

секунды Необязательное целое между 0 и 59, используемое как новое значение поля секунд в дате (в универсальном времени).

миллисекунды Необязательное целое между 0 и 999, используемое как новое значение поля миллисекунд в дате (в универсальном времени).

Возвращаемое значение

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

Date.setUTCMilliseconds()

устанавливает значение поля миллисекунд объекта Date (универсальное время)

Синтаксис

дата.setUTCMilliseconds(миллисекунды)

Аргументы

миллисекунды Значение поля миллисекунд, выраженное в универсальном времени, для установки в дате. Этот аргумент должен быть целым между 0 и 999.

Возвращаемое значение

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

Date.setUTCMinutes()

устанавливает значения полей минут, секунд и миллисекунд объекта Date (универсальное время)

Синтаксис

дата.setUTCMinutes(минуты)
дата.setUTCMinutes(минуты, секунды)
дата.setUTCMinutes(минуты, секунды, миллисекунды)

Аргументы

минуты Значение поля минут в универсальном времени для установки в дате. Этот аргумент должен принимать значение между 0 и 59.

секунды Необязательное целое между 0 и 59, используемое как новое значение поля секунд в дате (в универсальном времени).

миллисекунды Необязательное целое между 0 и 999, используемое как новое значение поля миллисекунд в дате (в универсальном времени).

Возвращаемое значение

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

Date.setUTCMonth()

устанавливает поля месяца и дня месяца объекта Date (универсальное время)

Синтаксис

дата.setUTCMonth(месяц)
дата.setUTCMonth(месяц, день)

Аргументы

месяц Месяц, выраженный в универсальном времени, для установки в дате. Этот аргумент должен быть целым между 0 (январь) и 11 (декабрь). Обратите внимание: месяцы нумеруются, начиная с 0, а дни в месяце - с 1.

день Необязательное целое между 1 и 31, используемое как новое значение поля дня месяца в дате (в универсальном времени).

Возвращаемое значение

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

Date.setUTCSeconds()

устанавливает значения полей секунд и миллисекунд объекта Date (универсальное время)

Синтаксис

дата. setUTCSeconds(секунды)
дата. setUTCSeconds(секунды, миллисекунды)

Аргументы

секунды Значение поля секунд в универсальном времени для установки в дате. Этот аргумент должен быть целым между 0 и 59.

миллисекунды Необязательное целое между 0 и 999, используемое как новое значение поля миллисекунд даты (в универсальном времени).

Возвращаемое значение

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

Date.setYear() (устарел)

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

Синтаксис

дата.setYear(год)

Аргументы

год Целое, устанавливаемое как значение поля года (в локальном времени) в дате, представляющей собой объект Date. Если это значение находится между 0 и 99, к нему добавляется 1900, и оно рассматривается как год между 1900 и 1999.

Возвращаемое значение

Миллисекундное представление измененной даты. До выхода стандарта ECMAScript этот метод ничего не возвращал.

Описание

Метод setYear() устанавливает поле года в указанном объекте Date, особым образом обрабатывая интервал времени между 1900 и 1999 годами.

Согласно спецификации ECMAScript v3, этот метод не является обязательным в совместимых реализациях JavaScript; вместо него рекомендован метод setFullYear().

Date.toDateString()

возвращает дату из объекта Date в виде строки

Синтаксис

дата.toDateString()

Возвращаемое значение

Зависящее от реализации и понятное человеку строковое представление даты (без времени), представленной объектом дата в локальном времени.

См. также

Date.toString(), Date.toTimeString()

Date.toGMTString() (устарел)

преобразует объект Date в строку универсального времени

Синтаксис

дата.toGMTString()

Возвращаемое значение

Строковое представление даты и времени, указанное в объекте дата. Перед преобразованием в строку, дата переводится из локального времени во время по Гринвичу.

Описание

Метод toGMTString() признан устаревшим, вместо него рекомендуется использовать аналогичный метод Date.toUTCString().

Согласно спецификации ECMAScript v3 совместимые реализации JavaScript больше не обязаны предоставлять этот метод; используйте вместо него метод toUTCString().

См. также

Date.toUTCString()

Date.tolSOString() (ECMAScript 5)

преобразует объект Date в строку в формате IS08601

Синтаксис

дата.toISOString()

Возвращаемое значение

Строковое представление даты, отформатированное в соответствии со стандартом ISO-8601 и выраженное как точная комбинация даты и времени в UTC с указанием часового пояса «Z». Возвращаемая строка имеет следующий формат:

yyyy-mm-ddThh:mm:ss. sssZ

См. также

Date.parse(), Date.toString()

Date.toJSON() (ECMAScript 5)

сериализует объект Date в формат JSON

Синтаксис

дата.toJSON(ключ)

Аргументы

ключ Метод toJSON() не использует этот аргумент и просто передает его функции JSON.stringify().

Возвращаемое значение

Строковое представление даты, полученное вызовом метода toISOString().

Описание

Для преобразования объекта Date в строку этот метод использует функцию JSON.stringify(). Он не предназначен для широкого использования.

См. также

Date.toISOString(), JSON.stringify()

Date.toLocaleDateString()

возвращает дату из Date в виде строки с учетом региональных настроек

Синтаксис

дата.toLocaleDateString()

Возвращаемое значение

Зависящее от реализации и понятное человеку строковое представление даты (без времени) из объекта дата, выраженное в локальном времени и отформатированное в соответствии с региональными настройками.

См. также

Date.toDateString(), Date.toLocaleString(), Date.toLocaleTimeString(), Date.toString(), Date. toTimeString()

Date.toLocaleString()

преобразует дату в строку с учетом региональных настроек

Синтаксис

дата.toLocaleString()

Возвращаемое значение

Строковое представление даты и времени в объекте дата. Дата и время представлены в локальном часовом поясе и отформатированы в соответствии с региональными настройками.

Порядок использования

Метод toLocaleString() преобразует дату в строку в соответствии с локальным часовым поясом. При форматировании даты и времени используются региональные настройки, поэтому формат может отличаться на разных платформах и в разных странах. Метод toLocaleString() возвращает строку, отформатированную в соответствии с предпочтительным для пользователя форматом представления даты и времени.

См. также

Date.toISOString(), Date.toLocaleDateString(), Date.toLocaleTimeString(), Date.toString(), Date.toUTCString()

Date.toLocaleTimeString()

возвращает время из Date в виде строки с учетом региональных настроек

Синтаксис

дата.toLocaleTimeString()

Возвращаемое значение

Зависящее от реализации и понятное человеку строковое представление данных о времени из объекта дата, выраженное в локальном часовом поясе и отформатированное в соответствии с региональными настройками.

См. также

Date.toDateString(), Date.toLocaleDateString(), Date.toLocaleString(), Date.toString(), Date. toTimeString()

Date.toString()

преобразует объект Date в строку (переопределяет Object.toString())

Синтаксис

дата.toString()

Возвращаемое значение

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

Описание

Метод toString() возвращает понятное человеку и зависящее от реализации строковое представление даты. В отличие от toUTCString(), метод toString() вычисляет дату в локальном часовом поясе. В отличие от toLocaleString(), метод toString() может представлять дату и время без учета региональных настроек.

См. также

Date.parse(), Date.toDateString(), Date.toISOString(), Date.toLocaleString(), Date.toTimeString(), Date.toUTCString()

Date.toTimeString()

возвращает время из объекта Date в виде строки

Синтаксис

дата.toTimeString()

Возвращаемое значение

Зависящее от реализации, понятное человеку строковое представление данных о времени из объекта дата, выраженное в локальном часовом поясе.

См. также

Date.toString(), Date.toDateString(), Date.toLocaleTimeString()

Date.toUTCString()

преобразует объект Date в строку (универсальное время)

Синтаксис

дата.toUTCString()

Возвращаемое значение

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

Описание

Метод toUTCString() возвращает зависящую от реализации строку, представляющую дату в универсальном времени.

См. также

Date.toISOString(), Date.toLocaleString(), Date.toString()

Date.UTC()

преобразует спецификацию даты в миллисекунды

Синтаксис

Date.UTC(год, месяц, день, часы, минуты, секунды, мс)

Аргументы

год Год в четырехзначном формате. Если аргумент находится между 0 и 99, к нему добавляется 1900, и он рассматривается как год между 1900 и 1999.

месяц Месяц в виде целого числа от 0 (январь) до 11 (декабрь).

день День месяца в виде целого числа от 1 до 31. Обратите внимание: наименьшее значение этого аргумента равно 1, наименьшее значение других аргументов - 0. Этот аргумент не является обязательным.

часы Час в виде целого числа от 0 (полночь) до 23 (11 часов вечера). Этот аргумент может отсутствовать.

минуты Минуты в часе в виде целого числа от 0 до 59. Этот аргумент может отсутствовать.

секунды Секунды в минутах в виде целого числа от 0 до 59. Этот аргумент может отсутствовать.

мс Количество миллисекунд. Этот аргумент может отсутствовать; игнорировался до выхода стандарта ECMAScript.

Возвращаемое значение

Миллисекундное представление указанного универсального времени. Метод возвращает количество миллисекунд между полночью по Гринвичу 1 января 1970 года и указанным временем.

Описание

Метод Date.UTC()- это статический метод, который вызывается через конструктор Date(), а не через отдельный объект Date.

Аргументы Date.UTC() определяют дату и время и подразумевают время в формате UTC. Указанное время UTC преобразуется в миллисекундный формат, который может использоваться методом-конструктором Date() и методом Date.setTime().Метод-конструктор Date() может принимать аргументы даты и времени, идентичные тем, что принимает метод Date.UTC(). Разница в том, что конструктор Date() подразумевает локальное время, a Date. UTC() - время по Гринвичу (GMT). Создать объект Date, используя спецификацию времени в UTC, можно следующим образом:

d = new Date(Date.UTC(1996, 4, 8, 16, 30));

См. также

Date, Date.parse(), Date.setTime()

Date.valueOf()

преобразует объект Date в миллисекунды (переопределяет Object.valueOf())

Синтаксис

дата.valueOf()

Возвращаемое значение

Миллисекундное представление даты. Возвращаемое значение совпадает со значением, возвращаемым Date.getTime().