Дата и время: встроенный объект Date

Объект Date предназначен для манипуляций с датами и временами. Его примитивным значением является число, равное количеству миллисекунд относительно базового времени, равного полуночи 1 января 1970 г. по Гринвичскому меридиану (UTC, Universal Coordinated Time). Если это значение равно NaN, то оно считается неопределенным.

День состоит из 86400000 миллисекунд. Диапазон значений Date от -100000000 дней до 100000000 дней относительно базового времени, что приблизительно равно 285616 лет в каждую сторону отсчета.

Для создания объектов Date используются следующие конструкторы:

new Date()
new Date(число)
new Date(строка)
new Date(год, месяц, день [,часы [,минуты [,секунды [,мс]?]?]?]?)

Здесь:

• число — числовое выражение, задающее примитивное значение объекта в миллисекундах;
• строка — строковое выражение, задающее дату и время в формате, описанном в методе parse;
• год — числовое выражение, задающее полный номер года (например, 1988, а не 88);
• месяц — числовое выражение, задающее номер месяца (0 = январь, 1 = февраль, …, 11 = декабрь);
• день — числовое выражение, задающее номер для в месяце от 1 до 31;
• часы — необязательное числовое выражение, задающее номер часа от 0 до 23;
• минуты — необязательное числовое выражение, задающее номер минуты от 0 до 59;
• секунды — необязательное числовое выражение, задающее номер секунды от 0 до 59;
• мс — необязательное числовое выражение, задающее номер миллисекунды от 0 до 999.

Первый конструктор создает объект Date с текущей датой и временем по местному времени. Остальные конструкторы создают объект Date с датой и временем, заданными аргументами конструктора.

Примеры:

var a = new Date();		           // текущие дата и время
var b = new Date("May 21, 1958 10:15 AM"); // заданные дата и время
var c = new Date(1958, 4, 21, 10, 15);     // то же самое в другом формате

Свойства объекта Date

Свойство	Описание	Член прототипа
constructor	Конструктор, который создал объект.	Да
prototype	Ссылка на прототип класса объектов.	Нет

Методы объекта Date

Метод	Описание	Член прототипа
getDate	Возвращает день месяца по местному времени.	Да
getDay	Возвращает день недели по местному времени.	Да
getFullYear	Возвращает полный номер года по местному времени.	Да
getHours	Возвращает часы по местному времени.	Да
getMilliseconds	Возвращает миллисекунды по местному времени.	Да
getMinutes	Возвращает минуты по местному времени.	Да
getMonth	Возвращает месяц по местному времени.	Да
getSeconds	Возвращает секунды по местному времени.	Да
getTime	Возвращает примитивное значение объекта.	Да
getTimezoneOffset	Возвращает разницу в минутах между местным временем и UTC.	Да
getUTCDate	Возвращает день месяца по времени UTC.	Да
getUTCDay	Возвращает день недели по времени UTC.	Да
getUTCFullYear	Возвращает полный номер года по времени UTC.	Да
getUTCHours	Возвращает часы по времени UTC.	Да
getUTCMilliseconds	Возвращает миллисекунды по времени UTC.	Да
getUTCMinutes	Возвращает минуты по времени UTC.	Да
getUTCMonth	Возвращает месяц по времени UTC.	Да
getUTCSeconds	Возвращает секунды по времени UTC.	Да
getVarDate	Возвращает примитивное значение объекта в формате VT_DATE.	Нет
getYear	Возвращает номер года по местному времени.	Да
parse	Преобразует дату, заданную строкой, в количество миллисекунд относительно базового времени.	Нет
setDate	Устанавливает день месяца по местному времени.	Да
setFullYear	Устанавливает полный номер года по местному времени.	Да
setHours	Устанавливает часы по местному времени.	Да
setMilliseconds	Устанавливает миллисекунды по местному времени.	Да
setMinutes	Устанавливает минуты по местному времени.	Да
setMonth	Устанавливает месяц по местному времени.	Да
setSeconds	Устанавливает секунды по местному времени.	Да
setTime	Устанавливает примитивное значение объекта.	Да
setUTCDate	Устанавливает день месяца по времени UTC.	Да
setUTCFullYear	Устанавливает полный номер года по времени UTC.	Да
setUTCHours	Устанавливает часы по времени UTC.	Да
setUTCMilliseconds	Устанавливает миллисекунды по времени UTC.	Да
setUTCMinutes	Устанавливает минуты по времени UTC.	Да
setUTCMonth	Устанавливает месяц по времени UTC.	Да
setUTCSeconds	Устанавливает секунды по времени UTC.	Да
setYear	Устанавливает номер года по местному времени.	Да
toDateString	Преобразует примитивное значение объекта в строку даты.	Да
toGMTString	Преобразует примитивное значение объекта в строку даты и времени по Гринвичскому меридиану.	Да
toLocaleDateString	Преобразует примитивное значение объекта в строку даты в формате операционной системы.	Да
toLocaleString	Преобразует примитивное значение объекта в строку даты и времени в формате операционной системы.	Да
toLocaleTimeString	Преобразует примитивное значение объекта в строку времени в формате операционной системы.	Да
toString	Преобразует примитивное значение объекта в строку.	Да
toTimeString	Преобразует примитивное значение объекта в строку времени.	Да
toUTCString	Преобразует примитивное значение объекта в строку даты и времени по UTC.	Да
UTC	Возвращает примитивное значение объекта по времени UTC.	Нет
valueOf	Возвращает примитивное значение объекта.	Да

