Объект Date

Обеспечивает основные возможности сохранения и извлечения даты и времени.

Синтаксис

dateObj = new Date()
dateObj = new Date(dateVal)
dateObj = new Date(year, month, date[, hours[, minutes[, seconds[,ms]]]])

Параметры

dateObj

Имя переменной, которой присваивается объект Date.

dateVal

Если параметр является числовым, то он интерпретируется как количество миллисекунд от 1-Янв-1970 00:00.
Если строкой, то она разбирается и интерпретируется как дата по стандартным правилам Date.parse.

year

Год в формате YYYY.

month

Месяц от 0 (Янв) до 11 (Дек).

date

День месяца от 1 до 31.

hours

Параметр должен быть указан, если указан параметр minutes. Устанавливает кол-во часов от 0 до 23.

minutes

Параметр должен быть указан, если указан параметр seconds. Устанавливает количество минут: от 0 до 59.

seconds

Параметр должен быть указан, если указан параметр ms. Устанавливает количество секунд: от 0 до 59.

ms

Количество миллисекунд: от 0 до 999.

Date поддерживает как методы для работы в зоне UTC (GMT+0), так и методы для работы с местным временем.
Местное время - это то, которое установлено на компьютере, на котором выполняется JavaScript.

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

var today = new Date();   // получить текущую дату

При вызове с одним аргументом - строкой, строка разбирается и интерпретируется как дата, так же, как и в функции Date.parse.

//		используется редко
var date = new Date("21 May 1958 10:12") // создать дату из строкии

При объявлении с несколькими аргументами, отсутствующие аргументы автоматически считаются равными 0.

new Date(1)           //Thu Jan 01 1970 03:00:00 GMT+0300 (Russian Standard Time)
new Date(1,2)         // Fri Mar 01 1901 00:00:00 GMT+0300 (Russian Standard Time)
new Date(1,2,3)       // Sun Mar 03 1901 00:00:00 GMT+0300 (Russian Standard Time)
new Date(1,2,3,4)     // Sun Mar 03 1901 04:00:00 GMT+0300 (Russian Standard Time)
new Date(1,2,3,4,5)   // Sun Mar 03 1901 04:05:00 GMT+0300 (Russian Standard Time)
new Date(1,2,3,4,5,6) // Sun Mar 03 1901 04:05:06 GMT+0300 (Russian Standard Time)

Функции

Функция	Описание
Date.now	Возвращает число миллисекунд между 1 января 1970 г. и текущими датой и временем.
Date.parse	Выполняет синтаксический анализ строки, содержащей дату, и возвращает количество миллисекунд, истекших с полуночи 1 января 1970 г.
Date.UTC	Возвращает количество миллисекунд, истекших с полуночи 1 января 1970 года до указанной даты, используя время в формате UTC (или время GMT).

Методы

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

Date.now

Получает текущие дату и время

Синтаксис

Date.now()

Возвращаемое значение

Количество миллисекунд между полуночью 1 января 1970 и текущей датой и временем.

Его использование особенно рекомендуется там, где производительность при работе с датами критична. Обычно это не на веб-страницах, а, к примеру, в разработке игр на JavaScript.

Примеры

var start = Date.now();
var response = prompt("Как вас зовут?", "");
var end = Date.now();
var elapsed = (end - start) / 1000;
alert (response + "! Вы думали " + elapsed + " секунд");

Date.parse

Выполняет синтаксический анализ строки, содержащей дату, и возвращает количество миллисекунд, истекших с полуночи 1 января 1970 г.

Синтаксис

Date.parse(dateVal)

Параметры

dateVal: Строка, содержащая дату в стандартном строковом формате.

Возвращаемое значение

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

Описание

Функция Date.parse получает строку с датой (напр. "Jan 03, 2000") и возвращает целое число, представляющее собой количество миллисекунд, истекших с полуночи 1 января 1970 года GMT+0 до даты, указанной в параметре dateVal.

Это статический метод, который можно вызывать без создания объекта даты, поэтому для доступа к нему используется форма Date.parse, а не объект.parse.

В случае, если метод Date.parse не смог разобрать переданную ему в качестве параметра строку, он возвращает значение NaN.

Правила разбора строки

Поддерживается стандарт IETF standard (RFC 1123, раздел 5.2.14 и т.д.)

Существуют следующие правила перевода даты из текстовой строки:

