Объект Date позволяет работать с датами и временем. Для создания нового объекта Date используется следующий синтаксис:

New Date()

Даты хранятся в нём как количество миллисекунд, прошедших с полуночи 1 января 1970 г. согласно единому всемирному времени (UTC). Благодаря такому формату с помощью Date можно точно представлять даты, отстоящие от 1 января 1970 г. на 285616 лет.

Если конструктор Date вызывается без аргументов, создаётся объект с текущими значениями даты и времени. Для создания объекта Date с определенной датой или временем, необходимо будет передать один из четырех возможных параметров:

• миллисекунды: значение должно быть числом миллисекунд с 01.01.1970 var birthDate = new Date(8298400000); document.write(birthDate);
• строка с датой: любая дата в формате поддерживаемом методом parse() var birthDate = new Date("April 16, 1975"); document.write(birthDate);
• год, месяц, день var birthDate = new Date(1975, 4, 28); document.write(birthDate);

  Обратите внимание, что число 4 соответствует маю месяцу. Это значит, что январю соответствует число 0. Аналогичным образом вычисляются и дни, только нулю в этом случае соответствует воскресенье.

• год, месяц, день, час, минуты, секунды, миллисекунды

При работе с объектом Date важно помнить, что вычисления выполняются с использованием единого всемирного времени (UTC), несмотря на то, что ваш компьютер может отображать время в соответствии с вашей временной зоной.

Методы Метод Описание

getDate()	Возвращает день месяца (от 1 до 31) для указанной даты по местному времени.
getDay()	Возвращает день недели (от 0 до 6; 0 = воскресенье, 1 = понедельник и т.д.) для указанной даты по местному времени..
getFullYear()	Возвращает год (четыре цифры).
getHours()	Возвращает час (от 0 до 23).
getMilliseconds()	Возвращает миллисекунды (от 0 до 999).
getMinutes()	Возвращает минуты (от 0 до 59).
getMonth()	Возвращает месяц (от 0 до 11; 0 = январь, 1 = февраль и т.д.).
getSeconds()	Возвращает секунды (от 0 до 59).
getTime()	Возвращает количество миллисекунд, прошедших с полуночи 01.01.1970.
getTimezoneOffset()	Возвращает разницу во времени между временем UTC и местным временем, в минутах.
getUTCDate()	Возвращает день месяца по всемирному времени (от 1 до 31).
getUTCDay()	Возвращает день недели по всемирному времени (от 0 до 6).
getUTCFullYear()	Возвращает год по всемирному времени (четыре цифры).
getUTCHours()	Возвращает час по всемирному времени (от 0 до 23).
getUTCMilliseconds()	Возвращает миллисекунды по всемирному времени (от 0 до 999).
getUTCMinutes()	Возвращает минуты по всемирному времени (от 0 до 59).
getUTCMonth()	Возвращает месяц по всемирному времени (от 0 до 11).
getUTCSeconds()	Возвращает секунды по всемирному времени (от 0 до 59).
parse()	Анализирует строку даты (например, "21 мая 1992 года") и возвращает строку со значением даты, которая содержит число в миллисекундах с 1 января 1970 00:00:00.
setDate()	Устанавливает день месяца для указанной даты по местному времени (от 1 до 31).
setFullYear()	Устанавливает год (четыре цифры).
setHours()	Устанавливает часы для указанной даты по местному времени (от 0 до 23).
setMilliseconds()	Устанавливает миллисекунды для указанной даты по местному времени.
setMinutes()	Устанавливает минуты (от 0 до 59).
setMonth()	Устанавливает месяц (от 0 до 11).
setSeconds()	Устанавливает секунды (от 0 до 59).
setTime()	Устанавливает дату в миллисекундах после (или до) 01.01.1970.
setUTCDate()	Задает день месяца.
setUTCFullYear()	Устанавливает год по всемирному времени (четыре цифры).
setUTCHours()	Устанавливает час для указанной даты по всемирному времени.
setUTCMilliseconds()	Задает миллисекунды для указанной даты по всемирному времени.
setUTCMinutes()	Устанавливает минуты для указанной даты по всемирному времени.
setUTCMonth()	Задает месяц для указанной даты по всемирному времени.
setUTCSeconds()	Устанавливает секунды для указанной даты по всемирному времени.
toDateString()
toISOString()	Преобразует дату в строку, используя стандарт ISO 8601.
toJSON()	Возвращает дату в виде строки, отформатированную как дата JSON.
toLocaleDateString()
toLocaleTimeString()	Возвращает часть даты в виде строки, с представлением даты на основе параметров системы.
toLocaleString()	Возвращает дату в виде строки, с представлением даты на основе параметров системы.
toString()	Возвращает строку, представляющую указанный объект Date.
toTimeString()	Возвращает часть даты в виде строки.
toUTCString()	Преобразует дату в строку, используя часовой пояс UTC.
UTC()	Принимает те же параметры, что и длинная форма конструктора (т.е. 2-7) и возвращает количество миллисекунд с 1 января 1970, 00:00:00 UTC.
valueOf()	Возвращает примитивное значение объекта Date.

