Объект Date

  Date - Дата и время.
  Экземпляр доступен:

  1. В выражении

       new Date([Значение])

    где:
    • new - Ключевое слово.
    • Date - Имя функции конструктора объекта Date.
    • Значение - Начальное значение экземпляра, заданное в любом числовом.
        Указывает смещение в миллисекундах от полуночи 1 января 1970 года в формате UTC (Universal Coordinated Time - Всемирное координированное время).
        К примеру, для числа 10000, значением экземпляра будет эквивалент строки -
        "Thu Jan 01 1970 06:00:10 GMT+0600 (RTZ 4 (зима))"
        Если аргумент опущен, то значением экземпляра будет эквивалент строки, соответствующий текущей дате
        Например - "Mon May 19 2014 18:13:49 GMT+0600 (RTZ 4 (зима))"

  2. В выражении

       new Date(Год, Месяц, День[, Часы[, Минуты[, Секунды[, Миллисекунды]]]])

    где:
    • new - Ключевое слово.
    • Date - Имя функции конструктора объекта Date.
    • Год - Определяет год экземпляра даты четырехзначным целым числом, заданным в любом числовом формате.
    • Месяц - Определяет месяц экземпляра даты двухзначным целым числом от 0 до 11, заданным в любом числовом формате.
        Если значение больше 11 или меньше 0, то соответственно сдвинется год в значении даты.
    • День - Определяет день экземпляра даты двухзначным целым числом от 1 до 31, заданным в любом числовом формате.
        Если значение больше чем дней в заданном месяце или меньше 0, то соответственно сдвинется месяц в значении даты и может сдвинуться год.
    • Часы - Определяет часы экземпляра даты двухзначным целым числом от 0 до 23, заданным в любом числовом формате.
        Если не указаны, то берётся значение текущего времени.
        Число большее 23 или меньшее 0 приведет к соответствующей корректировке верхней цепочки значения даты.
    • Минуты - Определяет минуты экземпляра даты двухзначным целым числом от 0 до 59, заданным в любом числовом формате.
        Если не указаны, то берётся значение текущего времени.
        Число большее 59 или меньшее 0 приведет к соответствующей корректировке верхней цепочки значения даты.
    • Секунды - Определяет секунды экземпляра даты двухзначным целым числом от 0 до 59, заданным в любом числовом формате.
        Если не указаны, то берётся значение текущего времени.
        Число большее 59 или меньшее 0 приведет к соответствующей корректировке верхней цепочки значения даты.
    • Миллисекунды - Определяет миллисекунды экземпляра текущей даты двухзначным целым числом от 0 до 999, заданным в любом числовом формате.
        Если не указаны, то берётся значение текущего времени.
        Число большее 999 или меньшее 0 приведет к соответствующей корректировке верхней цепочки значения даты.
      Значением экземпляра будет эквивалент строки, формата- "ГГГГ-ММ-ДДTЧЧ:ММ:СС.МСZ"
      Например - "2014-05-20T15:38:09.293Z"

  3. В выражении

        new Object(Date)

    где

  Методы.
  getFullYear - Возвращает числовое значение года для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time) времени.
  В формате четырех цифр.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.getFullYear()
  2. Экземпляр объекта Date.getUTCFullYear()

Значения формата записи:

  getMonth - Возвращает числовое значение месяца для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time) времени.
  В формате двух цифр от 0 до 11.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.getMonth()
  2. Экземпляр объекта Date.getUTCMonth()

Значения формата записи:

  getDate - Возвращает числовое значение дня месяца для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time) времени.
  В формате двух цифр от 0 до 31.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.getDate()
  2. Экземпляр объекта Date.getUTCDate()

Значения формата записи:

  getDay - Возвращает числовое значение дня недели для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time) времени.
  От 0 - воскресение, до 6 - суббота.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.getDay()
  2. Экземпляр объекта Date.getUTCDay()

Значения формата записи:

  getHours - Возвращает числовое значение часов - времени суток для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time) времени.
  От 0 до 23.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.getHours()
  2. Экземпляр объекта Date.getUTCHours()