Для краткого формата даты допускается использование разделителей "/" или "-", но порядок элементов должен быть строго "месяц/день/год", например "7/20/96".
Для полного формата даты порядок указания элементов может быть произвольным. Если используется два знака для обозначения года, то число должно быть меньше 70 для указания 21-го века. Например "July 10 1995".
Любой текст в круглых скобках рассматривается как комментарии. Комментарии могут быть вложенными, например: "July 10 1995 (this (1234) is a comment)".
Запятые и пробелы рассматриваются как разделители, могут повторяться.
Месяца и дни недели должны иметь два и больше знаков. Если в двузначном написании элементы становятся идентичными, то используется последнее значение, например "Ju" это Июль, а не Июнь.
Если в полном формате даты указан неверный день недели, то он игнорируется.
JavaScript обрабатывает все стандартные временные зоны, включая UTC и GMT.
Значения для часов, минут и секунд могут быть пропущены, например "10:", "10:11", и "10:11:12".
Если время указано в 24-часовом формате, то указание полудня считается ошибкой, например "23:15 PM" - ошибка.
Строка, содержащая неправильную дату - ошибочна. Например, строка содержащая два года или два месяца.

Примеры

var d = new Date();
d.setTime(Date.parse("21 May 1958 10:12"));
alert ( d.toLocaleString() ); // Wednesday, May 21, 1958 10:12:00

Следующий пример возвращает разницу между предоставленной датой и 01.01.1970.

var minMilli = 1000 * 60;
var hrMilli = minMilli * 60;
var dyMilli = hrMilli * 24;

var testDate = new Date("June 1, 2017");
var ms = Date.parse(testDate);
var days = Math.round(ms / dyMilli);

var dateStr = "";
dateStr +=  days + " дней ";
dateStr += "между  01.01.1970 и " + testDate;
alert (dateStr);

Date.UTC

Возвращает количество миллисекунд, истекших с полуночи 1 января 1970 года по времени в формате UTC (или GMT) до заданной даты.

Синтаксис

Date.UTC(year, month, day[, hours[, minutes[, seconds[,ms]]]])

Параметры

year: Целое число, задающее год. Если оно меньше 100, то к нему прибавляется 1900.
month: Целое число, задающее номер месяца в диапазоне от 0 до 11 (0 = январь, 1 = февраль, ... , 11 = декабрь).
date: Целое число, задающее день месяца в диапазоне от 1 до 31.
hours: Целое число, в диапазоне от 0 до 23 (от полуночи до 23:00), представляющее час. Применяется, если указывается аргумент minutes.
minutes: Целое число, в диапазоне от 0 до 59, представляющее минуты. Применяется, если указывается аргумент seconds.
seconds: Целое число в диапазоне от 0 до 59, представляющее секунды.
ms: Целое число в диапазоне от 0 до 999, представляющее миллисекунды.

Возвращаемое значение

Количество миллисекунд, истекших с полуночи 1 января 1970 года и указанной датой, используя время в формате UTC.

Если значение аргумента превышает верхнюю границу его диапазона или является отрицательным числом, остальные хранящиеся значения изменяются соответственно. Например, если задать 150 секунд, JavaScript переопределит это число как две минуты и 30 секунд.

Функция Date.UTC полностью аналогичен конструктору Date с единственным отличием: полученное значение вычисляется по времени UTC, а не по локальному времени.

Это статический метод, который можно вызывать без создания объекта даты, поэтому для доступа к нему используется форма Date.UTC, а не объект.UTC.

Примеры

var x = Date.UTC(2000, 1, 2, 12, 35, 40);
var d = new Date(x);
alert(d.toUTCString());

Создание Date для даты в зоне GMT

gmtDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0));
alert (gmtDate.toString());

getDate

Возвращает значение дня месяца, используя местное время.

Синтаксис

DateObject.getDate()

Возвращаемое значение

Возвращает целое число от 1 до 31.

Примеры

День запуска спутника

var sputnikLaunch = new Date("October 4, 1957 19:28:34 GMT");


day = sputnikLaunch.getDate();
alert (day);

getDay

Возвращает значение дня недели, используя местное время.

Синтаксис

DateObject.getDay()

Параметры

Возвращаемое значение

getDay возвращает целое число, обозначающее день недели: 0 - воскресенье, 1 - понедельник, 2 - вторник, и т.д.

Примеры

var d = new Date (Date.now());
var w = ["вс","пн","вт","ср","чт","пт","сб"];
var day = d.getDay();
alert ( w[day] );

getFullYear

Возвращает значение года, используя местное время.

Синтаксис

DateObject.getFullYear()

Возвращаемое значение

