Объект Date - это тип данных, встроенный в язык JavaScript. Объекты Date создаются с помощью функции 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])Примечание. Параметры в скобках всегда являются необязательными.
Вот описание параметров –
- Нет аргумента. Без аргументов конструктор
Date()создает объект Date, установленный на текущую дату и время. - Миллисекунды. Когда передается один числовой аргумент, он принимается как внутреннее числовое представление даты в миллисекундах, как возвращается методом
getTime(). Например, передача аргумента 5000 создает дату, которая представляет пять секунд за полночь на 1/1/70. Datestring. Когда передается один строковый аргумент, это строковое представление даты в формате, принятом методомDate.parse().- 7 аргументов - использовать последнюю форму конструктора, показанного выше. Ниже приведено описание каждого аргумента:
- year - Целочисленное значение, представляющее год. Для совместимости (во избежание проблемы с Y2K) вы всегда должны указывать год полностью; используйте 1998 год, а не 98.
- month - Целочисленное значение, представляющее месяц, начиная с 0 для января до 11 декабря.
- date - Целочисленное значение, представляющее день месяца.
- hour - Целочисленное значение, представляющее час дня (24-часовая шкала).
- minute - Целое значение, представляющее минутный отрезок времени.
- second - Целочисленное значение, представляющее второй сегмент времени.
- millisecond - целочисленное значение, представляющее миллисекундный сегмент времени.
Свойства даты
Ниже приведен список свойств объекта Date вместе с их описанием.
| Метод | Описание |
|---|---|
| constructor | Указывает функцию, которая создает прототип объекта. |
| prototype | Свойство prototype позволяет добавлять свойства и методы к объекту |
Методы даты
Ниже приведен список методов, используемых с датой и их описанием.
| Метод | Описание |
|---|---|
| Date() | Возвращает сегодняшнюю дату и время |
| getDate() | Возвращает день месяца для указанной даты в соответствии с местным временем. |
| getDay() | Возвращает день недели для указанной даты в соответствии с местным временем. |
| getFullYear() | Возвращает год указанной даты в соответствии с местным временем. |
| getHours() | Возвращает час в указанную дату в соответствии с местным временем. |
| getMilliseconds() | Возвращает миллисекунды в указанную дату в соответствии с местным временем. |
| getMinutes() | Возвращает минуты в указанную дату в соответствии с местным временем. |
| getMonth() | Возвращает месяц в указанную дату в соответствии с местным временем. |
| getSeconds() | Возвращает секунды в указанную дату в соответствии с местным временем. |
| getTime() | Возвращает числовое значение указанной даты как число миллисекунд с 1 января 1970 года, 00:00:00 по UTC. |
| getTimezoneOffset() | Возвращает смещение временной зоны в минутах для текущей локали. |
| getUTCDate() | Возвращает день (дату) месяца в указанную дату в соответствии с универсальным временем. |
| getUTCDay() | Возвращает день недели в указанную дату в соответствии с универсальным временем. |
| getUTCFullYear() | Возвращает год в указанную дату в соответствии с универсальным временем. |
| getUTCHours() | Возвращает часы в указанную дату в соответствии с универсальным временем. |
| getUTCMilliseconds() | Возвращает миллисекунды в заданную дату в соответствии с универсальным временем. |
| getUTCMinutes() | Возвращает минуты в указанную дату в соответствии с универсальным временем. |
| getUTCMonth() | Возвращает месяц в указанную дату в соответствии с универсальным временем. |
| getUTCSeconds() | Возвращает секунды в заданную дату в соответствии с универсальным временем. |
| getYear() | Устаревший - возвращает год в указанную дату в соответствии с местным временем. Вместо этого используйте getFullYear. |
| setDate() | Устанавливает день месяца для указанной даты в соответствии с местным временем. |
| setFullYear() | Устанавливает полный год на указанную дату в соответствии с местным временем. |
| setHours() | Устанавливает часы для указанной даты в соответствии с местным временем. |
| setMilliseconds() | Устанавливает миллисекунды на заданную дату в соответствии с местным временем. |
| setMinutes() | Устанавливает минуты для указанной даты в соответствии с местным временем. |
| setMonth() | Устанавливает месяц для указанной даты в соответствии с местным временем. |
| setSeconds() | Устанавливает секунды для указанной даты в соответствии с местным временем time. |
| setTime() | Устанавливает объект Date на время, представленное рядом миллисекунды с 1 января 1970 года, 00:00:00 UTC. |
| setUTCDate() | Устанавливает день месяца для указанной даты в соответствии с универсальным временем . |
| setUTCFullYear() | Устанавливает полный год для указанной даты в соответствии с универсальным временем . |
| setUTCHours() | Устанавливает час для указанной даты в соответствии с универсальным временем. |
| setUTCMilliseconds() | Устанавливает миллисекунды на указанную дату в соответствии с универсальным временем. |
| setUTCMinutes() | Устанавливает минуты для указанной даты в соответствии с универсальным временем . |
| setUTCMonth() | Устанавливает месяц для указанная дата в соответствии с универсальным временем. |
| setUTCSeconds() | Устанавливает секунды для указанной даты в соответствии с универсальным временем. |
| setYear() | Устаревшее - устанавливает год для указанной даты в соответствии с местным временем. Используйте setFullYear вместо нее. |
| toDateString() | Возвращает часть даты Date как удобочитаемую строку. |
| toGMTString() | Устаревшая - преобразует дату в строку, используя соглашения об интернет-GMT. Используйте toUTCString вместо нее. |
| toLocaleDateString() | Возвращает часть даты Date в виде строки, используя соглашения текущей локали. |
| toLocaleFormat() | Преобразует дату в строку, используя формат string. |
| toLocaleString() | Преобразует дату в строку , используя текущие соглашения locale. |
| toLocaleTimeString() | Возвращает часть времени Date в виде строки, используя соглашения текущей локали. |
| toSource() | Возвращает строку, представляющую источник для эквивалентного объекта Date; вы можете использовать это значение для создания нового объекта . |
| toString() | Возвращает строку, представляющую указанный объект Date. |
| toTimeString() | Возвращает часть времени Date как удобочитаемую строку. |
| toUTCString() | Преобразует дату в string, используя универсальное время convention. |
| valueOf() | Возвращает примитивное значение объекта Date. |
Статические методы.
Помимо многих методов экземпляров, перечисленных ранее, объект Date также определяет два статических метода. Эти методы вызывается с помощью самого конструктора Date().
| Метод | Описание |
|---|---|
| Date.parse() | Разбирает строковое представление даты и времени и возвращает внутреннее представление в миллисекундах этой даты. |
| Date.UTC() | Возвращает миллисекундное представление указанной даты UTC и время. |