Метод getDate

Синтаксис: дата.getDate()
Результат: числовое значение

Метод getDate преобразует примитивное значение объекта дата в номер дня месяца по местному времени и возвращает его. Результатом является целое число в диапазоне от 1 до 31. Например, сценарий

var xmas = new Date("December 25, 1999 23:59:59");
document.write(xmas.getDate());

выведет на экран обозревателя число 25.

Метод getDay

Синтаксис: дата.getDay()
Результат: числовое значение

Метод getDay преобразует примитивное значение объекта дата в номер дня недели по местному времени и возвращает его. Результатом является целое число в диапазоне от 0 до 6:

0 = воскресенье, 1 = понедельник, 2 = вторник, 3 = среда, 4 = четверг, 5 = пятница, 6 = суббота.

Например, сценарий

var xmas = new Date("December 25, 1999 23:59:59");
document.write(xmas.getDay());

выведет на экран обозревателя число 6 (т. е. рождество в 1999 г. пришлось на субботу).

Метод getFullYear

Синтаксис: дата.getFullYear()
Результат: числовое значение

Метод getFullYear преобразует примитивное значение объекта дата в полный (четырехзначный) номер года по местному времени и возвращает его. Например, сценарий

var today = new Date();
document.write(today.getFullYear());

выведет на экран обозревателя число 2000.

Метод getHours

Синтаксис: дата.getHours()
Результат: числовое значение

Метод getHours преобразует примитивное значение объекта дата в номер часа по местному времени и возвращает его. Результатом является целое число в диапазоне от 0 до 23. Например, сценарий

var xmas = new Date("December 25, 1999 23:59:59");
document.write(xmas.getHours());

выведет на экран обозревателя число 23.

Метод getMilliseconds

Синтаксис: дата.getMilliseconds()
Результат: числовое значение

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

var xmas = new Date("December 25, 1999 23:59:59");
document.write(xmas.getMilliseconds());

выведет на экран обозревателя число 0.

Метод getMinutes

Синтаксис: дата.getMinutes()
Результат: числовое значение

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

var xmas = new Date("December 25, 1999 23:59:59");
document.write(xmas.getMinutes());

выведет на экран обозревателя число 59.

Метод getMonth

Синтаксис: дата.getMonth()
Результат: числовое значение

Метод getMonth преобразует примитивное значение объекта дата в номер месяца по местному времени и возвращает его. Результатом является целое число в диапазоне от 0 до 11: 0 = январь, 1 = февраль, 2 = март, 3 = апрель, 4 = май, 5 = июнь, 6 = июль, 7 = август, 8 = сентябрь, 9 = октябрь, 10 = ноябрь, 11 = декабрь.

Например, сценарий

var xmas = new Date("December 25, 1999 23:59:59");
document.write(xmas.getMonth());

выведет на экран обозревателя число 11.

Метод getSeconds

Синтаксис: дата.getSeconds()
Результат: числовое значение

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

var xmas = new Date("December 25, 1999 23:59:59");
document.write(xmas.getSeconds());

выведет на экран обозревателя число 59.

Метод getTime

Синтаксис: дата.getTime()
Результат: числовое значение

Метод getTime возвращает примитивное значение объекта дата. Этот метод полезен для копирования значения одного объекта Date в другой. Пример:

var d1 = new Date("May 21, 1958");
var d2 = new Date();
d2.SetTime(d1.GetTime());	// теперь значения этих объектов равны

Метод getTimezoneOffset

Синтаксис: дата.getTimezoneOffset()
Результат: числовое значение

Метод getTimezoneOffset возвращает разницу в минутах между временем UTC и местным временем (т. е. временем компьютера, на котором выполняется сценарий). Из-за переходов на летнее и зимнее время эта разница в течение года может изменяться. Для перевода местного времени в UTC следует прибавить к нему полученное значение.

Если, например, следующий сценарий

var today = new Date();
document.write(today.getTimezoneOffset() / 60);

выполняется на компьютере, находящемся в Екатеринбурге, то он выведет на экран обозревателя число -6. Это означает, что время в Екатеринбурге на 6 часов больше, чем UTC.

Метод getUTCDate

Синтаксис: дата.getUTCDate()
Результат: числовое значение

Метод getUTCDate преобразует примитивное значение объекта дата в номер дня месяца по времени UTC и возвращает его. Результатом является целое число в диапазоне от 1 до 31. Например, сценарий

var today = new Date();
document.write(today.getUTCDate());

выведет на экран обозревателя сегодняшний день месяца.

Метод getUTCDay

Синтаксис: дата.getUTCDay()
Результат: числовое значение

Метод getUTCDay преобразует примитивное значение объекта дата в номер дня недели по времени UTC и возвращает его. Результатом является целое число в диапазоне от 0 до 6:

0 = воскресенье, 1 = понедельник, 2 = вторник, 3 = среда, 4 = четверг, 5 = пятница, 6 = суббота.

Например, сценарий

var today = new Date();
document.write(today.getUTCDay());

выведет на экран обозревателя сегодняшний день недели.

Метод getUTCFullYear

Синтаксис: дата.getUTCFullYear()
Результат: числовое значение

Метод getUTCFullYear преобразует примитивное значение объекта дата в полный (четырехзначный) номер года по времени UTC и возвращает его. Например, сценарий

var today = new Date();
document.write(today.getUTCFullYear());

выведет на экран обозревателя номер текущего года.

Метод getUTCHours

Синтаксис: дата.getHours()
Результат: числовое значение

Метод getUTCHours преобразует примитивное значение объекта дата в номер часа по времени UTC и возвращает его. Результатом является целое число в диапазоне от 0 до 23. Например, сценарий

var today = new Date();
document.write(today.getUTCHours());

выведет на экран обозревателя текущее количество часов.

Метод getUTCMilliseconds

Синтаксис: дата.getUTCMilliseconds()
Результат: числовое значение

Метод getUTCMilliseconds преобразует примитивное значение объекта дата в микросекунды по времени UTC и возвращает его. Результатом является целое число в диапазоне от 0 до 999. Например, сценарий

var today = new Date();
document.write(today.getUTCMilliseconds());

выведет на экран обозревателя текущее количество миллисекунд.

Метод getUTCMinutes

Синтаксис: дата.getUTCMinutes()
Результат: числовое значение

Метод getUTCMinutes преобразует примитивное значение объекта дата в минуты по времени UTC и возвращает его. Результатом является целое число в диапазоне от 0 до 59. Например, сценарий

var today = new Date();
document.write(today.getUTCMinutes());

выведет на экран обозревателя текущее количество минут.

Метод getUTCMonth

Синтаксис: дата.getUTCMonth()
Результат: числовое значение

Метод getUTCMonth преобразует примитивное значение объекта дата в номер месяца по времени UTC и возвращает его. Результатом является целое число в диапазоне от 0 до 11: 0 = январь, 1 = февраль, 2 = март, 3 = апрель, 4 = май, 5 = июнь, 6 = июль, 7 = август, 8 = сентябрь, 9 = октябрь, 10 = ноябрь, 11 = декабрь.

Например, сценарий

var today = new Date();
document.write(today.getUTCMonth());

выведет на экран обозревателя номер текущего месяца.

Метод getUTCSeconds

Синтаксис: дата.getSeconds()
Результат: числовое значение

Метод getUTCSeconds преобразует примитивное значение объекта дата в секунды по времени UTC и возвращает его. Результатом является целое число в диапазоне от 0 до 59. Например, сценарий

var today = new Date();
document.write(today.getUTCSeconds());

выведет на экран обозревателя текущее количество секунд.

Метод getVarDate

Синтаксис: дата.getVarDate()
Результат: числовое значение

Метод getVarDate преобразует примитивное значение объекта дата в формат VT_DATE и возвращает его. Результат зависит от региональных настроек и не используется JavaScript. Поэтому этот метод предназначен исключительно для взаимодействия с COM-объектами, объектами ActiveX или с языками, которые используют формат даты VT_DATE (таковы, например, Visual Basic и VBScript).

Метод getYear

Синтаксис: дата.getYear()
Результат: числовое значение

Метод getYear преобразует примитивное значение объекта дата в номер года по местному времени и возвращает его. Этот метод является устаревшим и поддерживается только в целях совместимости; вместо него следует пользоваться методом getFullYear.

Например, сценарий

var today = new Date();
document.write(today.getYear());

выведет на экран Internet Explorer число 2000, а на экран Netscape Navigator число 100.