Возвращает полное значение года. Для дат от 1000 до 9999 года getFullYear возвращает четырёхзначное число.

Примеры

var today = new Date();
alert ( (yr = today.getFullYear()) );

getHours

Возвращает значение часов, используя местное время.

Синтаксис

DateObject.getHours()

Возвращаемое значение

Возвращает целое число от 0 до 23.

Примеры

var sputnikLaunch = new Date("October 4, 1957 19:28:34 GMT")
// Жители разных часовых поясов получат здесь разные значения

alert ( (hh = sputnikLaunch.getHours()) );

getMilliseconds

Возвращает значение миллисекунд, используя местное время.

Синтаксис

DateObject.getMilliseconds()

Возвращаемое значение

Возвращает целое число от 0 до 999.

Примеры

var ms;
Today = new Date();
alert ((ms = Today.getMilliseconds()));

getMinutes

Возвращает значение минут, используя местное время.

Синтаксис

DateObject.getMinutes()

Возвращаемое значение

Возвращает целое число от 0 до 59.

Примеры

var sputnikLaunch = new Date("October 4, 1957 19:28:34 GMT");

// Большинство жителей Земли получат здесь 28
// (кроме жителей нецелых часовых поясов)
alert ( (minutes = sputnikLaunch.getMinutes()) );

getMonth

Возвращает значение месяца, используя местное время.

Синтаксис

DateObject.getMonth()

Возвращаемое значение

Возвращает целое число от 0 до 11. 0 соответствует январю, 1 - февралю, и т.д.

Примеры

var sputnikLaunch = new Date("October 4, 1957 19:28:34 GMT")
// Здесь получится 9
alert ((month = sputnikLaunch.getMonth()));

getSeconds

Возвращает значение секунд, используя местное время

Синтаксис

DateObject.getSeconds()

Возвращаемое значение

Возвращает целое число от 0 до 59.

Примеры

var sputnikLaunch = new Date("October 4, 1957 19:28:34 GMT")
alert ((sec = sputnikLaunch.getSeconds()));

getTime

Возвращает значение времени в объекте Date в виде количества миллисекунд, истекших с полуночи 1 января 1970 г.

Синтаксис

DateObject.getTime()

Возвращаемое значение

Значение, возвращаемое методом getTime, равно количеству миллисекунд, прошедших с полуночи 1 января 1970 года GMT.

Примеры

// Копируем значение theBigDay в sameAsBigDay:
theBigDay = new Date("July 1, 1999")
sameAsBigDay = new Date()
sameAsBigDay.setTime(theBigDay.getTime())

getTimezoneOffset

Возвращает разницу в минутах между временем на локальном компьютере и временем в формате UTC.

Синтаксис

DateObject.getTimezoneOffset()

Возвращаемое значение

Смещение часового пояса равняется разнице между универсальным (UTC) и местным временем в минутах. Заметьте, что смещение будет положительным, если местное время отстаёт от UTC, и отрицательным, если оно опережает UTC. Например, если ваш часовой пояс - UTC+10 (Владивостокское зимнее время), то метод вернёт -600.

Примеры

x = new Date()
// Вычислим значение смещения текущего часового пояса в часах
alert ((currentTimeZoneOffsetInHours = -x.getTimezoneOffset()/60));

getUTCDate

Возвращает значение дня месяца, используя время в формате UTC.

Синтаксис

DateObject.getUTCDate()

Возвращаемое значение

Возвращает целое число от 1 до 31.

Пример

День запуска спутника

var sputnikLaunch = new Date("October 4, 1957 19:28:34 GMT")
// Здесь получится 4
alert ( (day = sputnikLaunch.getUTCDate()) );

getUTCDay

Возвращает значение дня недели, используя время в формате UTC.

Синтаксис

DateObject.getUTCDay()

Возвращаемое значение

getUTCDay возвращает целое число, обозначающее день недели: 0 - воскресенье, 1 - понедельник, 2 - вторник, и т.д.

Примеры

var sputnikLaunch = new Date("October 4, 1957 19:28:34 GMT")
// Здесь получится 5 - пятница
alert ((day = sputnikLaunch.getDay()));

getUTCFullYear

Возвращает значение года, используя время в формате UTC.

Синтаксис

DateObject.getUTCFullYear()

Возвращаемое значение

Возвращает полное значение года. Для дат от 1000 до 9999 года getUTCFullYear возвращает четырёхзначное число.

Примеры

var today = new Date();
var yr = today.getUTCFullYear(); alert (yr);

getUTCHours

