JavaScript — Объект Date

Объект Date является типом данных, встроенным в языке JavaScript. Объект Date создается с помощью new Date( ), как показано ниже.

После создания объекта Date, существует ряд методов, которые позволяют работать с ним. Большинство методов просто позволяют получить и установить поле объекта: год, месяц, день, час, минуту, секунду и миллисекунду, используя либо местное время или UTC (универсальное, или GMT).

Стандарт ECMAScript требует от объекта Date, иметь возможность представлять любую дату и время, с точностью до миллисекунды, в течение 100 миллионов дней до или после 1/1/1970. Это диапазон плюс или минус 273,785 лет, поэтому JavaScript может представлять дату и время до 275755 года.

Синтаксис

Вы можете использовать любой из следующих синтаксисов для создания объекта Date с помощью конструктора Date():

new Date( )
new Date(milliseconds)
new Date(datestring)
new Date(year,month,date[,hour,minute,second,millisecond ])

 

[gn_box title=»Примечание:» box_color=»#91b5ff»]Параметры в скобках всегда являются дополнительными.[/gn_box]

Вот описание параметров:

• Нет аргументов — Без аргументов, конструктор date() создает объект date с текущей датой и временем.
• milliseconds — Когда один числовой аргумент передается, он берется в качестве внутреннего числового представления даты в миллисекундах, возвращенное методом GetTime(). Например, передавая аргумент 5000, создает дату, которая представляет пять секунд за полночь на 1/1/70.
• datestring — Когда один аргумент передает строку, это строковое представление даты в формате, принятом методом Date.parse().
• 7 agruments — Для того, чтобы использовать последнюю форму конструктора, показанные выше. Ниже приведено описание каждого аргумента:
  • year — Целочисленное значение, представляющее год. Для обеспечения совместимости (для того, чтобы избежать проблемы Y2K), вы должны всегда указывать год в полном объеме; использовать 1998, а не 98.
  • month — Целочисленное значение, представляющее месяц, начиная с 0 за январь 11 за декабрь.
  • date — Целочисленное значение, представляющее день месяца.
  • hour — Целочисленное значение, представляющее час дня (24-часовая шкала).
  • minute — Целое значение, представляющее минутный отрезок времени.
  • second — Значение, целое число, представляющее секундный отрезок времени.
  • millisecond — Целочисленное значение, представляющее миллисекундный отрезок времени.

Свойства Date

Вот список свойств объекта Date наряду с их описанием.

№	Свойства & Описание
1	constructor — Определяет функцию, которая создает прототип объекта.
2	prototype — Свойство прототипа позволяет добавлять свойства и методы объекта

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

Методы Date

Вот список методов, используемых с Date и их описание.

№	Метод & Описание
1	date() — Возвращает текущую дату и время
2	GetDate() — Возвращает день месяца для указанной даты по местному времени.
3	getDay() — Возвращает день недели для указанной даты по местному времени.
4	getFullYear() — Возвращает год указанной даты по местному времени.
5	getHours() — Возвращает час в указанную дату по местному времени.
6	getMilliseconds() — Возвращает миллисекунды в указанной дате в соответствии с местным временем.
7	getMinutes() — Возвращает минуты в указанной дате по местному времени.
8	getMonth() — Возвращает месяц в указанной дате в соответствии с местным временем.
9	getSeconds() — Возвращает секунды в указанной дате по местному времени.
10	GetTime() — Возвращает числовое значение указанной даты как количество миллисекунд, начиная с 1 января 1970 года, 00:00:00 UTC.
11	getTimezoneOffset() — Возвращает смещение часового пояса в минутах для данной местности.
12	getUTCDate() — Возвращает день (дату) месяца в указанной дате в соответствии с универсальным временем.
13	getUTCDay() — Возвращает день недели в указанной дате в соответствии с универсальным временем.
14	getUTCFullYear() — Возвращает год в указанной дате в соответствии с универсальным временем.
15	getUTCHours() — Возвращает часы в указанной дате в соответствии с универсальным временем.
16	getUTCMilliseconds() — Возвращает миллисекунды в указанной дате в соответствии с универсальным временем.
17	getUTCMinutes() — Возвращает минуты в указанной дате в соответствии с универсальным временем.
18	getUTCMonth() — Возвращает месяц в указанной дате в соответствии с универсальным временем.
19	getUTCSeconds() — Возвращает секунды в указанной дате в соответствии с универсальным временем.
20	getYear() — Возвращает год указанной даты по местному времени (Устаревшее). Используйте вместо него getFullYear.
21	setdate() — Устанавливает день месяца для указанной даты по местному времени.
22	setFullYear() — Устанавливает полный год для указанной даты по местному времени.
23	setHours() — Устанавливает часы для указанной даты по местному времени.
24	setMilliseconds() — Устанавливает миллисекунды для указанной даты по местному времени.
25	setMinutes() — Устанавливает минуты для указанной даты по местному времени.
26	setMonth() — Устанавливает месяц для указанной даты по местному времени.
27	setSeconds() — Устанавливает секунды для указанной даты по местному времени.
28	setTime() — Устанавливает объект Date на временя, представленному числом миллисекунд, прошедших с 1 января 1970 года, 00:00:00 UTC.
29	setUTCDate() — Устанавливает день месяца для указанной даты по всемирному времени.
30	setUTCFullYear() — Устанавливает полный год для указанной даты по всемирному времени.
31	setUTCHours() — Устанавливает час для указанной даты по всемирному времени.
32	setUTCMilliseconds() — Устанавливает миллисекунды для указанной даты по всемирному времени.
33	setUTCMinutes() — Устанавливает минуты для указанной даты по всемирному времени.
34	setUTCMonth() — Устанавливает месяц для указанной даты по всемирному времени.
35	setUTCSeconds() — Устанавливает секунды для указанной даты по всемирному времени.
36	setYear() — Устанавливает год для указанной даты по местному времени (Устаревший). Используйте вместо setFullYear.
37	toDateString() — Возвращает «date» как часть даты в виде строки.
38	toGMTString() — Преобразует дату в строку, используя соглашения Internet GMT (Устаревший). Используйте toUTCString.
39	toLocaleDateString() — Возвращает «date» как часть даты в виде строки, используя соглашения текущего локального времени.
40	toLocaleFormat() — Преобразует дату в строку, используя строку формата.
41	toLocaleString() — Преобразует дату в строку, используя текущее локальное время.
42	toLocaleTimeString() — Возвращает «time» как часть даты в виде строки, используя соглашения текущего локального времени.
43	toSource() — Возвращает строку, представляющую исходный код для эквивалентного объекта Date; Вы можете использовать это значение для создания нового объекта.
44	toString() — Возвращает строку, представляющую определенный объект Date.
45	toTimeString() — Возвращает «time» как часть даты в виде читабельной строки.
46	toUTCString() — Преобразует дату в строку, используя используя соглашение универсального времени.
47	valueOf() — Возвращает простейшее значение объекта Date.

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

Статические методы date

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

Sr.No	Метод & Описание
1	Date.parse() — Анализирует строковое представление даты и времени и возвращает внутреннее представление миллисекунды этой даты.
2	Date.UTC() — Возвращает миллисекунды представление указанной даты и времени UTC.

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