Ядро JavaScript 1.5. Справочник



         

UTC


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

Метод из

Static

Реализован в

JavaScript 1.0, NES 2.0

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

Версия ECMA

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

    См. также

    .




    Содержание  Назад  Вперед