New Date(миллисекунды)

New Date(строка_даты)

New Date(год, месяц, день, часы, минуты, секунды, мс)

Конструктор Date() без аргументов создает объект Date со значением, равным текущим дате и времени.

Если конструктору передается единственный числовой аргумент, он используется как внутреннее числовое представление даты в миллисекундах, аналогичное значению, возвращаемому методом getTime().

Когда передается один строковый аргумент, он рассматривается как строковое представление даты в формате, принимаемом методом Date.parse().

Кроме того, конструктору можно передать от двух до семи числовых аргументов, задающих индивидуальные поля даты и времени. Все аргументы, кроме первых двух – полей года и месяца, – могут отсутствовать. Обратите внимание: эти поля даты и времени задаются на основе локального времени, а не времени UTC (Universal Coordinated Time – универсальное скоординированное время), аналогичного GMT (Greenwich Mean Time – среднее время по Гринвичу). В качестве альтернативы может использоваться статический метод Date.UTC().

Date() может также вызываться как функция (без оператора new). При таком вызове Date() игнорирует любые переданные аргументы и возвращает текущие дату и время.

Аргументы

· Миллисекунды. Количество миллисекунд между нужной датой и полночью 1 января 1970 года (UTC). Например, передав в качестве аргумента число 5000, мы создадим дату, обозначающую пять секунд после полуночи 1 января 1970 года.

· Строка_даты. Единственный аргумент, задающий дату и (необязательно) время в виде строки. Строка должна иметь формат, понятный для Date.parse().

· Год. Год в виде четырех цифр. Например, 2011 для 2011 года. Для совместимости с более ранними реализациями JavaScript к аргументу добавляется 1900, если значение аргумента находится между 0 и 99.

· Месяц. Месяц, заданный в виде целого от 0 (январь) до 11 (декабрь).

· День. День месяца, заданный в виде целого от 1 до 31. Обратите внимание, что наименьшее из значений этого аргумента равно 1, а остальных аргументов – 0. Необязательный аргумент.

· Часы. Часы, заданные в виде целого от 0 (полночь) до 23 (11 часов вечера). Необязательный аргумент.

· Минуты. Минуты в часах, указанные в виде целого от 0 до 59. Необязательный аргумент.

· Секунды. Секунды в минутах, указанные в виде целого от 0 до 59. Необязательный аргумент.

· Мс. Миллисекунды в секунде, указанные в виде целого от 0 до 999. Необязательный аргумент.

Статические методы

В дополнение к многочисленным методам экземпляра в объекте Date определены два статических метода. Эти методы вызываются через сам конструктор Date(), а не через отдельные объекты Date:

Date.parse() //Анализирует строковое представление даты и времени и возвращает внутреннее представление этой даты в миллисекундах.

Date.UTC() //Возвращает миллисекундное представление указанной даты и времени UTC.

Методы

У объекта Date нет доступных для записи или чтения свойств; вместо этого доступ к значениям даты и времени выполняется через методы. Большинство методов объекта Date имеют две формы: одна для работы с локальным временем, другая – с универсальным временем (UTC или GMT). Например, обозначение get[UTC]Day() относится к двум методам: getDay() и getUTCDay().

Стандарт ECMAScript требует, чтобы объект Date мог представить любые дату и время с миллисекундной точностью в пределах 100 миллионов дней до и после 01.01.1970. Этот диапазон равен ±273785 лет, поэтому JavaScript-часы будут правильно работать до 275755 года.

Обычное применение объекта Date – это вычитание миллисекундного представления текущего времени из другого времени для определения относительного местоположения двух временных меток. Следующий пример клиентского кода показывает два таких применения:

<script language="JavaScript">

today = new Date();// Запоминаем сегодняшнюю дату

christmas = new Date(); //Получаем дату из текущего года

christmas.setMonth(11); //Устанавливаем месяц декабрь...

christmas.setDate(25); //и 25-е число

/*Если Рождество еще не прошло, вычисляем количество миллисекунд между текущим моментом и Рождеством, преобразуем его в количество дней и печатаем сообщение*/

if (today.getTime() < christmas.getTime()) {

difference = christmas.getTime()- today.getTime();

difference = Math.floor(difference / (1000 * 60 * 60 * 24));

document.write('<p>Всего ' + difference + ' дней до Рождества!</p>'); }

</script>

//... остальная часть HTML_документа ...

<script language="JavaScript">

/*Здесь мы используем объекты Date для измерения времени

Делим на 1000 для преобразования миллисекунд в секунды*/

now = new Date();

document.write('<p>Страница загружалась' + (now.getTime()-

today.getTime()) /1000 + 'секунд. </p>');

//Этот оператор должен занимать одну строку!

</script>

Пример 1: Показывает текущее время на странице.

<html> <head>

<script language="JavaScript">

<!--

function disptime() {

var time = new Date();

var hour = time.getHours();

var minute = time.getMinutes();

var second = time.getSeconds();

var temp = ""+((hour>12)? hour - 12 : hour);

temp += ((minute < 10) ? ":0" : ":") + minute;

temp += ((second < 10) ? ":0" : ":") + second;

temp += (hour >= 12) ? " P.M." : " A.M.";

document.MyPage.digits.value = temp;

id = setTimeout("disptime()",1000); }

//-->

</script> </head>

<body onload="disptime()">

<p>Time and Tide wait for none. </p> <br><br>

<p>The time is displayed on the page. </p> <br><br><br>

<form name="MyPage">

<input type="text" name="digits" size=12 value="">

</form>

</body>

</html>

Пример 2: Показывает текущую дату.

<html>

<head> <title> today's date </title> </head>

<body>

<script language="JavaScript">

mydate=new Date();

document.write("Today's Date is: "+ mydate.getDate());

</script>

</body>

</html>