UTC

Возвращает количество миллисекунд в Date-объекте, прошедших после 1 января 1970 года, 00:00:00 универсального времени.

Метод из

StaticРеализован в

JavaScript 1.0, NES 2.0

JavaScript 1.3: добавлен параметр ms.

Версия ECMAECMA-262

Синтаксис

Date.UTC(year, month, day[, hrs, min, sec, ms])

Параметры

year

Год после 1900.

month

Целое число в диапазоне от 0 до 11 - месяц.Date

Целое число в диапазоне от 1 до 31 - число месяца.

hrs

Целое число в диапазоне от 0 до 23 - час суток.

minЦелое число в диапазоне от 0 до 59 - минуты.sec

Целое число в диапазоне от 0 до 59 - секунды.

msЦелое число в диапазоне от 0 до 999 - миллисекунды.

Описание

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

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

Метод UTC отличается от конструктора Date по двум позициям:

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

Date.UTC возвращает значение времени как число, а не создаёт объект Date.

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

Поскольку UTC это static-метод объекта Date, Вы всегда используете его как Date.UTC(), а не как метод Date -объекта, созданного Вами.

Примеры

Этот оператор создаёт Date -объект, используя GMT вместо локального времени:

gmtDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0))

См. также

Содержание раздела