Объект Date
Для представления дат в программе JavaScript используется объект Date. Он создается, как и любой объект в JavaScript, оператором new с помощью конструктора Date. Синтаксис оператора создания даты следующий:
имя объекта дата = new Date ( [параметры] ) ;
Если в конструкторе даты отсутствуют параметры, то значением объекта будет текущая дата. Параметром конструктора может быть строка Вида "месяц день, год часы:минуты:секунды". Ниже представлены три способа инициализации объекта Date:
today = new Date()
Xmas = new Date("January 7 1999 12:00:00")
Xmas = new Date(99, 1, 7)
Xmas = new Date(99, 1, 7, 12, 0, 0)
В общем виде:
dateObj = new Date(dateVal)
dateObj = new Date(year, month, date[, hours, minutes, seconds, ms] )
Аргументы:
dateVal – если параметр является числовым, то он интерпретируется как количество миллисекунд от 1-Янв-1970 00:00. Если строкой, то она разбирается и интерпретируется как дата по стандартным правилам Date.parse.
year – год в формате YYYY
month – месяц от 0 (Янв) до 11 (Дек)
date – день месяца от 1 до 31
hours – параметр должен быть указан, если указан параметр minutes. Устанавливает кол-во часов от 0 до 23
minutes – параметр должен быть указан, если указан параметр seconds. Устанавливает количество минут: от 0 до 59
seconds – параметр должен быть указан, если указан параметр ms. Устанавливает количество секунд: от 0 до 59
ms – количество миллисекунд: от 0 до 999.
Дата измеряется в миллисекундах, начиная от полуночи 01 января 1970 года GMT+0. День содержит 86,400,000 миллисекунд.
Методами объекта Date можно получать и устанавливать отдельно значения года, месяца, дня недели, часов, минут и секунд. Например, метод getYear() возвращает год, метод setYear() устанавливает значение года объекта Date. Метод getTime () возвращает число миллисекунд, прошедшее с момента времени 1 января 1970 года 00:00:00, метод setTime() устанавливает соответствующее значение даты в миллисекундах, заданных в качестве параметра.
Методы объекта Date
Метод |
Описание |
Date.parse |
получает строку с датой (напр. "Jan 03, 2000") и возвращает целое число, представляющее собой количество миллисекунд, истекших с полуночи 1 января 1970 года |
toLocaleString |
возвращает String-объект, содержащий дату в длинном формате по умолчанию |
getDate |
Возвращает целое число от 1 до 31 |
getDay |
возвращает целое число, обозначающее день недели: 0 - воскресенье, 1 - понедельник, 2 - вторник, и т.д. |
getFullYear |
Возвращает полное значение года. Для дат от 1000 до 9999 года getFullYear возвращает четырёхзначное число |
getMilliseconds |
Возвращает целое число от 0 до 999 |
getMinutes |
Возвращает целое число от 0 до 59 |
getSeconds |
Возвращает целое число от 0 до 59 |
getTimezoneOffset |
Смещение часового пояса равняется разнице между универсальным (UTC) и местным временем в минутах |
getUTCDate |
Возвращает целое число от 1 до 31 |
getUTCDay |
возвращает целое число, обозначающее день недели: 0 - воскресенье, 1 - понедельник, 2 - вторник, и т.д. |
getUTCHours |
Возвращает целое число от 0 до 23 |
getHours |
Возвращает целое число от 0 до 23 |
getUTCMilliseconds |
Возвращает целое число от 0 до 999 |
getUTCMinutes |
Возвращает целое число от 0 до 59 |
getUTCSeconds |
Возвращает целое число от 0 до 59 |
setSeconds |
Устанавливает секунды от 0 до 59 |
setFullYear |
setFullYear(yearValue[, monthValue[, dayValue]]) |
setMilliseconds |
Устанавливает миллисекунды от 0 до 999 |
setTime |
Устанавливает дату по количеству миллисекунд, прошедших с полуночи 1 января 1970 года по универсальному времени |
setYear |
Устанавливает год по двузначному значению (не рекомендуется) |
setDate |
Устанавливает день от 1 до 31 |
setUTCDate |
Устанавливает день от 1 до 31 |
setUTCHours |
setUTCHours(hoursValue[, minutesValue[, secondsValue[, msValue]]]) |
setHours |
setHours(hoursValue[, minutesValue[, secondsValue[, msValue]]]) |
setUTCMilliseconds |
Устанавливает миллисекунды от 0 до 999 |
setUTCMinutes |
setUTCMinutes(minutesValue[, secondsValue[, msValue]]) |
setMinutes |
setMinutes(minutesValue[, secondsValue[, msValue]]) |
setMonth |
setMonth(monthValue[, dayValue]) |
setUTCSeconds |
Устанавливает секунды от 0 до 59 |
setUTCFullYear |
setUTCFullYear(yearValue[, monthValue[, dayValue]]) |
setUTCMonth |
setUTCMonth(monthValue[, dayValue]) monthValue - значение от 0 до 11, обозначающее месяц от января до декабря; dayValue -значение от 1 до 31, обозначающее день месяца |
toGMTString |
возвращает строку, содержащее текстовое представление даты и времени по Гринвичу на английском языке в американском формате (не рекомендуется) |
toLocaleFormat |
Выводит дату на основании предложенного формата |
toLocaleTimeString |
Выводит местное время |
toLocaleDateString |
Выводит дату |
toString |
всегда возвращает строку, представляющую дату на английском языке в американском формате |
toTimeString |
Выводит время и часовой пояс |
toDateString |
Выводит дату без времени |
toUTCString |
возвращает строку на английском языке в американском формате, согласно универсальному часовому поясу (Гринвичу) |
getUTCFullYear |
Возвращает полное значение года |
getMonth |
Возвращает целое число от 0 до 11. 0 соответствует январю, 1 - февралю, и т.д. |
Date.UTC |
Date.UTC(year, month, day[, hours[, minutes[, seconds[,ms]]]]) Year - год. Если он меньше 100, то к нему прибавляется 1900. Month - номер месяца в диапазоне от 0 до 11 (0 = январь, 1 = февраль, ... , 11 = декабрь). Date - день месяца в диапазоне от 1 до 31. Hours - число от 0 до 23 (от полуночи до 23:00), представляющее час. Применяется, если указывается аргумент minutes. Minutes - число от 0 до 59, представляющее минуты. Применяется, если указывается аргумент seconds. Seconds - число от 0 до 59, представляющее секунды. Ms - число от 0 до 999, представляющее миллисекунды. Метод UTC возвращает количество миллисекунд, истекших с полуночи 1 января 1970 года и указанной датой, используя время в формате UTC. |
getUTCMonth |
Возвращает целое число от 0 до 11. 0 соответствует январю, 1 - февралю, и т.д. |
getTime |
возвращает число, равное количеству миллисекунд, прошедших с полуночи 1 января 1970 года GMT |
valueOf |
функционально эквивалентен методу getTime. Этот метод является служебным и обычно не вызывается явно в коде. |
getYear |
возвращает значение года минус 1900 (не рекомендован) |
Методы UTC работают для зоны GTC (по Гринвичу).