Обновлено: 07.06.2018 09:08

JavaScript - объект Date

Внутренний объект, который обеспечивает основные возможности работы с датами и временем.

Синтаксис

dateObj = new Date() dateObj = new Date(dateVal) dateObj = new Date(year, month, date[, hours[, minutes[, seconds[,ms]]]])

Параметры

dateObj

Обязательное. Имя переменной, которой присваивается объект Date.

dateVal

Обязательное. В случае числового значения параметр dateVal представляет количество миллисекунд в формате UTC между указанной датой и полуночью 1 января 1970 г. В случае строкового значения параметр dateVal анализируется в соответствии с правилами форматирования. Аргумент dateVal также может быть значением VT_DATE, возвращаемым некоторыми объектами ActiveX.

year

Обязательное. Полное представление года, например 1976 (а не 76).

month

Обязательное. Месяц, представляемый в виде числа от 0 до 11 (с января по декабрь).

date

Обязательное. Дата в виде целого числа в диапазоне от 1 до 31.

hours

Необязательный параметр. Необходимо задавать, если задается значение minutes. Целое число от 0 до 23 (от полуночи до 23:00), представляющее час.

minutes

Необязательный параметр. Необходимо задавать, если задается значение seconds. Целое число от 0 до 59, представляющее минуты.

seconds

Необязательный параметр. Необходимо задавать, если задается значение milliseconds. Целое число от 0 до 59, представляющее секунды.

Необязательный параметр. Целое число от 0 до 999, представляющее миллисекунды.

Объект Date содержит число, представляющее определенный момент времени с точностью до миллисекунды. Если значение аргумента превышает верхнюю границу его диапазона или является отрицательным числом, остальные хранящиеся значения изменяются соответственно. Например, если задать 150 секунд, JavaScript переопределит это число как две минуты и 30 секунд.

Если число равно NaN, объект не представляет конкретный момент времени. Если не передавать параметры объекту Date, он инициализируется текущим временем (UTC). Перед использованием этого объекта ему необходимо присвоить значение.

Диапазон дат, которые могут быть представлены объектом Date, составляет около 285 616 в каждую сторону от 1 января 1970 г.

Пример

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

var dateString = "Today's date is: "; var newDate = new Date(); // Get the month, day, and year. dateString += (newDate.getMonth() + 1) + "/"; dateString += newDate.getDate() + "/"; dateString += newDate.getFullYear(); document.write(dateString); // Output: Today's date is: <date>

Свойства

В следующей таблице перечислены свойства Date Object.

Свойство	Описание
Свойство сonstructor	Указывает функцию, которая создает объект.
Свойство prototype	Возвращает ссылку на прототип класса объектов.

Функции

В следующей таблице перечислены функции Date Object.

Функции	Описание
Date.now	Возвращает число миллисекунд между 1 января 1970 г. и текущими датой и временем.
Date.parse	Выполняет синтаксический анализ строки, содержащей дату, и возвращает количество миллисекунд, истекших с полуночи 1 января 1970 г.
Date.UTC	Возвращает количество миллисекунд, истекших с полуночи 1 января 1970 года до указанной даты, используя время в формате UTC (или время GMT).

Методы

В следующей таблице перечислены методы Date Object.

