getMinutes() возвращает минуты из объекта Date.
Если говорить просто, этот метод достаёт минуты из даты и времени, например 0, 15, 30 или 59.
Синтаксис
Базовая запись выглядит так:
date.getMinutes()
Где:
date- это объектDate
Аргументы этому методу не нужны.
Что возвращает getMinutes()
Метод возвращает число от 0 до 59.
const date = new Date(2025, 0, 15, 14, 30, 45);
console.log(date.getMinutes()); // 30
console.log(typeof date.getMinutes()); // "number"
Это важно:
0- начало часа30- середина часа59- последняя минута перед следующим часом
Простой пример
const date = new Date(2025, 0, 15, 14, 30, 45);
console.log(date.getMinutes()); // 30
Здесь:
2025- год0- январь15- день месяца14- часы30- минуты
Метод возвращает 30, потому что это минуты в указанной дате.
Пример с началом и концом часа
const start = new Date(2025, 0, 15, 14, 0, 0);
const end = new Date(2025, 0, 15, 14, 59, 59);
console.log(start.getMinutes()); // 0
console.log(end.getMinutes()); // 59
Так хорошо видно, что диапазон значений идёт от 0 до 59.
getMinutes() не возвращает часы
Это одна из самых частых ошибок.
getMinutes() отвечает только за минуты. Часы он не возвращает.
const date = new Date(2025, 0, 15, 14, 30, 45);
console.log(date.getMinutes()); // 30
Чем getMinutes() отличается от getHours()
Эти методы легко перепутать.
getMinutes()возвращает минутыgetHours()возвращает часы
const date = new Date(2025, 0, 15, 14, 30, 45);
console.log(date.getMinutes()); // 30
console.log(date.getHours()); // 14
getMinutes() не меняет дату
Метод только читает значение минут.
Он не изменяет исходный объект Date.
const date = new Date(2025, 0, 15, 14, 30, 45);
const minutes = date.getMinutes();
console.log(minutes); // 30
console.log(date); // исходная дата остаётся той же
getMinutes() работает по локальному времени
Это важный момент.
Метод getMinutes() смотрит на дату с точки зрения локального часового пояса пользователя.
Если вам нужны минуты именно по UTC, используют getUTCMinutes().
Чем getMinutes() отличается от getUTCMinutes()
Разница такая:
getMinutes()возвращает минуты по локальному времениgetUTCMinutes()возвращает минуты поUTC
Иногда результат будет совпадать, а иногда может отличаться из-за часового пояса.
const date = new Date(Date.UTC(2025, 0, 15, 14, 30, 0));
console.log(date.getUTCMinutes()); // 30
Если вы работаете с UTC, серверным временем и ISO-строками, этот нюанс важно учитывать.
Когда это полезно
getMinutes() особенно удобен, когда:
- нужно получить минуты из даты
- вы выводите время в интерфейсе
- проверяете, попало ли время в нужный промежуток
- собираете строку вроде
14:30
Пример:
const date = new Date();
if (date.getMinutes() === 0) {
console.log("Начался новый час");
}
Пример для вывода времени
Метод часто используют вместе с getHours().
const date = new Date(2025, 0, 15, 9, 5, 0);
console.log(date.getHours(), date.getMinutes()); // 9 5
Если нужен красивый формат вроде 09:05, минуты обычно дополнительно дополняют нулём.
Невалидная дата даёт NaN
Если объект Date содержит некорректную дату, результатом будет NaN.
const date = new Date("invalid");
console.log(date.getMinutes()); // NaN
Это полезно помнить, если дата приходит из формы, API или пользовательского ввода.
getMinutes() не создаёт дату и не форматирует строку
Этот метод не создаёт новую дату и не превращает её в текст.
Он только возвращает число минут.
const date = new Date(2025, 0, 15, 14, 30, 45);
console.log(date.getMinutes()); // 30
Если нужен красивый вывод времени, его придётся формировать отдельно.
Частые ошибки
Путать getMinutes() и getHours()
const date = new Date(2025, 0, 15, 14, 30, 45);
console.log(date.getMinutes()); // 30
console.log(date.getHours()); // 14
Это два разных метода.
Ожидать диапазон не от 0 до 59
const date = new Date(2025, 0, 15, 14, 0, 0);
console.log(date.getMinutes()); // 0
В JavaScript минуты идут от 0 до 59.
Вызывать getMinutes() не у объекта Date
Правильно:
const date = new Date();
console.log(date.getMinutes());
Неправильно:
Date.getMinutes();
Метод getMinutes() работает у экземпляра Date, а не у самого объекта Date.
Забывать про локальное время
getMinutes() использует локальный часовой пояс пользователя.
Если важен именно UTC, лучше смотреть в сторону getUTCMinutes().
Не учитывать NaN у невалидной даты
const date = new Date("invalid");
console.log(date.getMinutes()); // NaN
Если дата может быть некорректной, полезно сначала проверить сам объект даты.
Быстрая памятка
getMinutes()вызывается у объектаDate- метод возвращает минуты числом
- диапазон значений: от
0до59 0- это начало часаgetMinutes()не возвращает часы- для часов есть
getHours() getMinutes()работает по локальному времени- для
UTCестьgetUTCMinutes() - у невалидной даты результатом будет
NaN
Коротко
getMinutes() в JavaScript нужен, чтобы получить минуты из объекта Date. Главное, что стоит запомнить: метод возвращает число от 0 до 59, работает по локальному времени, не изменяет саму дату и его очень важно не путать с getHours(), который отвечает уже за часы.