Метод UTC

Статья
08/11/2011

Возвращает количество миллисекунд, истекших с полуночи 1 января 1970 года до указанной даты, используя время в формате UTC (или время GMT).

function UTC(year : Number , month : Number , day : Number [, hours : Number [, minutes : Number [, seconds : Number [,ms : Number]]]]) : Number

Аргументы

year
Обязательный. Чтобы обеспечить точность даты в разных веках, необходимо полное указание года. Если используется значение year в диапазоне от 0 до 99, то предполагается, что год соответствует значению 1900 + year.
month
Обязательный. Месяц, представляемый в виде числа от 0 до 11 (с января по декабрь).
day
Обязательный. Дата в виде целого числа в диапазоне от 1 до 31.
hours
Необязательный. Должен указываться, если указывается аргумент minutes. Целое число от 0 до 23 (от полуночи до 23:00), представляющее час.
минуты
Необязательный. Должен указываться, если указывается аргумент seconds. Целое число от 0 до 59, представляющее минуты.
секунды
Необязательный. Должен указываться, если указывается аргумент milliseconds. Целое число от 0 до 59, представляющее секунды.
ms
Необязательный. Целое число от 0 до 999, представляющее миллисекунды.

Заметки

Метод UTC возвращает количество миллисекунд, истекших с полуночи 1 января 1970 года и указанной датой, используя время в формате UTC. Возвращаемое значение может использоваться методом setTime и конструктором объекта Date. Если значение аргумента превышает верхнюю границу его диапазона или является отрицательным числом, остальные хранящиеся значения изменяются соответственно. Например, если задать 150 секунд, JScript переопределит это число как две минуты и 30 секунд.

Различие между методом UTC и конструктором объекта Date состоит в том, что в методе UTC предполагается время в формате UTC, а в конструкторе объекта Date предполагается локальное время.

Метод UTC является статическим методом. Поэтому перед его использованием необязательно создавать объект Date.

Пример

В следующем примере показано использование метода UTC.

function DaysBetweenDateAndNow(yr, mo, dy)
{
    // Determine the milliseconds per day.
    var MinMilli = 1000 * 60
    var HrMilli = MinMilli * 60
    var DyMilli = HrMilli * 24

    // Determine today's UTC year, month, and day.
    var d = new Date();
    var yeartoday = d.getUTCFullYear();
    var monthtoday = d.getUTCMonth();
    var dayofmonthtoday = d.getUTCDate();
    
    // Get the milliseconds since 1/1/1970 UTC.
    var t1 = Date.UTC(yr, mo - 1, dy)
    var t2 = Date.UTC(yeartoday, monthtoday, dayofmonthtoday);
   
    // Determine the difference in days.
    var days = (t1 - t2) / DyMilli;
   
    return(days);
}