Возвращает значение часов, используя время в формате UTC.

Синтаксис

DateObject.getUTCHours()

Возвращаемое значение

Возвращает целое число от 0 до 23.

Примеры

var sputnikLaunch = new Date("October 4, 1957 19:28:34 GMT")
// Здесь получится 19
alert ((day = sputnikLaunch.getUTCHours()));

getUTCMilliseconds

Возвращает значение миллисекунд, используя время в формате UTC.

Синтаксис

DateObject.getUTCMilliseconds()

Возвращаемое значение

Возвращает целое число от 0 до 999.

Примеры

var ms;
Today = new Date();
ms = Today.getUTCMilliseconds(); alert (ms);

getUTCMinutes

Возвращает значение минут, используя время в формате UTC.

Синтаксис

DateObject.getUTCMinutes()

Возвращаемое значение

Возвращает целое число от 0 до 59.

Примеры

var sputnikLaunch = new Date("October 4, 1957 19:28:34 GMT")
// Здесь получается 28
minutes = sputnikLaunch.getUTCMinutes(); alert (minutes);

getUTCMonth

Возвращает значение месяца, используя время в формате UTC.

Синтаксис

DateObject.getUTCMonth()

Возвращаемое значение

Возвращает целое число от 0 до 11. 0 соответствует январю, 1 - февралю, и т.д.

Примеры

var sputnikLaunch = new Date("October 4, 1957 19:28:34 GMT")
// Здесь получится 9
month = sputnikLaunch.getUTCMonth(); alert (month);

getUTCSeconds

Возвращает значение секунд, используя время в формате UTC.

Синтаксис

DateObject.getUTCSeconds()

Возвращаемое значение

Возвращает целое число от 0 до 59.

Примеры

var sputnikLaunch = new Date("October 4, 1957 19:28:34 GMT")
// Здесь получится 34
sec = sputnikLaunch.getUTCSeconds(); alert (sec);

getYear

Возвращает значение года.

Синтаксис

DateObject.getYear()

Возвращаемое значение

Метод getYear возвращает значение года минус 1900.

getYear более не рекомендуется к использованию и был заменён методом getFullYear.

Примеры

Xmas = new Date("December 25, 1995 23:15:00");
year = Xmas.getYear() // возвращает 95
Xmas = new Date("December 25, 2000 23:15:00")
year = Xmas.getYear() // возвращает 100
Xmas = new Date("December 25, 1800 23:15:00")
year = Xmas.getYear() // возвращает -100

setDate

Задает числовой день месяца, используя местное время.

Синтаксис

DateObject.setDate(dayValue)

Параметры

dayValue: Целое от 1 до 31, означающее день месяца

Если переданный параметр имеет значение, лежащее вне предусмотренного диапазона, метод setDate попытается соответствующим образом изменить значение экземпляра объекта Date. Например, если использовать для dayValue значение 40, а значение месяца в объекте соответствует июню, то день и месяц в объекте будут равны 10 июля.

Примеры

// Меняем число на 24-е
theBigDay = new Date("July 27, 1962 23:30:00")
theBigDay.setDate(24); alert ( theBigDay );

setFullYear

Задает значение года, используя местное время.

Синтаксис

DateObject.setFullYear(yearValue[, monthValue[, dayValue]])

Параметры

yearValue: Полное численное значение года, например 1995
monthValue: Целочисленное значение от 0 до 11, обозначающее месяц от января до декабря
dayValue: Целочисленное значение от 1 до 31, обозначающее день месяца. Если вы указываете dayValue, то перед ним надо указать monthValue

Если какой-либо переданный параметр имеет значение, лежащее вне предусмотренного диапазона, метод setFullYear пытается соответствующим образом изменить значение других параметров. Например, если использовать для monthValue значение 15, то год будет увеличен на 1 (yearValue+ 1), а 3 будет использовано в качестве значения месяца.

Пример

Изменение даты

// Меняем год на 1997-й
theBigDay = new Date();
theBigDay.setFullYear(1997);alert ( theBigDay );

setHours

Задает значение часов, используя местное время.

Синтаксис

DateObject.setHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])

Параметры

hoursValue: Целочисленное значение от 0 до 23, означающее часы
minutesValue: Целочисленное значение от 0 до 59, означающее минуты
secondsValue: Целочисленное значение от 0 до 59, означающее секунды. Если вы указываете secondsValue, то перед ним надо указать minutesValue
msValue: Число от 0 до 999, означающее миллисекунды. Если вы указываете msValue, то перед ним надо указать monthValue и secondsValue

