Learn JavaScript

getMinutes() - получение минут из даты в JavaScript

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(), который отвечает уже за часы.