Значения формата записи:

  getMilliseconds - Возвращает числовое значение миллисекунд - времени суток для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time) времени.
  От 0 до 999.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.getMilliseconds()
  2. Экземпляр объекта Date.getUTCMilliseconds()

Значения формата записи:

  getMinutes - Возвращает числовое значение минут - времени суток для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time) времени.
  От 0 до 59.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.getMinutes()
  2. Экземпляр объекта Date.getUTCMinutes()

Значения формата записи:

  getSeconds - Возвращает числовое значение секунд - времени суток для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time) времени.
  От 0 до 59.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.getSeconds()
  2. Экземпляр объекта Date.getUTCSeconds()

Значения формата записи:

  getTime - Возвращает количество миллисекунд от полночи 1 января 1970 года до времени суток даты, указанной экземпляром объекта.

Формат записи в коде скрипта:

  • Экземпляр объекта Date.getTime()

Значения формата записи:

  getTimezoneOffset - Возвращает разницу в минутах (в числовом формате) между временем суток даты, указанной экземпляром объекта на компьютере, на котором выполняется скрипт, и UTC (Universal Coordinated Time).

Формат записи в коде скрипта:

  • Экземпляр объекта Date.getTimezoneOffset()

Значения формата записи:

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

Формат записи в коде скрипта:

  • Экземпляр объекта Date.getVarDate()

Значения формата записи:

  getYear - Возвращает двухзначное числовое значение года для даты, указанной экземпляром объекта.
  Правильное значение метод getYear вернёт только для 20 века.

Формат записи в коде скрипта:

  • Экземпляр объекта Date.getYear()

Значения формата записи:

  setDate - Устанавливает новое значение дня для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time)времени.
  Возвращает число миллисекунд от полночи 1 января 1970 года до времени суток нового значения даты.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.setDate(Номер дня)
  2. Экземпляр объекта Date.setUTCDate(Номер дня)

Значения формата записи:

  • Экземпляр объекта Date - Любой операнд значения со значением экземпляра объекта Date.
  • . - Оператор доступа к методу объекта.
  • setDate - Ключевое слово.
  • setUTCDate - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Номер дня - Целое положительное значение дня, заданное в любом числовом формате.
      Если значение номера дня больше количества дней в месяце, указанном экземпляром объекта Date, или меньше 1, то значения месяца и, при необходимости, года соответственно скорректируются для этого экземпляра объекта Date.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  setFullYear - Устанавливает новое значение для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time) времени.
  Возвращает число миллисекунд от полночи 1 января 1970 года до времени суток нового значения даты.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.setFullYear(Номер года[, Номер месяца[, Номер дня]])
  2. Экземпляр объекта Date.setUTCFullYear(Номер года[, Номер месяца[, Номер дня]])

Значения формата записи:

  • Экземпляр объекта Date - Любой операнд значения со значением экземпляра объекта Date.
  • . - Оператор доступа к методу объекта.
  • setFullYear - Ключевое слово.
  • setUTCFullYear - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Номер года - Целое положительное значение года, заданное в любом числовом формате.
      Если значение задано не четырехзначным числом, то оно будет таким и установлено.
      Если аргумент опущен, то возникнет ошибка времени выполнения.
  • Номер месяца - Целое положительное значение месяца, заданное в любом числовом формате.
      Если значение номера месяца больше 11, или меньше 0, то значение года соответственно скорректируется для этого экземпляра объекта Date.
  • Номер дня - Целое положительное значение дня, заданное в любом числовом формате.
      Если значение номера дня больше количества дней в месяце этого экземпляра объекта Date, или меньше 1, то значения месяца и, при необходимости, года соответственно скорректируются для этого экземпляра объекта Date.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  setHours - Устанавливает новое значение времени суток для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time) времени.
  Возвращает число миллисекунд от полночи 1 января 1970 года до времени суток нового значения даты.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.setHours(Часы[, Минуты[, Секунды]])
  2. Экземпляр объекта Date.setUTCHours(Часы[, Минуты[, Секунды]])