Если какой-либо переданный параметр имеет значение, лежащее вне предусмотренного диапазона, метод setHours пытается соответствующим образом изменить значение других параметров. Например, если использовать для secondsValue значение 100, то минуты будут увеличены на 1 (minutesValue+ 1), а в качестве значения секунд будет использовано 40.

Примеры

// Меняем час на 7
theBigDay = new Date();
theBigDay.setHours(7); alert ( theBigDay );

setMilliseconds

Задает значение миллисекунд, используя местное время.

Синтаксис

DateObject.setMilliseconds(millisecondsValue)

Параметры

millisecondsValue: Численное значение от 0 до 999, означающее миллисекунды

Если переданное число имеет значение, лежащее вне предусмотренного диапазона, метод setMilliseconds пытается соответствующим образом изменить значение объекта Date. Например, если использовать значение 1005, то значение секунд будут увеличено на 1, а в качестве значения миллисекунд будет использовано 5.

Примеры

// Меняем миллисекунды на 100
theBigDay = new Date();
theBigDay.setMilliseconds(100); alert ( theBigDay );

setMinutes

Задает значение минут, используя местное время.

Синтаксис

DateObject.setMinutes(minutesValue[, secondsValue[, msValue]])

Параметры

minutesValue: Целочисленное значение от 0 до 59, означающее минуты
secondsValue: Целочисленное значение от 0 до 59, означающее секунды
msValue: Число от 0 до 999, означающее миллисекунды. Если вы указываете msValue, то перед ним надо указать secondsValue

Если какой-либо переданный параметр имеет значение, лежащее вне предусмотренного диапазона, метод setMinutes пытается соответствующим образом изменить значение других параметров. Например, если использовать для secondsValue значение 100, то минуты будут увеличены на 1 (minutesValue+ 1), а в качестве значения секунд будет использовано 40.

Примеры

// Меняем минуты на 45
theBigDay = new Date();
theBigDay.setMinutes(45); alert ( theBigDay );

setMonth

Задает значение месяца, используя местное время.

Синтаксис

DateObject.setMonth(monthValue[, dayValue])

Параметры

monthValue: Целочисленное значение от 0 до 11, обозначающее месяц от января до декабря
dayValue: Целочисленное значение от 1 до 31, обозначающее день месяца

Если переданный параметр имеет значение, лежащее за ожидаемыми пределами, метод setMonth пытается соответствующим образом изменить значение других параметров. Например, если использовать для monthValue значение 15, то год будет увеличен на 1, а 3 будет использовано в качестве значения месяца.

Примеры

// Меняем месяц на июль
theBigDay = new Date();
theBigDay.setMonth(6); alert ( theBigDay );

setSeconds

Задает значение секунд, используя местное время.

Синтаксис

DateObject.setSeconds(secondsValue)

Параметры

secondsValue: Целочисленное значение от 0 до 59, означающее секунды
msValue: Число от 0 до 999, означающее миллисекунды

Если переданный параметр имеет значение, лежащее вне предусмотренного диапазона, метод setSeconds пытается соответствующим образом изменить значение других параметров. Например, если использовать для secondsValue значение 100, то минуты будут увеличены на 1, а в качестве значения секунд будет использовано 40.

Примеры

// Меняем секунды на 30
theBigDay = new Date();
theBigDay.setSeconds(30); alert ( theBigDay );

setTime

Устанавливает значение даты и времени в объекте Date.

Синтаксис

DateObject.setTime(timeValue)

Параметры

timeValue: Число, равное количеству миллисекунд, прошедших с полуночи 1 января 1970 года по универсальному времени

Примеры

// Копируем значение theBigDay в sameAsBigDay:
theBigDay = new Date("July 1, 1999")
sameAsBigDay = new Date()
sameAsBigDay.setTime(theBigDay.getTime())

setUTCDate

Задает числовой день месяца, используя время в формате UTC.

Синтаксис

DateObject.setUTCDate(dayValue)

Параметры

dayValue: Целое от 1 до 31, означающее день месяца

Если переданный параметр имеет значение, лежащее вне предусмотренного диапазона, метод setUTCDate попытается соответствующим образом изменить значение экземпляра объекта Date. Например, если использовать для dayValue значение 40, а значение месяца в объекте соответствует июню, то день и месяц в объекте будут равны 10 июля.

Примеры

// Меняем число на 24-е
theBigDay = new Date("July 27, 1962 23:30:00")
theBigDay.setUTCDate(24); alert ( theBigDay );

