Объект Date - статический объект, который генерирует объекты посредством нескольких функций конструктора. Каждый объект Date - снимок даты и времени, измеренной в миллисекундах относительно времени 1 января 1970. Отрицательные значения представляют время перед той датой; положительные значения представляют время с тех пор. Один день состоит из 86,400,000 миллисекунд. Объект Date имеет диапазон от -100,000,000 до 100,000,000 дней относительно 01 января 1970 года по UTC.

Типичный способ работать с датами состоит в том, чтобы генерировать новый образец объекта Date: или настоящее время (в данный момент, используя клиентское местное время), или другое специфическое время, или дату (прошлого или будущего). Используется несметное число доступных методов date, способных получить или установить компоненты времени (например, минут, часов, даты, месяца). Браузеры внутри себя сохраняют дату как значение миллисекунд в Coordinated Universal Time (UTC, который является по существу тем же самым, что и Greenwich Mean Time, или GMT). Когда Вы запрашиваете браузер текущее время, он автоматически преобразовывает значение миллисекунд (в соответствии с зоной местного времени, основанной на установке клиентского компьютера) в часы и часовой пояс. Если настройки времени неверны, вычисления времени и даты могут спутываться.

Ранние версии браузеров имели многочисленные баги при работе с объектом Date. Один из ресурсов, который объясняет специфику работы с объектом Date (и баги) может быть найден по адресу http://developer.netscape.com/viewsource/goodman_dateobject.html.

var now = new Date()
var myDate = new Date("month dd, yyyy hh:mm:ss")
var myDate = new Date("month dd, yyyy")
var myDate = new Date(yy, mm, dd, hh, mm, ss)
var myDate = new Date(yy, mm, dd)
var myDate = new Date(milliseconds)

Специфицирует функцию, которая создаёт прототип объекта. Заметьте, что значением этого свойства является ссылка на саму функцию, а не строка, содержащая имя функции.

Все объекты наследуют свойство constructor из своих prototype

o = new Object // или o = {} в JavaScript 1.2
o.constructor == Object
a = new Array // или a = [] в JavaScript 1.2
a.constructor == Array
n = new Number(3)
n.constructor == Number

Свойство статического объекта Date. Используйте свойство prototype, чтобы назначить новые свойства и методы будущим образцам Date, созданного в текущем документе. См. описание свойства Array.prototype.

Date.prototype.author = "DG"

Возвращает число месяца.

Возвращает целое число, соответствующее дню недели

Возвращает год

Возвращает отсчитываемое от нуля целое число, соответствующее часу суток. Используется 24-часовая система.

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

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

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

Возвращает отсчитываемое от нуля целое число, соответствующее секундам от самой близкой полной минуты.

Возвращает отсчитываемое от нуля целое число, соответствующее числу миллисекунд с 1 января 1970.

Возвращает отсчитываемое от нуля целое число, соответствующее разнице в минутах между местным временем клиента и GMT. Часовые пояса на запад от GMT - положительные значения; часовые пояса на восток - отрицательные значения. Многочисленные баги мучали этот метод в более ранних браузерах, особенно версии Macintosh.

Возвращает день месяца, но в UTC-времени, сохраненном внутри браузера.

Возвращает целое число, соответствующее дню недели, но в UTC-времени, сохраненном внутри браузера.

Возвращает год, но в UTC-времени, сохраненном внутри браузера.

Возвращает отсчитываемое от нуля целое число, соответствующее часу суток, но в UTC-времени, сохраненном внутри браузера. Используется 24-часовая система.

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

Возвращает отсчитываемое от нуля целое число, соответствующее значению минут, но в UTC-времени, сохраненном внутри браузера.

Возвращает отсчитываемое от нуля целое число, соответствующее значению месяца, но в UTC-времени, сохраненном внутри браузера.

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

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

Возвращает номер, соответствующий году, но проявляет некорректное поведение. В теории, метод должен возвратить число лет с 1900 года. Это должно приводить к одному - значению с двумя цифрами (в течение всех лет между 1900 и 1999). Однако, когда Вы достигаете 2000, появляется баг. Вместо создания значений, начинающихся с 100, метод getYear() , начиная с Navigator 3 и IE 4, возвращает то же самое четырехразрядное значение как getFullYear(). По этой причине, лучшее использовать getFullYear() всякий раз, когда возможно (но соблюдать совместимость браузеров).

Статический метод, который преобразует строку даты в количество миллисекунд, прошедших с 1 января 1970. Метод parse принимает строку с датой (например, "Dec 25, 1995") и возвращает количество миллисекунд, прошедшее после 1 января 1970 год, 00:00:00 (местного времени). Эта функция используется для установки значений даты на базе строковых значений, например, в соединении с методом setTime Date-объектом.

Для заданной строки, представляющей время, parse возвращает значение времени. Он принимает стандартный синтаксис времени IETF: "Mon, 25 Dec 1995 13:30:00 GMT". Он понимает континентальные сокращения часовых поясов США, но, для общего использования, употребляйте смещение часового пояса, например, "Mon, 25 Dec 1995 13:30:00 GMT+0430" (4 часа, 30 минут к западу от Greenwich-меридиана). Если Вы не специфицируете часовой пояс, принимается местное/локальное время. GMT и UTC рассматриваются как эквиваленты.

Поскольку parse это static-метод объекта Date, всегда используйте его как Date.parse(), а не как метод Date-объекта, созданного Вами

Устанавливает число месяца. Этот метод изменяет значение объекта Date.

Назначает полный год. Этот метод изменяет значение объекта Date.

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

Устанавливает часы дня.Используется 24-часовая система. Этот метод изменяет значение объекта Date.

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

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

Устанавливает число миллисекунд с последней секунды. Этот метод изменяет значение объекта Date.

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

