Date.UTC()

Статический метод Date.UTC() принимает параметры, представляющие компоненты даты и времени, аналогичные конструктору Date, но обрабатывает их как UTC. Он возвращает количество миллисекунд с 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"

Синтаксис

Date.UTC(year)
Date.UTC(year, monthIndex)
Date.UTC(year, monthIndex, day)
Date.UTC(year, monthIndex, day, hours)
Date.UTC(year, monthIndex, day, hours, minutes)
Date.UTC(year, monthIndex, day, hours, minutes, seconds)
Date.UTC(year, monthIndex, day, hours, minutes, seconds, milliseconds)

Параметры

year

Целочисленное значение, представляющее год. Значения от 0 до 99 соответствуют годам 1900 - 1999. Все остальные значения — это фактический год. См. пример.

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

Целочисленное значение, представляющее месяц, начиная с 0 для января до 11 для декабря. По умолчанию 0.

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

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

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

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

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

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

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

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

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

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

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

Число, представляющее временную метку заданной даты. Возвращает NaN, если дата недействительна.

Описание

Годы от 0 до 99 преобразуются в год 20-го века (1900 + year). Например, 95 преобразуется в 1995 год.

Метод UTC() отличается от конструктора Date() тремя способами:

1. Date.UTC() использует всемирное время вместо местного.
2. Date.UTC() возвращает значение времени в виде числа, а не создает объект Date.
3. При передаче одного числа Date.UTC() интерпретирует его как год, а не как временную метку.

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

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

Примеры

Использование Date.UTC()

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

const utcDate = new Date(Date.UTC(2018, 11, 1, 0, 0, 0));

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

Date.UTC() при передаче одного аргумента имел непоследовательное поведение, поскольку реализации сохраняли только поведение, соответствующее конструктору Date(), который не интерпретирует один аргумент как номер года. Теперь реализации обязаны рассматривать пропущенные monthIndex как 0, а не преобразовывать их в NaN.

Date.UTC(2017); // 1483228800000

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

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

См. также

• Date.parse()
• Date