Справочник по JScript : Методы JScript : Метод UTC
смотрим также
Материал из Справочник Web-языков
Содержание |
Метод UTC
Устанавливает значение миллисекунд между полночью 1 января 1970 года по Поясному и Всемирному времени (UTC - Universal Coordinated Time) или GMT и текущей датой.
Синтаксис
Date.UTC(year, month, day[, hours[, minutes[, seconds[,ms]]]])
Аргументы
- Date
- Обязательный аргумент. Объект Date.
- year
- Обязательный аргумент. Значение для года. Для обеспечения точности, указывайте полное значение для года, используя 4 цифры. Для значений из 2 цифр, год вычисляется как 1900+year.
- month
- Обязательный аргумент. Значение для месяца. Может быть от 0 до 11 - с Января по Декабрь соответственно.
- day
- Обязательный аргумент. Значение для дня. Может быть от 1 до 31.
- hours
- Необязательный аргумент. Значение для часов. Числовое значение от 0 до 23 (от полуночи до 11 pm). Должен быть задан, если задан аргумент minutes.
- minutes
- Необязательный аргумент. Значение для минут. Числовое значение от 0 до 59. Должен быть задан, если задан аргумент seconds.
- seconds
- Необязательный аргумент. Значение для секунд. Числовое значение от 0 до 59. Должен быть задан, если задан аргумент milliseconds (ms).
- ms
- Необязательный аргумент. Значение для миллисекунд. Числовое значение от 0 до 999.
Описание
Метод UTC возвращает значение миллисекунд, которые прошли с полуночи 1 января 1970 года по UTC или GMT до текущей даты. Это значение затем может быть использовано в методе setDate или конструкторе объекта Date. Если значение аргумента превышает верхнюю границу его диапазона или является отрицательным числом, то остальные хранящиеся значения изменяются соответственно. Например, если задать значение 150 секунд, то JScript переопределит его как две минуты и 30 секунд.
Различие между методом UTC и конструктором объекта Date состоит в том, что в методе UTC используется время в формате UTC, а в конструкторе объекта Date - местное локальное время.
Метод UTC - статический. Поэтому перед его использованием можно не создавать объект Date.
Метод применяется к объекту: Date Object (Windows Scripting - JScript).
Пример
В примере показано как работает метод UTC.
function DaysBetweenDateAndNow(yr, mo, dy) { // Определим количество миллисекунд в дне var MinMilli = 1000 * 60 var HrMilli = MinMilli * 60 var DyMilli = HrMilli * 24 // Зададим UTC год, месяц и день. var d = new Date(); var yeartoday = d.getUTCFullYear(); var monthtoday = d.getUTCMonth(); var dayofmonthtoday = d.getUTCDate(); // Получим количество миллисекунд с 1/1/1970 UTC. var t1 = Date.UTC(yr, mo - 1, dy) var t2 = Date.UTC(yeartoday, monthtoday, dayofmonthtoday); // Получим разницу в днях var days = (t1 - t2) / DyMilli; return(days); }
Поддержка
Смотрите также
Ссылки на источники
https://msdn.microsoft.com/en-us/library/wz6stk2z(v=VS.85).aspx