GetMinutes: примеры (JAVASCRIPT)

Простые примеры использования

Получение минут из текущего времени.

const now = new Date();
const minutes = now.getMinutes();
console.log(minutes);

// Результат зависит от текущего времени, например: 30

Получение минут из конкретной даты.

const specificDate = new Date('2023-12-15T14:45:00');
console.log(specificDate.getMinutes());

45

Похожие методы в JavaScript

• getUTCMinutes() Возвращает минуты по всемирному координированному времени (UTC).
• getHours() и getSeconds() Получают часы и секунды соответственно, часто используются вместе с getMinutes() для полного представления времени.
• toLocaleTimeString() Возвращает строку с временем, отформатированную согласно локали. Удобен для конечного отображения, но не для получения отдельных числовых компонентов.

Метод getMinutes() предпочтителен, когда нужны именно минуты как число для вычислений. Для интернационализации лучше рассмотреть toLocaleTimeString().

Типичные ошибки

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

const date = new Date('2023-01-01T03:05:00');
console.log('Минуты: ' + date.getMinutes()); // Выведет 'Минуты: 5', а не 'Минуты: 05'

Минуты: 5

Работа с некорректными датами.

const invalidDate = new Date('invalid-string');
console.log(invalidDate.getMinutes());

NaN

Игнорирование часового пояса. Метод getMinutes() работает с местным временем, что может привести к путанице при работе с датами, созданными в UTC.

История изменений

Спецификация метода getMinutes() была стандартизирована в ECMAScript 1 (ES1) и с тех пор его базовое поведение не менялось. Основные изменения в работе с датами в JavaScript связаны с введением Temporal (на стадии предложения), который должен заменить устаревший API Date, включая методы для получения компонентов времени.

Расширенные примеры

Форматирование времени с добавлением ведущего нуля.

function getMinutesWithZero(date) {
    const minutes = date.getMinutes();
    return minutes < 10 ? '0' + minutes : minutes.toString();
}
const now = new Date();
console.log(`${now.getHours()}:${getMinutesWithZero(now)}`);

14:05

Вычисление разницы в минутах между двумя датами.

const start = new Date('2023-12-15T14:30:00');
const end = new Date('2023-12-15T15:15:00');
const diffInMs = end - start;
const diffInMinutes = Math.floor(diffInMs / (1000 * 60));
console.log(diffInMinutes);

45

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

function checkIfTime(minuteTarget) {
    const currentMinute = new Date().getMinutes();
    return currentMinute === minuteTarget;
}
// Проверка, наступила ли 30-я минута часа
console.log(checkIfTime(30));

true или false

Использование с getUTCMinutes() для сравнения.

const date = new Date();
console.log(`Локальные минуты: ${date.getMinutes()}, UTC минуты: ${date.getUTCMinutes()}`);

Локальные минуты: 30, UTC минуты: 27 (пример при смещении +3)

Аналоги в других языках программирования

Python: Используют атрибут minute объекта datetime.

from datetime import datetime
now = datetime.now()
print(now.minute)

30

PHP: Функция date() с форматом 'i'.

echo date('i'); // или
$date = new DateTime();
echo $date->format('i');

30

MySQL: Функция MINUTE().

SELECT MINUTE('2023-12-15 14:45:00');

45

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