Date
Позволяет работать с датой и временем.
Объект ядра
Реализован в
JavaScript 1.0, NES 2.0
JavaScript 1.1: добавлено свойство prototype.
JavaScript 1.3: убрана зависимость от платформы, чтобы дать универсальное поведение на всех платформах; добавлен параметр ms_num в конструктор Date; добавлены методы , , , , и UTC-методы (такие как и ).
Создание
Конструктор 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.
Строковое значение, представляющее дату. Строка должна иметь формат, распознаваемый методом .
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/год для специфицированной даты в соответствии с локальным временем.
Возвращает month/месяц для специфицированной даты в соответствии с локальным временем.
Возвращает смещение часового пояса в минутах для данной местности.
Возвращает день (число) месяца в специфицированной дате в соответствии с универсальным временем.
Возвращает день недели в специфицированной дате в соответствии с универсальным временем.
Возвращает год в специфицированной дате в соответствии с универсальным временем.
Возвращает часы в специфицированной дате в соответствии с универсальным временем.
Возвращает миллисекунды в специфицированной дате в соответствии с универсальным временем.
Возвращает минуты в специфицированной дате в соответствии с универсальным временем.
Возвращает месяц в специфицированной дате в соответствии с универсальным временем.
Возвращает секунды в специфицированной дате в соответствии с универсальным временем.
Возвращает год в специфицированной дате в соответствии с местным временем.
Возвращает количество миллисекунд, прошедших до данной даты после 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)
