Методы объекта Date
Методы, предоставляемые объектом Date для управления датой и временем, можно подразделить на следующие категории:
методы установки (set) - методы для установки даты и времени у экземпляров объекта Date;
методы определения (get) - методы для определения даты и времени у экземпляров объекта Date;
методы преобразования (to) - методы для преобразования даты и времени в строки;
методы для обработки даты.
Методы для установки и определения могут использоваться для получения/изменения значений секунд, минут, часов, дня в месяце, дня недели, месяца и года. Например, есть метод getDay, позволяющий узнать день недели, но нет метода setDay, так как день недели устанавливается автоматически.
Метод |
Описание |
getDate |
Возвращает день месяца как целое число от 1 до 31. |
getDay |
Возвращает день недели как целое число от 0 (воскресенье) до 6 (суббота). |
getHours |
Возвращает число часов как целое от 0 до 23. |
getMinutes |
Возвращает число минут как целое от 0 до 59. |
getMonth |
Возвращает номер месяца как целое от 0 (январь) до 11 (декабрь). |
getSeconds |
Возвращает число секунд как целое от 0 до 59. |
getTime |
Возвращает число миллисекунд между 1 января 1970 года, 00:00:00 и датой, заданной объектом Date. |
getTimeZoneOffset |
Возвращает число минут, составляющих разницу между локальным временем и временем по Гринвичу. |
getYear |
Возвращает две последние цифры года. |
parse |
Возвращает число миллисекунд между 1 января 1970 года, 00:00:00 и датой, заданной в виде строки. |
setDate |
Устанавливает день месяца. |
setHours |
Устанавливает число часов. |
setMinutes |
Устанавливает число минут. |
setMonth |
Устанавливает номер месяца. |
setSeconds |
Устанавливает число секунд. |
setTime |
Устанавливает время. |
setYear |
Устанавливает год. |
toGMTString |
Преобразует локальное время во время по Гринвичу и возвращает его в виде строки. |
toLocaleString |
Преобразует время по Гринвичу в локальное время и возвращает его в виде строки. |
UTC |
Возвращает число миллисекунд между 1 января 1970 года, 00:00:00 и датой, указанной в виде параметра. |
Все методы объекта Date используют целочисленные значения, приводимые в следующей таблице.
Значение |
Диапазон |
Число секунд и минут |
0..59 |
Число часов |
0..23 |
День недели |
0..6 |
Дата |
1..31 |
Месяц |
0..11 (Январь..Декабрь) |
Год |
Число лет с 1990 |
Рассмотрим следующий пример. Предположим, вы задали дату 15 мая 1996 года. Ниже показано использование ряда методов объекта Date
<!----------------------------------------------------------------------------------------------------------------- DATE2.HTM
— Различные
методы объекта Date «JavaScript
для всех» Алексей
Федоров,
1998 ------------------------------------------------------------------------------------------------------------------> <html> <head><title>JavaScript
Demos</title></head> <body> <center> <p> <script
language="JavaScript"> someDate
=
new Date("May
15,1996");
document.write("someDate ="+someDate+"<br>");
document.write("getDay ="+someDate.getDay()+"<br>");
document.write("getMonth ="+someDate.getMonth()+"<br>");
document.write("getYear ="+someDate.getYear()+'<br>'); </script> </center> </body> </html>
Пример отображения данного документа в браузере:
Различные методы объекта Date
Методы
getTime
и setTime
удобно использовать для сравнения дат.
Метод getTime
возвращает число миллисекунд. Например,
ниже показано, как узнать число дней,
оставш
<!----------------------------------------------------------------------------------------------------------------- DATE3.HTM
— Различные
методы объекта Date «JavaScript
для всех» Алексей
Федоров,
1998 ------------------------------------------------------------------------------------------------------------------> <html> <head><title>JavaScript
Demos</title></head> <body> <center> <br><br><br> <script
language="JavaScript"> today
= new Date(); //задать
дату endYear
=
new Date("December
31, 1990"); //
поменять
год
endYear.setYear(today.getYear()); //вычислить
число миллисекунд в дне msPerDay
=24*60*60*1000; //получить
число
дней daysLeft
= (endYear.getTime()
-
today.getTime())
/
msPerDay; //округлить daysLeft
=
Math.round(daysLeft); //показать
document.write("B
году осталось дней: "
+ daysLeft); </script></center> </body> </html>
Пример отображения данного документа в браузере показан ниже.
М
SomeDate = new Date(); SomeDate.setTime(Date.parse("May
15,1996"));
Завершим рассмотрение объекта Date небольшим практическим примером. Мы создадим программу, выводящую текущие дату и время, когда пользователь вошел на данную страницу.
<!---------------------------------------------------------------------------------------------------------------- DATE4.HTM
— Отображение
даты и времени «JavaScript
для всех» Алексей
Федоров,
1998 -----------------------------------------------------------------------------------------------------------------> <html> <head><title>JavaScript
Demos</title> <script
language="JavaScript"> //
Названия месяцев mNames
= new
Array("января",
"февраля", "марта", "апреля",
"мая",
"июня", "июля", "августа",
"сентября",
"октября",
"ноября", "декабря") //
Названия дней недели dNames
= new
Array("воскресенье",
"понедельник", "вторник",
"среда",
"четверг", "пятница", "суббота") function
showDateTime() { var
now
=
new Date() var
s s
= "Вы
зашли на эту страницу <b>" s
+=
now.getDate()
+" " +
mNames[now.getMonth()]+" 19"+
now.getYear()
+
" </b>года<br>" s
+=
"в
<b>"
+
now.getHours()
+":" +
now.getMinutes() +":"
+
now.getSeconds()
+
"</b><br>" s
+=
"Сегодня
- <b>" + dNames[now.getDay()]
+
"</b>" document.write(s) } </script> </head> <body> <center> <script
language="JavaScript"> showDateTime() </script> </body> </html>
Данная программа построена вокруг функции showDateTime, которая с помощью метода document.write выводит на экран текущие дату и время. Мы узнаем текущие дату и время из нового экземпляра объекта Date с помощью методов getDate, getMonth, getYear и getHours, getMinutes и getSeconds. Для отображения названия месяца и дня недели мы используем два массива — массив mNames, в котором перечислены названия месяцев в нужном нам падеже, и массив dNames в котором перечислены названия дней недели. Так как 0 соответствует воскресенью, первый элемент массива dNames – это "воскресенье".