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

В дополнение к многочисленным методам экземпляра в объекте 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>

Метод	Синтаксис	Возвращаемое значение
Date.getDate()	дата.getDate()	день месяца в соответствии с локальным временем. Возвращаемые значения могут находиться в интервале между 1 и 31.
Date.getDay()	дата.getDay()	День недели в соответствии с локальным временем. Возвращает числа от 0 (воскресенье) до 6 (суббота).
Date.getFullYear()	дата.getFullYear()	Год, получаемый, когда дата выражена в локальном времени. Возвращает четыре цифры, а не сокращение из двух цифр.
Date.getHours()	дата.getHours()	Значение поля часов в локальном времени. Возвращаемое значение находится в диапазоне между 0 (полночь) и 23 (11 часов вечера).
Date.getMilliseconds()	дата.getMilliseconds()	Поле миллисекунд в локальном времени.
Date.getMinutes()	дата.getMinutes()	Поле минут в локальном времени. Возвращаемое значение может принимать значения от 0 до 59.
Date.getMonth()	дата.getMonth()	Поле месяца в локальном времени. Возвращаемое значение может принимать значения от 0 (январь) до 11 (декабрь).
Date.getSeconds()	дата.getSeconds()	Поле секунд в аргументе датав локальном времени. Возвращаемое значение может принимать значения от 0 до 59.
Date.getTime()	дата.getTime()	Миллисекундное представление аргумента дата, представляющего собой объект Date, т.е. число миллисекунд между полночью 01.01.1970 и датой/временем, определяемыми дата. Метод getTime() преобразует дату и время в одно целое значение. Это удобно, когда требуется сравнить два объекта Date или определить время, прошедшее между двумя датами. Обратите внимание: миллисекундное представление даты не зависит от часового пояса, поэтому отсутствует метод getUTCTime(), дополняющий данный. Методы Date.parse() и Date.UTC() позволяют преобразовать спецификацию даты и времени в миллисекундное представление, обходя избыточное создание объекта Date.
Date.getTimezoneOffset()	дата.getTimezoneOffset()	Разница в минутах между временем по Гринвичу (GMT) и локальным временем.
Date.getUTCDate()	дата.getUTCDate()	День месяца (значение между 1 и 31), полученный при вычислении даты в универсальном времени.
Date.getUTCDay()	дата.getUTCDay()	День недели, получаемый, когда дата выражена в универсальном времени. Возвращаемые значения могут находиться в интервале между 0 (воскресенье) и 6 (суббота).
Date.getUTCFullYear()	дата.getUTCFullYear()	Год, получаемый, когда дата вычисляется в универсальном времени. Возвращаемое значение – четырехзначный номер года, а не сокращение из двух цифр.
Date.getUTCHours()	дата.getUTCHours()	Поле часов для даты, вычисленное в универсальном времени. Возвращаемое значение – целое между 0 (полночь) и 23 (11 часов вечера).
Date.getUTCMilliseconds()	дата.getUTCMilliseconds()	Поле миллисекунд для даты, выраженное в универсальном времени.
Date.getUTCMinutes()	дата.getUTCMinutes()	Поле минут для даты в универсальном времени. Возвращает целое между 0 и 59.
Date.getUTCMonth()	дата.getUTCMonth()	Месяц года, получающийся, когда дата вычислена в универсальном времени. Возвращает целое между 0 (январь) и 11 (декабрь).
Date.getUTCSeconds()	дата.getUTCSeconds()	Поле секунд даты в универсальном времени. Возвращает целое между 0 и 59.
Date.getYear() Устарел в ECMAScript v3	дата.getYear()	Поле года для указанного аргумента дата, представляющего собой объект Date, минус 1900. Используйте вместо него метод getFullYear().
Date.parse()	Date.parse(дата)	Количество миллисекунд между указанными датой/временем и полночью 1 января 1970 года по Гринвичу. Метод принимает один строковый аргумент, анализирует дату, содержащуюся в строке, и возвращает ее в виде числа миллисекунд, которое может использоваться непосредственно для создания нового объекта Date или для установки даты в существующем объекте Date с помощью Date.setTime().
Date.setDate()	дата.setDate(день_месяца) день_месяца - целое между 1 и 31	Миллисекундное представление измененной даты.
Date.setFullYear()	дата.setFullYear(год) дата.setFullYear(год, месяц) дата.setFullYear(год, месяц, день)	Внутреннее миллисекундное представление измененной даты.
Date.setHours()	дата.setHours(часы) дата.setHours(часы, минуты) дата.setHours(часы, минуты, секунды) дата.setHours(часы, минуты, секунды, миллисекунды)	Миллисекундное представление измененной даты.
Date.setMilliseconds()	дата.setMilliseconds(миллисекунды)	Миллисекундное представление измененной даты.
Date.setMinutes()	дата.setMinutes(минуты) дата.setMinutes(минуты, секунды) дата.setMinutes(минуты, секунды, миллисекунды)	Миллисекундное представление измененной даты.
Date.setMonth()	дата.setMonth(месяц) дата.setMonth(месяц, день)	Миллисекундное представление измененной даты.
Date.setSeconds()	дата.setSeconds(секунды) дата.setSeconds(секунды, миллисекунды)	Миллисекундное представление измененной даты.
Date.setTime()	дата.setTime(миллисекунды) Количество миллисекунд между требуемыми датой/временем и полночью по Гринвичу 1 января 1970 года. Подобное миллисекундное значение может быть также передано конструктору Date() и получено при вызове методов Date.UTC() и Date.parse(). Представление даты в миллисекундном формате делает ее независимой от часового пояса.	Аргумент миллисекунды
Date.setUTCDate()	дата.setUTCDate(день_месяца)	Внутреннее миллисекундное представление измененной даты.
Date.setUTCFullYear()	дата.setUTCFullYear(год) дата.setUTCFullYear(год, месяц) дата.setUTCFullYear(год, месяц, день)	Внутреннее миллисекундное представление измененной даты.
Date.setUTCHours()	дата.setUTCHours(часы) дата.setUTCHours(часы, минуты) дата.setUTCHours(часы, минуты, секунды) дата.setUTCHours(часы, минуты, секунды, миллисекунды)	Внутреннее миллисекундное представление измененной даты.
Date.setUTCMilliseconds()	дата.setUTCMilliseconds(миллисекунды)	Внутреннее миллисекундное представление измененной даты.
Date.setUTCMinutes()	дата.setUTCMinutes(минуты) дата.setUTCMinutes(минуты, секунды) дата.setUTCMinutes(минуты, секунды, миллисекунды)	Внутреннее миллисекундное представление измененной даты.
Date.setUTCMonth()	дата.setUTCMonth(месяц) дата.setUTCMonth(месяц, день)	Внутреннее миллисекундное представление измененной даты.
Date.setUTCSeconds()	дата.setUTCSeconds(секунды) дата.setUTCSeconds(секунды, миллисекунды)	Внутреннее миллисекундное представление измененной даты.
Date.setYear()	дата.setYear(год)	Миллисекундное представление измененной даты. Метод setYear() устанавливает поле год в указанном объекте Date, особым образом обрабатывая интервал времени между 1900 и 1999 годами. По спецификации ECMAScript v3 этот метод не является обязательным в совместимых реализациях JavaScript; вместо него рекомендован метод setFullYear().
Date.toDateString()	дата.toDateString()	Зависящее от реализации и понятное человеку строковое представление даты (без времени в локальном времени.
Date.toGMTString() устарел в ECMAScript v3. Вместо него рекомендуется использовать аналогичный метод Date.toUTCString().	дата.toGMTString()	Строковое представление даты и времени, указанное в аргументе дата, представляющем собой объект Date. Перед преобразованием в строку дата переводится из локального времени во время по Гринвичу.
Date.toLocaleDateString()	дата.toLocaleDateString()	Зависящее от реализации и понятное человеку строковое представление даты (без времени) из объекта дата, выраженное в локальном времени и отформатированное в соответствии с региональными настройками.
Date.toLocaleString()	дата.toLocaleString()	Строковое представление даты и времени, заданных аргументом дата. Дата и время представлены в локальном часовом поясе и отформатированы в соответствии с региональными настройками. При форматировании даты и времени используются региональные настройки, поэтому формат может отличаться на разных платформах и в разных странах.
Date.toLocaleTimeString()	дата.toLocaleTimeString()	Зависящее от реализации и понятное человеку строковое представление данных о времени из объекта дата, выраженное в локальном часовом поясе и отформатированное в соответствии с региональными настройками.
Date.toString()	дата.toString()	Понятное человеку строковое представление даты в локальном часовом поясе. В отличие от toUTCString(), метод вычисляет дату в локальном часовом поясе. В отличие от toLocaleString(), метод toString() может представлять дату и время без учета региональных настроек.
Date.toTimeString()	дата.toTimeString()	Зависящее от реализации, понятное человеку строковое представление данных о времени из объекта дата, выраженное в локальном часовом поясе.
Date.toUTCString()	дата.toUTCString()	Понятное человеку строковое представление даты, выраженное в универсальном времени.
Date.UTC() Создать объект Date, используя спецификацию времени в UTC, можно следующим образом: d=new Date(Date.UTC(1996,4,8, 16,30));	Date.UTC(год, месяц, день, часы, минуты, секунды, мс)	Миллисекундное представление указанного универсального времени. Метод возвращает количество миллисекунд между полночью по Гринвичу 1 января 1970 года и указанным временем.
Date.valueOf()	дата.valueOf()	Миллисекундное представление даты. Возвращаемое значение совпадает со значением, возвращаемым Date.getTime().

Пример 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>