setUTCFullYear

Задает значение года, используя время в формате UTC.

Синтаксис

DateObject.setUTCFullYear(yearValue[, monthValue[, dayValue]])

Параметры

yearValue: Полное численное значение года, например 1995
monthValue: Целочисленное значение от 0 до 11, обозначающее месяц от января до декабря
dayValue: Целочисленное значение от 1 до 31, обозначающее день месяца. Если вы указываете dayValue, то перед ним надо указать monthValue

Если какой-либо переданный параметр имеет значение, лежащее вне предусмотренного диапазона, метод setUTCFullYear пытается соответствующим образом изменить значение других параметров. Например, если использовать для monthValue значение 15, то год будет увеличен на 1 (yearValue+ 1), а 3 будет использовано в качестве значения месяца.

Примеры

// Меняем год на 1997-й
theBigDay = new Date();
theBigDay.setUTCFullYear(1997); alert ( theBigDay );

setUTCHours

Задает значение часов, используя время в формате UTC.

Синтаксис

DateObject.setUTCHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])

Параметры

hoursValue: Целочисленное значение от 0 до 23, означающее часы
minutesValue: Целочисленное значение от 0 до 59, означающее минуты
secondsValue: Целочисленное значение от 0 до 59, означающее секунды. Если вы указываете secondsValue, то перед ним надо указать minutesValue
msValue: Число от 0 до 999, означающее миллисекунды. Если вы указываете msValue, то перед ним надо указать monthValue и secondsValue

Примеры

// Меняем час на 7
theBigDay = new Date();
theBigDay.setUTCHours(7); alert ( theBigDay );

setUTCMilliseconds

Задает значение миллисекунд, используя время в формате UTC.

Синтаксис

DateObject.setUTCMilliseconds(millisecondsValue)

Параметры

millisecondsValue: Численное значение от 0 до 999, означающее миллисекунды

Если переданное число имеет значение, лежащее вне предусмотренного диапазона, метод setUTCMilliseconds пытается соответствующим образом изменить значение объекта Date. Например, если использовать значение 1005, то значение секунд будут увеличено на 1, а в качестве значения миллисекунд будет использовано 5.

Примеры

// Меняем миллисекунды на 100
theBigDay = new Date();
theBigDay.setUTCMilliseconds(100); alert ( theBigDay );

setUTCMinutes

Задает значение минут, используя время в формате UTC.

Синтаксис

DateObject.setUTCMinutes(minutesValue[, secondsValue[, msValue]])

Параметры

minutesValue: Целочисленное значение от 0 до 59, означающее минуты
secondsValue: Целочисленное значение от 0 до 59, означающее секунды
msValue: Число от 0 до 999, означающее миллисекунды. Если вы указываете msValue, то перед ним надо указать secondsValue

Если какой-либо переданный параметр имеет значение, лежащее вне предусмотренного диапазона, метод setUTCMinutes пытается соответствующим образом изменить значение других параметров. Например, если использовать для secondsValue значение 100, то минуты будут увеличены на 1 (minutesValue+ 1), а в качестве значения секунд будет использовано 40.

Примеры

// Меняем минуты на 45
theBigDay = new Date();
theBigDay.setUTCMinutes(45); alert ( theBigDay );

setUTCMonth

Задает значение месяца, используя время в формате UTC.

Синтаксис

DateObject.setUTCMonth(monthValue[, dayValue])

Параметры

monthValue: Целочисленное значение от 0 до 11, обозначающее месяц от января до декабря
dayValue: Целочисленное значение от 1 до 31, обозначающее день месяца

Если переданный параметр имеет значение, лежащее за ожидаемыми пределами, метод setUTCMonth пытается соответствующим образом изменить значение других параметров. Например, если использовать для monthValue значение 15, то год будет увеличен на 1, а 3 будет использовано в качестве значения месяца.

Примеры

// Меняем месяц на июль
theBigDay = new Date();
theBigDay.setUTCMonth(6); alert ( theBigDay );

setUTCSeconds

Задает значение секунд, используя время в формате UTC.

Синтаксис

DateObject.setUTCSeconds(secondsValue)

Параметры

secondsValue: Целочисленное значение от 0 до 59, означающее секунды
msValue: Число от 0 до 999, означающее миллисекунды

Если переданный параметр имеет значение, лежащее вне предусмотренного диапазона, метод setUTCSeconds пытается соответствующим образом изменить значение других параметров. Например, если использовать для secondsValue значение 100, то минуты будут увеличены на 1, а в качестве значения секунд будет использовано 40.

