Date.UTC()

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

Синтаксис

 Начиная с  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));

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

Спецификация
ECMAScript (ECMA-262)
Определение 'Date.UTC' в этой спецификации.

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

Update compatibility data on GitHub
КомпьютерыМобильныеServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung InternetNode.js
UTCChrome Полная поддержка 1Edge Полная поддержка 12Firefox Полная поддержка 1IE Полная поддержка 3Opera Полная поддержка 3Safari Полная поддержка 1WebView Android Полная поддержка 1Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка 10.1Safari iOS Полная поддержка 1Samsung Internet Android Полная поддержка 1.0nodejs Полная поддержка 0.1.100

Легенда

Полная поддержка  
Полная поддержка

Заметка о совместимости

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

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