Используйте new Date() для создания нового объекта Date содержащего текущую дату и время.

Обратите внимание, что Date() вызываемая без аргументов, эквивалентна new Date(Date.now()) .

Когда у вас есть объект даты, вы можете применить любой из нескольких доступных методов для извлечения его свойств (например, getFullYear() чтобы получить 4-значный год).

Ниже приведены некоторые общие методы даты.

Получить текущий год var year = (new Date()).getFullYear(); console.log(year); // Sample output: 2016 Получить текущий месяц var month = (new Date()).getMonth(); console.log(month); // Sample output: 0

Обратите внимание, что 0 = январь. Это потому, что месяцы варьируются от 0 до 11 , поэтому часто желательно добавить +1 к индексу.

Получить текущий день var day = (new Date()).getDate(); console.log(day); // Sample output: 31 Получить текущий час var hours = (new Date()).getHours(); console.log(hours); // Sample output: 10 Получить текущие минуты var minutes = (new Date()).getMinutes(); console.log(minutes); // Sample output: 39 Получить текущие секунды var seconds = (new Date()).getSeconds(); console.log(second); // Sample output: 48 Получить текущие миллисекунды

Чтобы получить миллисекунды (от 0 до 999) экземпляра объекта Date , используйте метод getMilliseconds .

Var milliseconds = (new Date()).getMilliseconds(); console.log(milliseconds); // Output: milliseconds right now

Преобразование текущего времени и даты в удобочитаемую строку var now = new Date(); // convert date to a string in UTC timezone format: console.log(now.toUTCString()); // Output: Wed, 21 Jun 2017 09:13:01 GMT

Статический метод Date.now() возвращает количество миллисекунд, прошедших с 1 января 1970 года 00:00:00 по UTC. Чтобы получить количество миллисекунд, прошедших с того времени, используя экземпляр объекта Date , используйте его метод getTime .

// get milliseconds using static method now of Date console.log(Date.now()); // get milliseconds using method getTime of Date instance console.log((new Date()).getTime());

Дата и время являются частью нашей повседневной жизни и поэтому занимают видное место в программировании. В JavaScript при создании веб-сайта может потребоваться добавить календарь, расписание поездов или интерфейс для планирования встреч. Эти приложения должны показывать соответствующие моменты времени в зависимости от текущего часового пояса пользователя или выполнять вычисления, связанные с прибытием и вылетом самолета или временем начала и окончания какого-либо события. Кроме того, вам может потребоваться использовать JavaScript для отправки ежедневных отчетов в определенное время или для фильтрации (например, для поиска открытых в определенное время ресторанов).

Объект Date

Date – это встроенный объект JavaScript, который хранит дату и время. Он предоставляет ряд встроенных методов для форматирования и управления этими данными.

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

Для примера попробуйте присвоить переменной текущую дату. Создайте файл now.js.

// Set variable to current date and time
const now = new Date();
// View the output
now;
Wed Oct 18 2017 12:41:34 GMT+0000 (UTC)

В выводе получается строка с датой, которая содержит следующие данные:

Дата и время разбиваются и отображаются удобным для восприятия образом.

Однако JavaScript воспринимает дату, исходя из временной метки Unix-времени, которая представляет собой значение, состоящее из количества миллисекунд, прошедших с полуночи 1 января 1970 года. Получить метку времени можно с помощью метода getTime().

// Get the current timestamp
now.getTime();
1508330494000

Большое число, которое появляется в выводе в качестве текущей временной метки, представляет собой количество миллисекунд, прошедших с полуночи 1 января 1970 года на 18 октября 2017 года.

Нулевое время (или epoch time) представлено строкой даты 01 January, 1970 00:00:00 Universal Time (UTC) и временной меткой 0. Вы можете проверить это в браузере, создав в файле epoch.js новую переменную и присвоив ей новый экземпляр Date, основанный на отметке времени 0.

// Assign the timestamp 0 to a new variable
const epochTime = new Date(0);
epochTime;
01 January, 1970 00:00:00 Universal Time (UTC)

Нулевое время было выбрано в качестве стандарта для измерения времени компьютерами, и этот метод используется в JavaScript. Важно понимать временные метки и строки дат, поскольку эти понятия могут использоваться в зависимости от настроек и цели приложения.

