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

Интерактивный пример

const utcDate1 = new Date(Date.UTC(96, 1, 2, 3, 4, 5));const utcDate2 = new Date(Date.UTC(0, 0, 0, 0, 0, 0));console.log(utcDate1.toUTCString());// Expected output: "Fri, 02 Feb 1996 03:04:05 GMT"console.log(utcDate2.toUTCString());// Expected output: "Sun, 31 Dec 1899 00:00:00 GMT"

Синтаксис

Начиная с ECMAScript 2017:

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

ECMAScript 2016 и ранее: (использованиеmonth обязательно)

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

Параметры

year

Год, полностью.

month

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

dayНеобязательный

Целое число между1 и31, представляющее дни месяца.

hourНеобязательный

Целое число между0 и23, представляющее часы.

minuteНеобязательный

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

secondНеобязательный

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

millisecondНеобязательный

Целое число между0 и999, представляющее миллисекунды.

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

Число, представляющее собой количество миллисекунд, прошедших с 1-ого Января 1970 года 00:00:00 UTC.

Описание

Метод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(2018, 11, 1, 0, 0, 0));

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

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

Примечание о совместимости

Date.UTC() с менее чем двумя аргументами

Когда вы предоставляете функцииDate.UTC() меньше, чем два аргумента, то по стандартам ECMAScript 2017, она должна вернутьNaN. Браузерные движки, не поддерживающие подобное поведение, были обновлены (смотритеbug 1050755,ecma-262 #642).

Date.UTC();Date.UTC(1);// Safari: NaN// Chrome/Opera/V8: NaN// Firefox <54: non-NaN// Firefox 54+: NaN// IE: non-NaN// Edge: NaN

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

• Date.parse()
• Date