Метод	Описание
getDate	Возвращает значение дня месяца, используя местное время.
getDay	Возвращает значение дня недели, используя местное время.
getFullYear	Возвращает значение года, используя местное время.
getHours	Возвращает значение часов, используя местное время.
getMilliseconds	Возвращает значение миллисекунд, используя местное время.
getMinutes	Возвращает значение минут, используя местное время.
getMonth	Возвращает значение месяца, используя местное время.
getSeconds	Возвращает значение секунд, используя местное время.
getTime	Возвращает значение времени в объекте Date в виде количества миллисекунд, истекших с полуночи 1 января 1970 г.
getTimezoneOffset	Возвращает разницу в минутах между временем на локальном компьютере и временем в формате UTC.
getUTCDate	Возвращает значение дня месяца, используя время в формате UTC.
getUTCDay	Возвращает значение дня недели, используя время в формате UTC.
getUTCFullYear	Возвращает значение года, используя время в формате UTC.
getUTCHours	Возвращает значение часов, используя время в формате UTC.
getUTCMilliseconds	Возвращает значение миллисекунд, используя время в формате UTC.
getUTCMinutes	Возвращает значение минут, используя время в формате UTC.
getUTCMonth	Возвращает значение месяца, используя время в формате UTC.
getUTCSeconds	Возвращает значение секунд, используя время в формате UTC.
getVarDate	Возвращает значение VT_DATE в объекте Date.
getYear	Возвращает значение года.
hasOwnProperty	Возвращает логическое значение, указывающее, содержит ли объект свойство с указанным именем.
isPrototypeOf	Возвращает логическое значение, указывающее, существует ли объект в другом объекте цепочки прототипов.
propertyIsEnumerable	Возвращает логическое значение, определяющее, является ли указанное свойство частью объекта, и является ли оно перечислимым.
setDate	Задает числовой день месяца, используя местное время.
setFullYear	Задает значение года, используя местное время.
setHours	Задает значение часов, используя местное время.
setMilliseconds	Задает значение миллисекунд, используя местное время.
setMinutes	Задает значение минут, используя местное время.
setMonth	Задает значение месяца, используя местное время.
setSeconds	Задает значение секунд, используя местное время.
setTime	Устанавливает значение даты и времени в объекте Date.
setUTCDate	Задает числовой день месяца, используя время в формате UTC.
setUTCFullYear	Задает значение года, используя время в формате UTC.
setUTCHours	Задает значение часов, используя время в формате UTC.
setUTCMilliseconds	Задает значение миллисекунд, используя время в формате UTC.
setUTCMinutes	Задает значение минут, используя время в формате UTC.
setUTCMonth	Задает значение месяца, используя время в формате UTC.
setUTCSeconds	Задает значение секунд, используя время в формате UTC.
setYear	Задает значение года, используя местное время.
toDateString	Возвращает дату в виде строкового значения.
toGMTString	Возвращает дату, преобразованную в строку с помощью времени GMT.
toISOString	Возвращает дату в виде строкового значения в формате ISO.
toJSON	Используется для преобразования данных типа объекта перед сериализацией JSON.
toLocaleDateString	Возвращает дату в виде строки, соответствующей текущему языковому стандарту хост-среды.
toLocaleString	Возвращает объект, преобразованный в строку, используя текущий языковой стандарт.
toLocaleTimeString	Возвращает время в виде строки, соответствующей текущему языковому стандарту хост-среды.
toString	Возвращает строковое представление объекта.
toTimeString	Возвращает время в виде строкового значения.
toUTCString	Возвращает дату, преобразованную в строку с использованием времени в формате UTC.
valueOf	Возвращает примитивное значение указанного объекта.

Формат даты

YYYY-MM-DDTHH:mm:ss.sssZ

В следующей таблице описаны компоненты этого формата.

Символ	Описание	Значения
-, :, ., T	Фактические символы строки. T указывает точку отсчета времени.
YYYY	Год. Вместо 4-значного представления года может использоваться расширенное представление.
MM	Месяц.	От 01 до 12
DD	День месяца.	От 01 до 31
HH	Часы.	От 00 до 24
mm	Минуты	От 00 до 59
ss	Секунды. При задании времени указывать секунды и миллисекунды необязательно.	От 00 до 59
sss	Milliseconds	От 00 до 999
Z	Значение в этой позиции может быть одним из указанных ниже. Если значение не задано, используется время в формате UTC. Z означает время в формате UTC. +hh:mm означает, что введенное время представляет собой смещение относительно времени в формате UTC в сторону увеличения. -hh:mm означает, что введенное время представляет абсолютное значение указанного смещения относительно времени в формате UTC в сторону уменьшения.

Строка может содержать только дату, как в следующих форматах:

YYYY, YYYY-MM, YYYY-MM-DD.

В формате ISO имена часовых поясов не поддерживаются. Для задания смещения относительно времени в формате UTC можно использовать позицию Z. Если значение в позиции Z не указано, используется время в формате UTC.

Полночь можно указать значением 00:00:00 или значением 24:00:00 предыдущего дня. Следующие две строки определяют одно и то же время: 2010-05-25T00:00 и 2010-05-24T24:00.

Чтобы вернуть дату в формате ISO, можно использовать Метод toISOString (Date) (JavaScript).

Расширенные года

Расширенный формат года содержит 6 цифр вместо 4 с предшествующим знаком плюс или минус. Пример расширенного представления года — +002010. Это представление эквивалентно представлению 2010. Такой расширенный формат можно использовать для представления года до 0-го и после 9999-го.

