Справочник по JScript : Объекты JScript : Объект Date
Материал из Справочник Web-языков
Содержание |
Объект Date
Позволяет сохранять и возвращать (извлекать) различные форматы даты и времени.
Синтаксис
dateObj = new Date()
dateObj = new Date(dateVal)
dateObj = new Date(year, month, date[, hours[, minutes[, seconds[,ms]]]])
Аргументы
- dateObj
- Обязательный аргумент. Имя переменной, которой присвоен объект Date.
- dateVal
- Обязательный аргумент. Если является числом, то dateValвозвращает число миллисекунд в UTC (Universal Coordinated Time - Всемирное координированное время) между заданной датой и полночью 1 января 1970 года. Если является строкой, то dateVal анализируется в соответствии с правилами в методе parse. Аргумент dateVal также может иметь значение VT_DATE, как возвращенное некоторыми объектами ActiveX®.
- year
- Обязательный аргумент. Полное название года, например 1987 (но не 87).
- month
- Обязательный аргумент. Месяц, выраженный целым числом от 0 до 11 (с января по декабрь).
- date
- Обязательный аргумент. Дата, выраженная целым числом от 1 до 31.
- hours
- Необязательный аргумент. Поддерживается, если поддерживаются minutes (минуты). Выражается целым числом от 0 (полночь) до 23 (11pm - post meridian), которое задает час.
- minutes
- Необязательный аргумент. Поддерживается, если поддерживаются seconds (секунды). Выражается целым числом от 0 до 59, которое задает количество минут.
- seconds
- Необязательный аргумент. Поддерживается, если поддерживаются milliseconds (миллисекунды). Выражается целым числом от 0 до 59, которое задает количество секунд.
- ms
- Необязательный аргумент. Выражается целым числом от 0 до 999, которое задает количество миллисекунд.
Описание
Объект Date представляет собой определенное время, заданное с точностью до миллисекунд. Если значение аргумента превышает верхнюю границу его диапазона или является отрицательным числом, то остальные хранящиеся значения изменяются соответственно. Например, если вы задали 150 секунд, то JScript переопределит это число как две минуты и 30 секунд.
Если число равно NaN, то объект не представляет какой-либо момент времени. Если вы не передаtnt какие-либо параметры в объект Date, то он инициализируется как текущее время (в формате UTC). Задайте переменную типа Date перед тем, как использовать ее.
Диапазон дат, которые могут быть представлены объектом Date, составляет около 285,616 лет в каждую сторону от 1 января 1970 г.
Объект Date содержит два статических метода, которые можно вызвать без создания объекта Date. Это parse и UTC.
Если конструктор Date вызывается без помощи оператора new, то возвращаемый объект Date содержит текущую дату вне зависимости от аргументов, переданных конструктору.
Пример
В примере показано как использовать объект Date:
function DateDemo(){
var d, s = "Today's date is: "; //Объявляем переменные
d = new Date(); //Создаем объект Date
s += (d.getMonth() + 1) + "/"; //Получаем месяц
s += d.getDate() + "/"; //Получаем день
s += d.getYear(); //Получаем год
return(s); //Возвращаем дату
}
Поддержка
Свойства объекта
Методы объекта
- getDate
- getDay
- getFullYear
- getHours
- getMilliseconds
- getMinutes
- getMonth
- getSeconds
- getTime
- getTimezoneOffset
- getUTCDate
- getUTCDay
- getUTCFullYear
- getUTCHours
- getUTCMilliseconds
- getUTCMinutes
- getUTCMonth
- getUTCSeconds
- getVarDate
- getYear
- parse
- setDate
- setFullYear
- sethours
- setmilliseconds
- setminutes
- setMonth
- setSeconds
- setTime
- setUTCDate
- setUTCFullYear
- setUTCHours
- setUTCMilliseconds
- setUTCMinutes
- setUTCMonth
- setUTCSeconds
- setYear
- toDateString
- toGMTString
- toJSON
- toLocaleDateString
- toLocaleString
- toLocaleTimeString
- toString
- toTimeString
- toUTCString
- UTC
- valueOf
Ссылки на источники
https://msdn.microsoft.com/en-us/library/cd9w2te4(v=VS.85).aspx
