Ядро JavaScript 1.5. Справочник


Date


Позволяет работать с датой и временем.

Объект ядра

Реализован в

JavaScript 1.0, NES 2.0

JavaScript 1.1: добавлено свойство prototype.

JavaScript 1.3: убрана зависимость от платформы, чтобы дать универсальное поведение на всех платформах; добавлен параметр ms_num в конструктор Date; добавлены методы , , , , и UTC-методы (такие как и ).

Версия ECMA

ECMA-262


Создание

Конструктор Date:

new Date()

new Date(milliseconds)

new Date(dateString)

new Date(yr_num, mo_num, day_num

[, hr_num, min_num, sec_num, ms_num])

 

Версии до JavaScript 1.3:

new Date()

new Date(milliseconds)

new Date(dateString)

new Date(yr_num, mo_num, day_num[, hr_num, min_num, sec_num])


Параметры

milliseconds

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

dateString

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

yr_num, mo_num,
day_num

Целые значения, представляющие часть даты. Как целочисленное значение, месяц представляется цифрами от 0 до 11, где 0=January и 11=December.

hr_num, min_num,
sec_num, ms_num

Целые значения, представляющие часть даты.


Описание

Если Вы не задаёте никаких аргументов, конструктор создаёт объект Date для текущей даты и времени в соответствии с локальным/системным временем. Если Вы задаёте несколько аргументов, но не все, отсутствующие аргументы устанавливаются в 0. Если Вы задаёте несколько аргументов, Вы обязаны ввести как минимум year, month и day. Можно опустить hours, minutes, seconds и milliseconds.

Дата измеряется в миллисекундах, прошедших после полуночи 01 января 1970 года по Гринвичу/UTC. Один день состоит из 86,400,000 миллисекунд. Объект Date имеет диапазон от -100,000,000 до 100,000,000 дней относительно 01 января 1970 года по UTC.

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

Объект Date поддерживает несколько UTC-методов (универсальных), а также методы работы с локальным временем. UTC, известное также как Greenwich Mean Time (GMT)/время по Гринвичу, ссылается на время, установленное стандартом World Time Standard. Локальное время это время, известное компьютеру, на котором выполняется JavaScript.

Для обеспечения перехода в новое тысячелетие (2000 год) Вы всегда должны специфицировать год полностью; например, использовать 1998, а не 98. Чтобы помочь Вам в установке полный год, JavaScript имеет методы getFullYear, setFullYear, getFullUTCYear

и setFullUTCYear.

Следующий пример возвращает время в миллисекундах, прошедшее в период от timeA до timeB:

timeA = new Date();
// Здесь операторы, выполняющие какие-либо действия.

timeB = new Date();
timeDifference = timeB - timeA;


Обратная Совместимость


JavaScript 1.2 и более ранние версии.

Объект Date работает так:

  • Даты до 1970 года недопустимы.

  • JavaScript зависит от специфики поведения даты на конкретной платформе; поведение объекта Date меняется, в зависимости от платформы.


Свойства. Резюме.

Свойство

Описание

Специфицирует функцию, создающую прототип объекта.

Позволяет добавлять свойства к объекту Date.

 


Методы. Резюме.

 

Метод

Описание

Возвращает день месяца для специфицированной даты в соответствии с локальным временем.

Возвращает день недели для специфицированной даты в соответствии с локальным временем.

Возвращает year/год для специфицированной даты в соответствии с локальным временем.

Возвращает hour/час для специфицированной даты в соответствии с локальным временем.

Возвращает milliseconds/миллисекунды для специфицированной даты в соответствии с локальным временем.

Возвращает minutes/минуты для специфицированной даты в соответствии с локальным временем.

Возвращает month/месяц для специфицированной даты в соответствии с локальным временем.

Возвращает seconds/секунды для специфицированной даты в соответствии с локальным временем.

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

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

Возвращает день (число) месяца в специфицированной дате в соответствии с универсальным временем.

Возвращает день недели в специфицированной дате в соответствии с универсальным временем.

Возвращает год в специфицированной дате в соответствии с универсальным временем.

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

Возвращает миллисекунды в специфицированной дате в соответствии с универсальным временем.

Возвращает минуты в специфицированной дате в соответствии с универсальным временем.

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

Возвращает секунды в специфицированной дате в соответствии с универсальным временем.

Возвращает год в специфицированной дате в соответствии с местным временем.

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

Устанавливает число/день месяца в специфицированной дате в соответствии с местным временем.

Устанавливает полный год в специфицированной дате в соответствии с местным временем.

Устанавливает часы в специфицированной дате в соответствии с местным временем.

Устанавливает миллисекунды в специфицированной дате в соответствии с местным временем.

Устанавливает минуты в специфицированной дате в соответствии с местным временем.

Устанавливает месяц в специфицированной дате в соответствии с местным временем.

Устанавливает секунды в специфицированной дате в соответствии с местным временем.

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

Устанавливает число/день месяца в специфицированной дате в соответствии с универсальным временем.

Устанавливает полный год в специфицированной дате в соответствии с универсальным временем.

Устанавливает часы в специфицированной дате в соответствии с универсальным временем.

Устанавливает миллисекунды в специфицированной дате в соответствии с универсальным временем.

Устанавливает минуты в специфицированной дате в соответствии с универсальным временем.

Устанавливает месяц в специфицированной дате в соответствии с универсальным временем.

Устанавливает секунды в специфицированной дате в соответствии с универсальным временем.

Устанавливает год в специфицированной дате в соответствии с локальным временем.

Конвертирует дату в строку, используя соглашения Internet GMT.

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

Возвращает литерал объекта, представляющий специфицированный объект Date; Вы можете использовать это значение для создания нового объекта. Переопределяет метод .

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

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

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

Возвращает примитивное значение объекта Date. Переопределяет метод .

Кроме того, Этот объект наследует методы и из .


Примеры

Вот разные примеры назначения времени:

 

today = new Date()

birthday = new Date("December 17, 1995 03:24:00")

birthday = new Date(95,11,17)

birthday = new Date(95,11,17,3,24,0)

 





- Начало -  - Назад -  - Вперед -



Книжный магазин