При использовании 6-значного формата должен присутствовать знак плюс или минус. При использовании 4-значного формата знака быть не должно. Следовательно, значения 0000 и +000000 допустимы, а значения 000000 и -0001 приводят к ошибке. Расширенное представление года 0 считается положительным и поэтому в качестве префикса для него используется знак плюс.

Для представления года до 0-го и после 9999-го Метод toISOString (Date) (JavaScript) всегда использует расширенный формат.

Примечание
Поддерживается в следующих режимах документов: стандартный режим Internet Explorer 9, стандартный режим Internet Explorer 10 и стандартный режим Internet Explorer 11. Не поддерживается в следующих режимах документов: случайный режим, стандартный режим Internet Explorer 6, стандартный режим Internet Explorer 7, стандартный режим Internet Explorer 8.

Примечание

Поддерживается в следующих режимах документов: стандартный режим Internet Explorer 9, стандартный режим Internet Explorer 10 и стандартный режим Internet Explorer 11.

Не поддерживается в следующих режимах документов: случайный режим, стандартный режим Internet Explorer 6, стандартный режим Internet Explorer 7, стандартный режим Internet Explorer 8.

Другие форматы даты

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

Краткие форматы даты

Формат должен быть следующий: месяц/день/год, например 06/08/2010.

В качестве разделителя может использоваться символ «/» или «-».

Длинные форматы даты

Год, месяц и день могут размещаться в любом порядке. " Например, допустимы значения June 8 2010 и 2010 June 8.

Год может содержать две или четыре цифры. Если год содержит только две цифры, он должен быть не ранее 70-го.

Имена месяцев и дней должны содержать не менее двух знаков. Неуникальные двузначные имена преобразуются в последнее соответствующее имя. Например, Ju означает июль, а не июнь.

Если день недели не совместим с остальной частью указанной даты, он игнорируется. Например, Tuesday November 9 1996 преобразуется в Friday November 9 1996, поскольку правильный день недели для этой даты — пятница.

Форматы времени

Часы, минуты и секунды разделяются символом двоеточия. Некоторые компоненты можно опускать. Допустимы следующие значения: «10:», «10:11» и «10:11:12».

Если указано PM и задан час не менее 13, возвращается значение NaN. Например, при задании «23:15 PM» возвращается значение NaN.

Общие правила

Строка, содержащая недопустимое значение даты, возвращает значение NaN. Например, строка, содержащая два года или два месяца, возвращает значение NaN.

В JavaScript поддерживаются все стандартные часовые пояса, время в формате UTC и время по Гринвичу (GMT). (В формате ISO часовые пояса не поддерживаются.)

Текст, заключенный в скобки, считается комментарием. Скобки могут быть вложенными.

Запятые и пробелы считаются разделителями. Разрешается использовать несколько разделителей.

Пример

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

document.writeln((new Date("2010")).toUTCString()); document.writeln((new Date("2010-06")).toUTCString()); document.writeln((new Date("2010-06-09")).toUTCString()); // Specifies Z, which indicates UTC time. document.writeln((new Date("2010-06-09T15:20:00Z")).toUTCString()); // Specifies -07:00 offset, which is equivalent to Pacific Daylight time. document.writeln((new Date("2010-06-09T15:20:00-07:00")).toGMTString()); // Specifies a non-ISO Long date. document.writeln((new Date("June 9, 2010")).toUTCString()); // Specifies a non-ISO Long date. document.writeln((new Date("2010 June 9")).toUTCString()); // Specifies a non-ISO Short date and time. document.writeln((new Date("6/9/2010 3:20 pm")).toUTCString()); // Output: // Fri, 1 Jan 2010 00:00:00 UTC // Tue, 1 Jun 2010 00:00:00 UTC // Wed, 9 Jun 2010 00:00:00 UTC // Wed, 9 Jun 2010 15:20:00 UTC // Wed, 9 Jun 2010 22:20:00 UTC // Wed, 9 Jun 2010 07:00:00 UTC // Wed, 9 Jun 2010 07:00:00 UTC // Wed, 9 Jun 2010 22:20:00 UTC

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

WEB start

Компьютеры. Интернет. Профессиональное обучение. 055-966-10-17

Программирование на JavaScript, DOM

Наши преимущества

Регистрация на сайте

Дополнительные материалы