Метод UTC

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает количество миллисекунд, истекших с полуночи 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), представляющее час.
minutes
Необязательный. Должен указываться, если указывается аргумент seconds. Целое число от 0 до 59, представляющее минуты.
seconds
Необязательный. Должен указываться, если указывается аргумент milliseconds. Целое число от 0 до 59, представляющее секунды.
ms
Необязательный. Целое число от 0 до 999, представляющее миллисекунды.

Заметки

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

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

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

Примечание.
Если значение year указывается в диапазоне от 0 до 99, то для года используется значение 1900 + year.

Пример

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

function DaysBetweenDateAndNow(yr, mo, dy){
   var d, r, t1, t2, t3;            //Declare variables.
   var MinMilli = 1000 * 60         //Initialize variables.
   var HrMilli = MinMilli * 60
   var DyMilli = HrMilli * 24
   t1 = Date.UTC(yr, mo - 1, dy)    //Get milliseconds since 1/1/1970.
   d = new Date();                  //Create Date object.
   t2 = d.getTime();                //Get current time.
   if (t2 >= t1) 
      t3 = t2 - t1;
   else
      t3 = t1 - t2;
   r = Math.round(t3 / DyMilli);
   return(r);                       //Return difference.
}