Объект 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.

Комментарии

Дата измеряется в миллисекундах, начиная от полуночи 01 января 1970 года GMT+0. День содержит 86,400,000 миллисекунд.

Объект Date ведет себя одинаково на всех платформах.

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

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

Синтаксис

Date.now()

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

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

Комментарии

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

Технически, функция Date.now аналогичен вызову +new Date(), но в отличие от него не создаёт промежуточный объект даты, а поэтому – во много раз быстрее.

Его использование особенно рекомендуется там, где производительность при работе с датами критична. Обычно это не на веб-страницах, а, к примеру, в разработке игр на 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.

Комментарии

Возвращаемое значение может использоваться методом setTime и конструктором объекта Date.

Если значение аргумента превышает верхнюю границу его диапазона или является отрицательным числом, остальные хранящиеся значения изменяются соответственно. Например, если задать 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 возвращает четырёхзначное число.

Комментарии

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

Примеры

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.

Комментарии

Этот метод можно использовать для присвоения значения другому объекту Date.

Этот метод функционально эквивалентен методу valueOf.

Примеры

// Копируем значение 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 возвращает четырёхзначное число.

Комментарии

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

Примеры

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

Комментарии

Если значения параметров monthValue и dayValue опущены, используются значения, возвращаемые методами getMonth и getDate.

Если какой-либо переданный параметр имеет значение, лежащее вне предусмотренного диапазона, метод 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

Комментарии

Если значения параметров minutesValue,secondsValue и msValue опущены, используются значения, возвращаемые методами getMinutes, getSeconds и getMilliseconds.

Если какой-либо переданный параметр имеет значение, лежащее вне предусмотренного диапазона, метод 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

Комментарии

Если значения параметров secondsValue и msValue опущены, используются значения, возвращаемые методами getSeconds и getMilliseconds.

Если какой-либо переданный параметр имеет значение, лежащее вне предусмотренного диапазона, метод 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, обозначающее день месяца

Комментарии

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

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

Примеры

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

setSeconds

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

Синтаксис

DateObject.setSeconds(secondsValue)

Параметры

secondsValue

Целочисленное значение от 0 до 59, означающее секунды

msValue

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

Комментарии

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

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

Примеры

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

setTime

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

Синтаксис

DateObject.setTime(timeValue)

Параметры

timeValue

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

Комментарии

Этот метод можно использовать для присвоения значения другому объекту Date.

Примеры

// Копируем значение 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

Комментарии

Если значения параметров monthValue и dayValue опущены, используются значения, возвращаемые методами getUTCMonth и getUTCDate.

Если какой-либо переданный параметр имеет значение, лежащее вне предусмотренного диапазона, метод 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

Комментарии

Если значения параметров minutesValue,secondsValue и msValue опущены, используются значения, возвращаемые методами getUTCMinutes, getUTCSeconds и getUTCMilliseconds.

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

Примеры

// Меняем час на 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

Комментарии

Если значения параметров secondsValue и msValue опущены, используются значения, возвращаемые методами getUTCSeconds и getUTCMilliseconds.

Если какой-либо переданный параметр имеет значение, лежащее вне предусмотренного диапазона, метод 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, обозначающее день месяца

Комментарии

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

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

Примеры

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

setUTCSeconds

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

Синтаксис

DateObject.setUTCSeconds(secondsValue)

Параметры

secondsValue

Целочисленное значение от 0 до 59, означающее секунды

msValue

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

Комментарии

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

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

Примеры

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

setYear

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

Синтаксис

DateObject.setYear(yearValue)

Параметры

yearValue

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

Комментарии

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

Если переданное значение является числом от 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()

Комментарии

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

Как и toUTCString, toGMTString возвращает строку, содержащее текстовое представление даты и времени по Гринвичу на английском языке в американском формате.

toISOString

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

Синтаксис

DateObject.toISOString()

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

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

Комментарии

toISOString() метод преобразует объект Date в строку, используя стандарт ISO. Стандарт называется ISO-8601 и формат: YYYY-MM-ДДTчч: мм: ss.sssZ

Примеры

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 года.

Комментарии

Этот метод функционально эквивалентен методу getTime.

Этот метод является служебным и обычно не вызывается явно в коде.

Примеры

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