Значения формата записи:

  • Экземпляр объекта Date - Любой операнд значения со значением экземпляра объекта Date.
  • . - Оператор доступа к методу объекта.
  • setHours - Ключевое слово.
  • setUTCHours - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Часы - Целое значение часов, заданное в любом числовом формате.
      Если аргумент опущен, то возникнет ошибка времени выполнения.
      Если значение часы больше 23, или меньше 0, то значения дня и, при необходимости, месяца и года соответственно скорректируются для этого экземпляра объекта Date.
  • Минуты - Целое значение минут, заданное в любом числовом формате.
      Если значение минуты больше 59, или меньше 0, то значения часов и, при необходимости, дня, месяца и года соответственно скорректируются для этого экземпляра объекта Date.
  • Секунды - Целое числовое значение секунд.
      Если значение Секунд больше 59, или меньше 0, то соответственно скорректируются значения минут и,при необходимости, часов, дня, месяца и года.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  setMilliseconds - Устанавливает новое значение миллисекунд времени суток для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time) времени.
  Возвращает число миллисекунд от полночи 1 января 1970 года до времени суток нового значения даты.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.setMilliseconds(Миллисекунды)
  2. Экземпляр объекта Date.setUTCMilliseconds(Миллисекунды)

Значения формата записи:

  • Экземпляр объекта Date - Любой операнд значения со значением экземпляра объекта Date.
  • . - Оператор доступа к методу объекта.
  • setMilliseconds - Ключевое слово.
  • setUTCMilliseconds - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Миллисекунды - Целое значение миллисекунд, заданное в любом числовом формате.
      Если аргумент опущен, то возникнет ошибка времени выполнения.
      Если значение Миллисекунды больше 999, или меньше 0, то значения секунд и, при необходимости, минут, часов, дня, месяца и года соответственно скорректируются для этого экземпляра объекта Date.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  setMinutes - Устанавливает новое значение минут, секунд и миллисекунд времени суток для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time) времени.
  Возвращает число миллисекунд от полночи 1 января 1970 года до времени суток нового значения даты.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.setMinutes(Минуты[, Секунды[, Миллисекунды]])
  2. Экземпляр объекта Date.setUTCMinutes(Минуты[, Секунды[, Миллисекунды]])

Значения формата записи:

  • Экземпляр объекта Date - Любой операнд значения со значением экземпляра объекта Date.
  • . - Оператор доступа к методу объекта.
  • setMinutes - Ключевое слово.
  • setUTCMinutes - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Минуты - Целое значение минут, заданное в любом числовом формате.
      Если аргумент опущен, то возникнет ошибка времени выполнения.
      Если значение минуты больше 59, или меньше 0, то значения часов и, при необходимости, дня, месяца и года соответственно скорректируются для этого экземпляра объекта Date.
  • Секунды - Целое значение секунд, заданное в любом числовом формате.
      Если значение секунды больше 59, или меньше 0, то значения минут и, при необходимости, часов, дня, месяца и года соответственно скорректируются для этого экземпляра объекта Date.
  • Миллисекунды - Целое значение миллисекунд, заданное в любом числовом формате.
      Если значение миллисекунды больше 999, или меньше 0, то значения секунд и, при необходимости, минут, часов, дня, месяца и года соответственно скорректируются для этого экземпляра объекта Date.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  setMonth - Устанавливает новое значение месяца и дня для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time) времени.
  Возвращает число миллисекунд от полночи 1 января 1970 года до времени суток нового значения даты.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.setMonth(Номер месяца[, Номер дня])
  2. Экземпляр объекта Date.setUTCMonth(Номер месяца[, Номер дня])

Значения формата записи:

  • Экземпляр объекта Date - Любой операнд значения со значением экземпляра объекта Date.
  • . - Оператор доступа к методу объекта.
  • setFullYear - Ключевое слово.
  • setUTCFullYear - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Номер месяца - Целое значение месяца, заданное в любом числовом формате.
      Если аргумент опущен, то возникнет ошибка времени выполнения.
      Если значение номер месяца больше 11, или меньше 0, то значение года соответственно скорректируется для этого экземпляра объекта Date.
  • Номер дня - Целое значение дня, заданное в любом числовом формате.
      Если значение номер дня больше количества дней в месяце экземпляра объекта Date, или меньше 1, то значения месяца и, при необходимости, года соответственно скорректируются для этого экземпляра объекта Date.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  setSeconds - Устанавливает новое значение секунд и миллисекунд времени суток для даты, указанной экземпляром объекта, по местному или всемирному (UTC - Universal Coordinated Time) времени.
  Возвращает число миллисекунд от полночи 1 января 1970 года до времени суток нового значения даты.

