Дата и время: встроенный объект 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);     // то же самое в другом формате

Метод 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.