Примеры

// Меняем секунды на 30
theBigDay = new Date();
theBigDay.setUTCSeconds(30); alert ( theBigDay );

setYear

Задает значение года, используя местное время.

Синтаксис

DateObject.setYear(yearValue)

Параметры

yearValue: Сокращённое численное обозначение года, например 95

Если переданное значение является числом от 0 до 99 включительно, то значение года для экземпляра объекта Date устанавливается равным 1900 + yearValue. В противном случае значение года устанавливается равным yearValue.

Для корректной обработки годов, не относящихся к XX веку, рекомендуется использовать setFullYear, всегда принимающий полное значение года.

Примеры


theBigDay.setYear(96)    // Это 1996 год

theBigDay.setYear(1996)  // И это 1996 год

theBigDay.setYear(2000)  // А 2000 год - только так

toDateString

Возвращает дату в виде строкового значения.

Синтаксис

DateObject.toDateString()

Возвращаемое значение

Экземпляр объекта Date означает некоторый момент времени. Вызов метода toString вернёт информацию об этом моменте в виде строки, содержащей пригодное для человеческого восприятия текстовое представление даты на английском языке, в американском формате. Для SpiderMonkey (реализация JavaScript от Mozilla) это представление состоит из даты (день, месяц, год), за которой следует время (часы, минуты, секунды и часовой пояс). Иногда требуется получить только информацию о дате - для этого существует метод toDateString.

Метод toDateString представляется особенно полезным, если учесть тот факт, что для корректных реализаций ECMA-262 формат строки, получаемой в результате вызова метода toString для объектов Date, не регламентирован. По этой причине не существует простого и надёжного способа выделить из этой строки часть, соответствующую дате.

Примеры

var d = new Date(1957, 9, 4, 19, 28, 34);
alert( d.toString() + '\n' + d.toDateString() );

toGMTString

Возвращает дату, преобразованную в строку с помощью времени GMT.

Синтаксис

DateObject.toGMTString()

toISOString

Возвращает дату в виде строкового значения в формате ISO.

Синтаксис

DateObject.toISOString()

Возвращаемое значение

Строковое представление даты в формате Международной организации по стандартизации (ISO).

Примеры

alert ( new Date().toISOString() );

toLocaleDateString

Возвращает дату в виде строки, соответствующей текущему языковому стандарту хост-среды.

Синтаксис

DateObject.toLocaleDateString()

Возвращаемое значение

Метод toLocaleDateString использует функционал операционной системы для форматирования текстового представления даты. Он преобразовывает дату в строку, используя настройки форматирования операционной системы, в которой выполняется скрипт. Например, в США число записывается после месяца (04/15/98), а в России и Германии число идёт перед месяцем (15.04.98). Если операционная система " не совместима с 2000 годом" (т.е. не всегда использует четырёхзначную запись года), toLocaleDateString вернёт строку "не 2000-совместимым" годом. При преобразовании значения года, которое операционная система форматирует некорректно, toLocaleDateString ведёт себя аналогично toString.

Такие методы как getDate, getMonth и getFullYear дают более предсказуемые результаты, чем toLocaleDateString. Используйте toLocaleDateString, когда намереваетесь показать пользователю строку в формате, соответствующем выбранным им региональным настройкам. Следует помнить что данный метод, по своей природе, ведёт себя по-разному в зависимости от операционной системы и настроек пользователя.

Примеры

var today = new Date("October 4, 1957 19:28:34 GMT")
alert ( (today.toLocaleDateString()) );

toLocaleString

Возвращает объект, преобразованный в строку, используя текущий языковой стандарт.

Синтаксис

DateObject.toLocaleString()

Возвращаемое значение

Метод toLocaleString возвращает String-объект, содержащий дату в длинном формате по умолчанию.

Для дат в диапазоне 1601 - 1999 формат даты в соотвествии с региональными установками панели управления пользователя.
Для дат вне этого диапазона используется формат по умолчанию.

Например, в США, метод toLocaleString возвращает "01/05/96 00:00:00" для 5 января 1996 г., в Европе для этой даты он возвращает "05/01/96 00:00:00", поскольку в Европе принято ставить день перед месяцем.

var d = new Date()
alert( d.toLocaleString() )

toLocaleTimeString

Возвращает время в виде строки, соответствующей текущему языковому стандарту хост-среды.

Синтаксис

DateObject.toLocaleTimeString()

Возвращаемое значение