Устанавливает число минут. Этот метод изменяет значение объекта Date.

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

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

Устанавливает месяц года. Значения этого метода являются отсчитываемыми от нуля. Этот метод изменяет значение объекта Date.

Возвращаемое значение
Число в диапазоне от 0 до 11. Январь - 0, Февраль - 1, Декабрь - 11.

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

Если специфицированный Вами параметр находится за пределами ожидаемого диапазона, setMonth пытается соответственно обновить информацию даты в Date-объекте. Например, если Вы используете 15 для monthValue, год будет увеличен на 1 (year + 1), а 3 будет использовано для month.

Устанавливает значение секунд от самой близкой полной минуты. Этот метод изменяет значение объекта Date.

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

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

Устанавливает объект Date на число миллисекунд с 1 января 1970. Этот метод изменяет значение объекта Date.

Возвращает день месяца, но в UTC-времени, сохраненном внутри браузера.

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

Назначает полный год , но в UTC-времени, сохраненном внутри браузера. Этот метод изменяет значение объекта Date.

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

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

Устанавливает часы дня. , но в UTC-времени, сохраненном внутри браузераИспользуется 24-часовая система. Этот метод изменяет значение объекта Date.

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

Если специфицированный Вами параметр находится за пределами ожидаемого диапазона, setUTCHours пытается соответственно обновить информацию даты в Date-объекте. Например, если Вы специфицируете 100 для secondsValue, минуты увеличатся на 1 (min + 1), а 40 будет использовано для секунд.

Устанавливает число миллисекунд с последней секунды , но в UTC-времени, сохраненном внутри браузера. Этот метод изменяет значение объекта Date.

Если специфицированный Вами параметр находится за пределами ожидаемого диапазона, setUTCMilliseconds пытается соответственно обновить информацию даты в Date-объекте. Например, если Вы специфицируете 1100 для millisecondsValue, секунды, хранимые в объекте Date, будут увеличены на 1, а 100 будет использовано для миллисекунд

Устанавливает число минут , но в UTC-времени, сохраненном внутри браузера. Этот метод изменяет значение объекта Date.

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

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

Устанавливает месяц года, но в UTC-времени, сохраненном внутри браузера. Значения этого метода являются отсчитываемыми от нуля. Этот метод изменяет значение объекта Date.

Если Вы не специфицируете параметр dayValue, используется значение из метода getUTCDate.

Если специфицированный Вами параметр находится за пределами ожидаемого диапазона, setUTCMonth пытается соответственно обновить информацию даты в Date-объекте. Например, если Вы специфицируете 15 для monthValue, year будет увеличен на 1 (year + 1), а 3 будет использовано для month.

Устанавливает число секунд с последней минуты, но в UTC-времени, сохраненном внутри браузера.

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

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

Устанавливает год. Используйте setFullYear(), если браузер это поддерживает.

Метод toDateString преобразует примитивное значение объекта дата в строку даты по местному времени.

Возвращает строковую версию значения времени в стандартизированном формате GMT . Этот метод не изменяет первоначальный объект Date. Для использования в более новых браузерах рекомендуется метод toUTCString()

Wed 05 Aug 1998 02:33:22 GMT

Метод toLocaleDateString преобразует примитивное значение объекта дата в строку даты по местному времени с учетом локальных установок операционной системы. Формат результирующей строки зависит от локализации операционной системы и обозревателя

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

Возвращаемое значение
Строка разнообразных форматов. Включены примеры американских версий браузеров:

Метод toLocaleTimeString преобразует примитивное значение объекта дата в строку времени по местному времени с учетом локальных установок операционной системы. Формат результирующей строки зависит от локализации операционной системы и обозревателя

Статический метод, используемый , чтобы преобразовать объекты Date в строку, в основном, когда необходимо показать дату в диалоговых окнах или в документе.Вы можете использовать его, чтобы писать сценарий строкового преобразования, если другие доступные форматы Вам не нравятся.

Строка разнообразных форматов. Включены примеры американских версий браузеров:

Возвращает строку, представляющую исходный код объекта. Этот метод обычно вызывается внутренне в JavaScript, а не явным кодом.

Для встроенного объекта Date метод toSource возвращает следующие строки, обозначающие, что исходный код недоступен:

function Date() {
[native code]
}
Для экземпляров Date метод toSource возвращает строку исходного кода

Метод toTimeString преобразует примитивное значение объекта дата в строку времени по местному времени.

Возвращает строковую версию значения времени в стандартизированном формате UTC. Этот метод не изменяет первоначальный объект Date. Для использования в более новых браузерах метод toUTCString() рекомендуется в пользу toGMTString ().

Wed 05 Aug 1998 02:33:22 GMT

Статический метод объекта Date, который возвращает числовую версию сохранённого внутри браузера объекта Date (короче, дата). В отличие от параметров для конструктора объекта Date, значения параметра для метода UTC() должны быть в UTC времени. Этот метод не генерирует объект даты, как это делает конструктор объекта Date.

UTC принимает разделённые запятыми параметры даты и возвращает количество миллисекунд, прошедших после 1 января 1970 года, 00:00:00 универсального времени и времени, специфицированного Вами.

Вы должны специфицировать полный год для year; например, 1998. Если специфицирован год от 0 до 99, этот метод конвертирует year в год 20-го столетия (1900 + year); например, если Вы специфицировали 95, будет использоваться значение 1995

Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, метод UTC обновляет другие параметры, чтобы предоставить Вам число. Например, если Вы используете 15 для month, то year будет увеличен на 1 (year + 1), а 3 будет использовано для month.

Поскольку UTC это static-метод объекта Date, Вы всегда используете его как Date.UTC(), а не как метод Date -объекта, созданного Вами.

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