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));

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

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

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

• Date.parse()