Объект Date в JavaScript

Объект-конструктор Date используется для создания объекта времени. Используя объект класса Date, можно задать любое время или получить текущее для данного момента выполнения скрипта. Время можно представить в различных форматах, но для JavaScript время - это количество миллисекунд, прошедших с полуночи 1 января 1970 года по Гринвичу (время зарождения эпохи Unix).

Конструктор Date имеет несколько форматов задания времени в зависимости от переданных аргументов.

new Date()

Если Date вызывается без аргументов, то создаётся объект с текущим временем.

alert(new Date()); /* покажет текущее время */

new Date(дата)

Если передаётся один строковый аргумент, то он интерпретируется как дата в строковом формате.

alert(new Date('Dec 13, 1932')); /* Tue Dec 13 1932 00:00:00 GMT+0000 */

new Date(timestamp)

Если передаётся один числовой аргумент, то он интерпретируется как количество миллисекунд, прошедших с полуночи 1 января 1970 года по Гринвичу.

alert(new Date(3000)); /* Thu Jan 01 1970 00:00:03 GMT+0000 */

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

Если объекту Date передаётся от 2 до 7 целых чисел, то они интерпретируются как непосредственное задание времени. Аргументы последовательно задают год, месяц, день месяца, часы, минуты, секунды и миллисекунды. Примечания:

• Отсчёт месяцев начинается с 0.
• Если указаны не все аргументы, то пропущенные аргументы времени устанавливаются равными 0, а день месяца устанавливается равным 1.
• Данный формат создаёт объект локального (местного) времени, то есть в том часовом поясе, который установлен операционной системой пользователя.
• Если переданные параметры выходят за допустимый диапазон значений, то JavaScript автоматически преобразует их в допустимые диапазоны. Например, если передать 65 секунд, то JavaScript представит их как 1 минуту и 5 секунд.

alert(new Date(1996, 11)); /* Sun Dec 01 1996 00:00:00 GMT+0000 */
alert(new Date(1996, 11, 20, 13, 0, 1800)); /* Fri Dec 20 1996 13:30:00 GMT+0000 (1800 секунд = 30 минут) */
alert(new Date(1996, 11, 20, 13, 23, 40, 300)); /* Fri Dec 20 1996 13:23:40.300 GMT+0000 */

Приведённый выше пример при выполнении в московском часовом поясе вместо GMT+0000 покажет GMT+0300.

alert(Date.length); // 7

var date = new Date();
Date.prototype.prop = 'новое свойство';
alert(date.prop); /* 'новое свойство' */

alert(Date.now()); /* покажет количество миллисекунд */

alert(Date.UTC(1996, 11, 20, 13, 0, 1800)); // 851088600000

alert(Date.parse('Dec 13, 1932')); // -1169262000000

var date = new Date();
alert(date.constructor); /* 'function Date() {[native code]}' */

alert(new Date(123456789)); /* Fri Jan 02 1970 13:17:36 GMT+0300 */

var date = new Date('Jan 02 1970 10:00:00 GMT+0300');
alert(date.toUTCString()); /* Fri, 02 Jan 1970 07:00:00 GMT */

var date = new Date('Jan 02 1970 10:00:00 GMT+0300');
alert(date.toISOString()); /* 1970-01-02T07:00:00.000Z */

var date = new Date('Jan 02 1970 10:00:00 GMT+0300');
alert(date.toDateString()); /* Fri Jan 02 1970 */

var date = new Date('Jan 02 1970 10:00:00 GMT+0300');
alert(date.toTimeString()); /* 10:00:00 GMT+0300 */