Теперь вы знаете, как создать новый экземпляр Date на основе текущего времени и на основе временной метки. В общей сложности существует четыре формата Date в JavaScript. Кроме текущего времени по умолчанию и временной метки также можно использовать строку даты или указать конкретную дату и время.

Чтобы продемонстрировать различные способы ссылок на конкретную дату, попробуйте создать новые объекты Date, которые будут представлять 4 июля 1776 года, 12:30 по Гринвичу тремя различными способами.

// Timestamp method
new Date(-6106015800000);
// Date string method
new Date("January 31 1980 12:30");
// Date and time method
new Date(1776, 6, 4, 12, 30, 0, 0);

Все эти примеры представляют одну и ту же информацию о дате и времени тремя разными способами.

Как видите, метод временной метки имеет отрицательное число; любая дата до нулевого времени будет представлена как отрицательное число.

В третьем примере секунды и миллисекунды представлены 0. Если при создании объекта Date вам не хватает каких-либо данных, вы должны присвоить им 0. Отсутствующие данные нельзя пропускать, поскольку порядок данных о времени в строке не меняется. Также следует отметить, что месяц июль здесь обозначен как 6, а не как 7. Это происходит потому, что отсчет начинается не с 1, а с 0. Подробнее об этом – в следующем разделе.

Извлечение даты с помощью get

Имея дату, вы можете получить доступ ко всем ее компонентам с помощью различных встроенных методов. Методы возвращают каждую часть даты относительно локального часового пояса. Каждый из этих методов начинается с get и возвращает относительное число. Ниже приведена подробная таблица методов get для объекта Date.

Дата/Время	Метод	Диапазон	Пример
Год	getFullYear()	YYYY	1970
Месяц	getMonth()	0-11	0 = January
День месяца	getDate()	1-31	1 = 1st of the month
День недели	getDay()	0-6	0 = Sunday
Час	getHours()	0-23	0 = midnight
Минута	getMinutes()	0-59
Секунда	getSeconds()	0-59
Миллисекунда	getMilliseconds()	0-999
Временная метка	getTime()

// Initialize a new birthday instance
const birthday = new Date(1980, 6, 31);

Теперь можно использовать все методы для извлечения каждого компонента даты.

birthday.getFullYear(); // 1980
birthday.getMonth(); // 6
birthday.getDate(); // 31
birthday.getDay(); // 4
birthday.getHours(); // 0
birthday.getMinutes(); // 0
birthday.getSeconds(); // 0
birthday.getMilliseconds(); // 0
birthday.getTime(); // 333849600000 (for GMT)

Иногда бывает необходимо извлечь только часть даты, и встроенные методы get помогут вам в этом.

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

