Date.UTC()

Сводка

Метод Date.UTC() принимает те же самые параметры, что и самая длинная форма конструктора Date и возвращает количество миллисекунд, прошедших с 1 января 1970 года 00:00:00 по UTC.

Синтаксис

Date.UTC(year, month[, day[, hour[, minute[, second[, millisecond]]]]])

Параметры

year
Год после 1900 года.
month
Целое число между 0 и 11, представляющее месяц.
day
Необязательный параметр. Целое число между 1 и 31, представляющее дни месяца.
hour
Необязательный параметр. Целое число между 0 и 23, представляющее часы.
minute
Необязательный параметр. Целое число между 0 и 59, представляющее минуты.
second
Необязательный параметр. Целое число между 0 и 59, представляющее секунды.
millisecond
Необязательный параметр. Целое число между 0 и 999, представляющее миллисекунды.

Описание

Метод UTC() принимает параметры даты, разделённые запятыми и возвращает количество миллисекунд, прошедших с 1 января 1970 года 00:00:00 по UTC и указанным вами временем.

Для параметра year вы должны указать полный год; например, 1998. Если указан год между 0 и 99, метод преобразует год в год в 20-м веке (1900 + year); например, если вы указали 95, будет использоваться 1995 год.

Метод UTC() отличается от конструктора Date двумя вещами.

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

Если определённый вами параметр выходит за пределы ожидаемого диапазона, метод UTC() обновит другие параметры чтобы привести это число в ожидаемый диапазон. Например, если вы используете в качестве месяца число 15, год будет увеличен на 1 (year + 1), и в качестве месяца будет использоваться значение 3.

Поскольку метод UTC() является статическим методом объекта Date, вы всегда должны использовать его как Date.UTC().

Примеры

Пример: использование Date.UTC()

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

var utcDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0));

Спецификации

Спецификация Статус Комментарии
ECMAScript 1-е издание. Стандарт Изначальное определение. Реализована в JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
Определение 'Date.UTC' в этой спецификации.
Стандарт  
ECMAScript 2015 (6th Edition, ECMA-262)
Определение 'Date.UTC' в этой спецификации.
Стандарт  

Совместимость с браузерами

Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка (Да) (Да) (Да) (Да) (Да)
Возможность Android Chrome для Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базовая поддержка ? ? ? ? ? ?

Смотрите также

Метки документа и участники

 Внесли вклад в эту страницу: Mingun
 Обновлялась последний раз: Mingun,