Формат записи в коде скрипта:

  1. Экземпляр объекта Date.setSeconds(Секунды[, Миллисекунды])
  2. Экземпляр объекта Date.setUTCSeconds(Секунды[, Миллисекунды])

Значения формата записи:

  • Экземпляр объекта Date - Любой операнд значения со значением экземпляра объекта Date.
  • . - Оператор доступа к методу объекта.
  • setSeconds - Ключевое слово.
  • ssetUTCSeconds - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Секунды - Целое значение секунд, заданное в любом числовом формате.
      Если значение секунды больше 59, или меньше 0, то значения минут и, при необходимости, часов, дня, месяца и года соответственно скорректируются для этого экземпляра объекта Date.
  • Миллисекунды - Целое значение миллисекунд, заданное в любом числовом формате.
      Если значение миллисекунды больше 999, или меньше 0, то значения секунд и, при необходимости, минут, часов, дня, месяца и года соответственно скорректируются для этого экземпляра объекта Date.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  setTime - Устанавливает новое значение для даты, указанной экземпляром объекта, количеством миллисекунд от полуночи January 1, 1970 GMT.
  Возвращает число миллисекунд от полночи 1 января 1970 года до времени суток нового значения даты.

Формат записи в коде скрипта:

  • Экземпляр объекта Date.setTime(Миллисекунды)

Значения формата записи:

  setYear - Устанавливает новое значение года для даты, указанной экземпляром объекта.
  Возвращает число миллисекунд от полночи 1 января 1970 года до времени суток нового значения даты.
  Отличается от метода setFullYear возможностью задавать значение года для 20 века двухзначным числом.

Формат записи в коде скрипта:

  • Экземпляр объекта Date.setYear(Номер года)

Значения формата записи:

  toDateString - Возвращает строковое значение даты, указанной экземпляром объекта.
  Вида - Tue May 20 2014.

Формат записи в коде скрипта:

  • Экземпляр объекта Date.toDateString()

Значения формата записи:

  toJSON - Возвращает строку JSON (JavaScript Object Notation — текстовый формат обмена данными JavaScript) - эквивалент значение даты, указанной экземпляром объекта.
  Вида - 2017-02-09T08:24:19.811Z.

Формат записи в коде скрипта:

  • Экземпляр объекта Date.toJSON()

Значения формата записи:

  toUTCString - Возвращает строковое значение даты, указанной экземпляром объекта.
  Вида - Tue, 20 May 2014 15:33:09 GMT.

Формат записи в коде скрипта:

  • Экземпляр объекта Date.toUTCString()

Значения формата записи:

  toLocaleDateString - Возвращает строковое значение даты, указанной экземпляром объекта, в формате предпочтительном для месторасположения устройства, на котором выполняется скрипт.
  Вида - 20.5.2014.

Формат записи в коде скрипта:

  • Экземпляр объекта Date.toLocaleDateString()

Значения формата записи:

  toLocaleString - Возвращает строковое значение даты и времени суток, указанных экземпляром объекта, в формате предпочтительном для месторасположения устройства, на котором выполняется скрипт.
  Вида - 20.5.2014 21:45:52.

Формат записи в коде скрипта:

  • Экземпляр объекта Date.toLocaleString()

Значения формата записи:

  toLocaleTimeString - Возвращает строковое значение времени суток для даты, указанной экземпляром объекта, в формате предпочтительном для месторасположения устройства, на котором выполняется скрипт.
  Вида - 21:49:38.

Формат записи в коде скрипта:

  • Экземпляр объекта Date.toLocaleTimeString()

Значения формата записи:

  toTimeString - Возвращает строковое значение времени суток на устройстве, на котором выполняется скрипт, для даты, указанной экземпляром объекта.
  Вида - 21:55:59 GMT+0600 (RTZ 4 (зима)).

Формат записи в коде скрипта:

  • Экземпляр объекта Date.toTimeStringg()

Значения формата записи: