JavaScript Date Reference: что это, как и зачем используется

Объект Date в JavaScript предоставляет мощные возможности для работы с датой и временем. С его помощью можно легко создавать даты, извлекать их компоненты, такие как год, месяц, день и т.д., устанавливать нужные значения этих компонентов, вычислять разницу между датами в миллисекундах и многое другое. Очень удобной особенностью является автоматическая коррекция дат при установке неправильных значений компонентов, например 32 января автоматически станет 1 февраля. Также имеются методы для отображения даты в нужном формате в зависимости от локали. В целом, объект Date - это мощный и гибкий инструмент для любых задач, связанных с датами и временем в JavaScript.

Работа с текущей датой

Часто в приложениях требуется получить текущую дату и время. Для этого достаточно создать объект Date без аргументов:

let now = new Date();

Переменная now будет содержать объект с текущими датой и временем. Затем из него можно получить любые необходимые компоненты, например:

let day = now.getDate();

Также текущую метку времени в миллисекундах можно получить с помощью статического метода Date.now():

let milliseconds = Date.now();

Сравнение дат

Объекты Date в JavaScript можно сравнивать друг с другом с помощью стандартных операций сравнения, таких как >, <, == и т.д. Сравнение происходит по временной метке даты.

Например:

let date1 = new Date(2020, 0, 1); let date2 = new Date(2020, 0, 2); if (date1 < date2) { alert('Date1 меньше Date2'); }

Это позволяет легко сравнивать даты в нужных целях.

Преобразование в строку

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

let date = new Date(2020, 0, 1); alert(date.toString()); // Wed Jan 01 2020 00:00:00 GMT+0300 (Москва, стандартное время)

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

Изменение даты

Объект Date можно изменить, установив значения его компонентов с помощью соответствующих методов setFullYear, setMonth и т.д. Например:

let date = new Date(); // установить 1 января 2023 года date.setFullYear(2023); date.setMonth(0); date.setDate(1);

Дата будет автоматически скорректирована. Это удобный способ сдвинуть дату на определенный период или установить фиксированную дату для вычислений.

Форматы строки даты

При создании объекта Date из строки, она должна быть в определенном формате, который поймет Date.parse(). Например, ISO 8601:

let date = new Date('2020-01-01T00:00:00.000Z');

Поддерживаются и более короткие форматы, такие как '2020-01-01'. Но в любом случае, формат должен быть распознаваемым, иначе будет ошибка.

Установка времени

Помимо даты, в объекте Date также хранится время. Его компоненты: часы, минуты, секунды и миллисекунды можно получить с помощью методов getHours(), getMinutes() и т.д. А для установки используются методы:

date.setHours(hour); date.setMinutes(min); date.setSeconds(sec); date.setMilliseconds(ms);

Например, чтобы установить время на 00:00:00 (полночь):

let date = new Date(); date.setHours(0); date.setMinutes(0); date.setSeconds(0); date.setMilliseconds(0);

Преобразование даты в число

Объект Date можно преобразовать в число, получив количество миллисекунд от начала эпохи Unix (1 января 1970 года UTC).

Это делается автоматически:

let date = new Date(); let numeric = +date; // преобразование в число

Альтернативный способ - date.getTime(). Это часто используется для сравнения дат или вычисления разницы:

let diff = new Date() - new Date(2020, 0, 1); // разница в миллисекундах

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

Объект Date может отображаться в разных форматах. По умолчанию используется простая текстовая форма типа "Tue Feb 28 2023 00:00:00 GMT+0300". Но часто требуется более удобочитаемый формат.

Для этого есть метод date.toLocaleString(), который форматирует дату в соответствии с локалью. Например:

let date = new Date(2023, 1, 1); // 1.2.2023 (для русской локали) alert( date.toLocaleString("ru-RU") ); // 2/1/2023 (для английской локали США) alert( date.toLocaleString("en-US") );

Разбор строки в дату

Чтобы разобрать строку в объект Date, используется статический метод Date.parse(). Он принимает на вход строку в определенном формате и возвращает timestamp - количество миллисекунд от начала эпохи Unix.

Например:

let ms = Date.parse("2020-01-01"); // количество миллисекунд для 1 января 2020 года let date = new Date(ms); // создаем объект Date

Поддерживаемые форматы включают ISO 8601 и RFC 2822.

Валидация даты

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

function isValidDate(date) { return date instanceof Date && !isNaN(date); } // или function isValidDate(date) { return !isNaN(new Date(date).getTime()); }

Это проверит, что переменная date является объектом Date и при преобразовании в число не дает NaN.

Работа с часовыми поясами

Объект Date хранит дату и время в UTC. Но при выводе учитывает текущий часовой пояс. Это нужно иметь в виду при вычислениях.

Методы getTimezoneOffset() и getUTCHours() позволяют учесть смещение.

Таймеры на основе даты

Объект Date можно использовать для создания таймеров и периодических задач. Например, выполнить код каждую секунду:

let prev = Date.now(); setInterval(() => { let now = Date.now(); if (now - prev >= 1000) { console.log("Прошла 1 секунда"); prev = now; } }, 100);

Здесь мы сохраняем предыдущее время, и при каждом интервале проверяем, прошло ли 1000 мс от последнего вызова. Если прошло - выполняем действие.

Измерение производительности

Объект Date также удобен для измерения времени выполнения кода.

Например, чтобы узнать, как быстро работает функция, можно сделать так:

let start = Date.now(); // вызов функции myFunction(); let end = Date.now(); alert( Функция отработала за ${end - start} мс );

Это лучше, чем использовать console.time/timeEnd, т.к. date.now() вызывается быстрее.

Сортировка по дате

Объекты Date можно сортировать, так как они преобразуются в числа - timestamp. Например, имея массив объектов со свойством date:

let arr = [ { date: new Date(2020, 0, 2) }, { date: new Date(2020, 0, 1) } ];

Можно отсортировать по возрастанию даты:

arr.sort((a, b) => a.date - b.date);

Это быстрый и удобный способ сортировки по датам.

Ограничения Date

Объект Date в JavaScript не лишен недостатков. В частности, он не позволяет устанавливать даты до 1 января 1970 года из-за ограничений формата timestamp. Кроме того, форматирование дат не очень гибкое.

Поэтому в сложных задачах имеет смысл использовать библиотеки, такие как Moment.js, которые расширяют возможности Date.

Лилия Шевчук 25 октября, 2023