Метод toLocaleTimeString использует функционал операционной системы для форматирования текстового представления времени. Он преобразовывает данные о времени в строку, используя настройки форматирования операционной системы, в которой выполняется скрипт. Например, в США более распространена 12-часовая система (7:28:34 PM), а в России - 24 часовая (19:28:34).

Такие методы как getHours, getMinutes и getSeconds дают более предсказуемые результаты, чем toLocaleTimeString. Используйте toLocaleTimeString, когда намереваетесь показать пользователю строку в формате, соответствующем выбранным им региональным настройкам. Следует помнить что данный метод, по своей природе, ведёт себя по-разному в зависимости от операционной системы и настроек пользователя.

Примеры

var today = new Date("October 4, 1957 19:28:34 GMT")
alert ( today.toLocaleTimeString() );

toString

Возвращает строковое представление объекта.

Синтаксис

DateObject.toString()

Возвращаемое значение

Объект Date перегружает метод toString объекта Object; он не наследует Object.toString. Для объектов Date метод toString возвращает строковое представление объекта.

toString всегда возвращает строку, представляющую дату на английском языке в американском формате.

JavaScript вызывает метод toString автоматически когда дата должна быть представлена как текстовое значение или когда дата используется в конкатенации строк.

Примеры

var sputnikLaunch = new Date("October 4, 1957 19:28:34 GMT")
alert(sputnikLaunch.toString()) 
// выведет что-то вроде Fri Oct 04 1957 23:28:34 GMT+0400 (Russian Standard Time)
alert( sputnikLaunch ) 
// выведет то же самое

toTimeString

Возвращает время в виде строкового значения.

Синтаксис

DateObject.toTimeString()

Возвращаемое значение

Экземпляр объекта Date означает некоторый момент времени. Вызов метода toString вернёт информацию об этом моменте в виде строки, содержащей пригодное для человеческого восприятия текстовое представление даты на английском языке, в американском формате. Для SpiderMonkey (реализация JavaScript от Mozilla) это представление состоит из даты (день, месяц, год), за которой следует время (часы, минуты, секунды и часовой пояс). Иногда требуется получить только информацию о времени - для этого существует метод toTimeString.

Метод toTimeString представляется особенно полезным, если учесть тот факт, что для корректных реализаций ECMA-262 формат строки, получаемой в результате вызова метода toString для объектов Date, не регламентирован. По этой причине не существует простого и надёжного способа выделить из этой строки часть, соответствующую времени.

Примеры

var d = new Date(1957, 9, 4, 19, 28, 34);
alert ( d.toString() + '\n' + d.toTimeString() );

toUTCString

Возвращает дату, преобразованную в строку с использованием времени в формате UTC.

Синтаксис

DateObject.toUTCString()

Возвращаемое значение

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

Примеры

var d = new Date(1957, 9, 4, 19, 28, 34);
alert( d.toUTCString() );

valueOf

Возвращает примитивное значение указанного объекта.

Синтаксис

DateObject.date.valueOf()

Возвращаемое значение

Значение, возвращаемое методом getTime, равно количеству миллисекунд, прошедших с полуночи 1 января 1970 года.

Примеры

alert(new Date(2009,1,14,2,31,30).valueOf())

Объект Date

Синтаксис

Параметры

Комментарии

Функции

Методы

Date.now

Синтаксис

Возвращаемое значение

Комментарии

Примеры

Date.parse

Синтаксис

Параметры

Возвращаемое значение

Описание

Правила разбора строки

Примеры

Date.UTC

Синтаксис

Параметры

Возвращаемое значение

Комментарии

Примеры

getDate

Синтаксис

Возвращаемое значение

Примеры

getDay

Синтаксис

Параметры

Возвращаемое значение

Примеры

getFullYear

Синтаксис

Возвращаемое значение

Комментарии

Примеры

getHours

Синтаксис

Возвращаемое значение

Примеры

getMilliseconds

Синтаксис

Возвращаемое значение

Примеры

getMinutes

Синтаксис

Возвращаемое значение

Примеры

getMonth

Синтаксис

Возвращаемое значение

Примеры

getSeconds

Синтаксис

Возвращаемое значение

Примеры

getTime

Синтаксис

Возвращаемое значение

Комментарии

Примеры

getTimezoneOffset

Синтаксис

Возвращаемое значение

Комментарии

Примеры

getUTCDate

Синтаксис

Возвращаемое значение

Пример

getUTCDay

Синтаксис

Возвращаемое значение

Примеры

getUTCFullYear

Синтаксис

Возвращаемое значение

Комментарии