// Get today"s date
const today = new Date();
// Compare today with October 3rd
if (today.getDate() === 3 && today.getMonth() === 9) {
console.log("It"s October 3rd.");
} else {
console.log("It"s not October 3rd.");
}
It"s not October 3rd.

Встроенные методы get позволяют получать доступ к компонентам даты.

Изменение даты с помощью set

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

Дата/Время	Метод	Диапазон	Пример
Год	setFullYear()	YYYY	1970
Месяц	setMonth()	0-11	0 = January
День месяца	setDate()	1-31	1 = 1st of the month
День недели	setDay()	0-6	0 = Sunday
Час	setHours()	0-23	0 = midnight
Минута	setMinutes()	0-59
Секунда	setSeconds()	0-59
Миллисекунда	setMilliseconds()	0-999
Временная метка	setTime()	Количество миллисекунд с нулевого времени

Эти методы set можно использовать для изменения одного или нескольких компонентов даты. Например, можно изменить год в переменной birthday на 1997.

// Change year of birthday date
birthday.setFullYear(1997);
birthday;
Thu Jul 31 1997 00:00:00 GMT+0000 (UTC)

Теперь при вызове переменной birthday вы видите не 1980, а 1997 год.

Встроенные методы set позволяют изменять разные части объекта Date.

Методы UTC

Методы get, описанные выше, извлекают компоненты даты на основе локальных настроек часового пояса пользователя. Чтобы увеличить контроль над датами и временем, вы можете использовать методы getUTC, которые работают так же, как методы get, но вычисляют время, основанное на стандарте UTC (всемирное координированное время). Ниже приведена таблица методов UTC для объекта Date в JavaScript.

Дата/Время	Метод	Диапазон	Пример
Год	getUTCFullYear()	YYYY	1970
Месяц	getUTCMonth()	0-11	0 = January
День месяца	getUTCDate()	1-31	1 = 1st of the month
День недели	getUTCDay()	0-6	0 = Sunday
Час	getUTCHours()	0-23	0 = midnight
Минута	getUTCMinutes()	0-59
Секунда	getUTCSeconds()	0-59
Миллисекунда	getUTCMilliseconds()	0-999

Чтобы проверить разницу между локальными методами get и методами get UTC, запустите следующий код.

// Assign current time to a variable
const now = new Date();
// Print local and UTC timezones
console.log(now.getHours());
console.log(now.getUTCHours());

Этот код выведет текущее время и время по часовому поясу UTC. Если вы сейчас находитесь в часовом поясе UTC, то числа, которые выведет программа, будут одинаковыми.

UTC предоставляет международный стандарт времени и поэтому может поддерживать код в соответствии с часовыми поясами, если это необходимо в вашей программе.

Заключение

В этом мануале вы узнали, как создать экземпляр объекта Date, как использовать его встроенные методы для доступа и изменения компонентов определенной даты. Более подробную информацию о времени и дате в JavaScript вы можете найти на Mozilla Developer Network .

Умение работать с датами важно для многих общих задач в JavaScript: от создания регулярных отчетов до отображения дат и расписаний в правильном часовом поясе.

Tags:

Еще одна полезная для сайтов вещь - вставка текущей даты. Примеров скриптов даты можно найти в интернете десятки, однако многие из них, на мой взгляд, тяжеловесны и, следовательно, некрасивы. Между тем, используя стандартные средства JavaScript , вставить дату на страницу сайта можно очень просто. Я его очень часто применяю! На картинке (скриншот с действующего сайта) усадьбы «Сказка» !

Вот весь скрипт даты:

По-моему, проще некуда, достаточно красиво и понятно. Если у вас нет никакого желания изучать построение этого скрипта, то просто вставляйте его в любое место HTML-страницы и получите следующую надпись:

Еще один вариант более расширенный

//
// ]]>
// ]]>
// ]]>
// ]]>
// ]]>
! Сегодня
// + " " + d.getFullYear() + " г.");
// ]]>
// ]]>
// ]]>
// ]]>
// ]]>
// ]]>

Выглядит он так:

Сегодня

Вобщем не требуется никаких навыков, просто тупо вставляем код и все ок!

Подробнее:

Итак, начинаем с присвоения значения даты переменной d , затем создаём массивы (Array ) для дней недели (day ) и месяцев (month ), указывая их в необходимой грамматической форме: падеж, число, заглавная буква, если слово стоит в начале даты и т.п. Последняя строчка скрипта - собственно печать даты (document.write ). Здесь вы устанавливаете, что и в какой последовательности будете выводить в строке текущей даты. Компоненты отделяются друг от друга знаком + . Для ввода пробела используется конструкция " " , а для ввода буквы г (год) - конструкция " г."

Как видно из скрипта, получение данных о текущем времени выполняет элемент get . Этот метод позволяет получить следующую информацию:

• getDate() - возвращает число от 1 до 31, представляющее число месяца;
• getDay() - возвращает день недели как целое число от 0 (воскресенье) до 6 (суббота);
• getMonth() - возвращает номер месяца в году;
• getFullYear() - возвращает год. Если использовать просто getYear() , то будет выводиться текущий год минус 1900;
• get Hours() - возвращает час суток;
• getMinutes() - возвращает минуты как число от 0 до 59;
• getSeconds() - возвращает число секунд от 0 до 59.

Вставлять непосредственно Java -скрипт внутрь страницы сайта не всегда удобно. Лучше поместить описание скрипта в начало страницы между тегами и задать переменную, которую будем вызывать по мере необходимости в тексте. Назовём её TODAY и определим в ней форму вывода даты аналогично вышеизложенному. Скрипт будет выглядеть следующим образом:

Для вывода даты вызываем скрипт в нужном месте HTML-кода страницы, используя следующую команду:

document.write(TODAY);

Если ваш сайт содержит много страниц, на которых надо показывать дату, то удобнее выделить Java -скрипт вывода даты в отдельный файл, например, data.js . Практически, это страница, состоящая из первого из описанных скриптов, то есть со строкой document.write (см. выше). Располагать её надо в том же каталоге, что и основная страница, и вызывать в месте вывода даты следующим образом:

Не забудьте проверить, чтобы файл data.js имел ту же кодировку, что и основной документ, иначе дата будет выводиться замечательными крючками, квадратиками и прочими финтифлюшками.

Замечание. Следует иметь ввиду, что описанный скрипт выводит дату, установленную на компьютере пользователя, что не всегда соответствует реальному текущему времени. Если вам необходимо показать точное время, то необходимо использовать РНР-скрипт, который будет показывать время на сервере.