Learn JavaScript

getUTCMinutes() - получение минут по UTC в JavaScript

getUTCMinutes() возвращает минуты из объекта Date по UTC.

Если говорить просто, этот метод достаёт минуты из даты и времени, например 0, 15, 30 или 59, но делает это не по локальному времени пользователя, а по всемирному времени UTC.

Синтаксис

Базовая запись выглядит так:

date.getUTCMinutes()

Где:

  • date - это объект Date

Аргументы этому методу не нужны.

Что возвращает getUTCMinutes()

Метод возвращает число от 0 до 59.

const date = new Date(Date.UTC(2025, 0, 15, 14, 30, 45));

console.log(date.getUTCMinutes()); // 30
console.log(typeof date.getUTCMinutes()); // "number"

Это важно:

  • 0 - начало часа
  • 30 - середина часа
  • 59 - последняя минута перед следующим часом

Простой пример

const date = new Date(Date.UTC(2025, 0, 15, 14, 30, 45));

console.log(date.getUTCMinutes()); // 30

Здесь:

  • 2025 - год
  • 0 - январь
  • 15 - день месяца
  • 14 - часы
  • 30 - минуты

Метод возвращает 30, потому что это минуты в указанной дате по UTC.

Пример с началом и концом часа

const start = new Date(Date.UTC(2025, 0, 15, 14, 0, 0));
const end = new Date(Date.UTC(2025, 0, 15, 14, 59, 59));

console.log(start.getUTCMinutes()); // 0
console.log(end.getUTCMinutes()); // 59

Так хорошо видно, что диапазон значений идёт от 0 до 59.

getUTCMinutes() не возвращает часы

Это одна из самых частых ошибок.

getUTCMinutes() отвечает только за минуты. Часы он не возвращает.

const date = new Date(Date.UTC(2025, 0, 15, 14, 30, 45));

console.log(date.getUTCMinutes()); // 30

Чем getUTCMinutes() отличается от getUTCHours()

Эти методы легко перепутать.

  • getUTCMinutes() возвращает минуты по UTC
  • getUTCHours() возвращает часы по UTC
const date = new Date(Date.UTC(2025, 0, 15, 14, 30, 45));

console.log(date.getUTCMinutes()); // 30
console.log(date.getUTCHours()); // 14

getUTCMinutes() не меняет дату

Метод только читает значение минут.

Он не изменяет исходный объект Date.

const date = new Date(Date.UTC(2025, 0, 15, 14, 30, 45));
const minutes = date.getUTCMinutes();

console.log(minutes); // 30
console.log(date); // исходная дата остаётся той же

getUTCMinutes() работает именно по UTC

Это главный момент.

Метод getUTCMinutes() всегда смотрит на дату с точки зрения UTC.

Если вам нужны минуты по локальному времени пользователя, используют getMinutes().

Чем getUTCMinutes() отличается от getMinutes()

Разница такая:

  • getUTCMinutes() возвращает минуты по UTC
  • getMinutes() возвращает минуты по локальному времени

Иногда результат будет совпадать, а иногда может отличаться из-за часового пояса.

const date = new Date("2025-01-15T14:30:00+03:30");

console.log(date.toISOString()); // 2025-01-15T11:00:00.000Z
console.log(date.getUTCMinutes()); // 0

В этом примере по локальному времени в строке минут 30, а по UTC уже 0.

Если вы работаете с UTC, серверным временем и ISO-строками, этот нюанс важно учитывать.

Когда это полезно

getUTCMinutes() особенно удобен, когда:

  • дата хранится в UTC
  • вы работаете с серверным временем
  • нужно одинаковое поведение независимо от часового пояса пользователя
  • вы формируете время, логи или отчёты по UTC

Пример:

const date = new Date("2025-01-15T14:00:00Z");

if (date.getUTCMinutes() === 0) {
  console.log("По UTC начался новый час");
}

Пример для вывода времени по UTC

Метод часто используют вместе с getUTCHours().

const date = new Date(Date.UTC(2025, 0, 15, 9, 5, 0));

console.log(date.getUTCHours(), date.getUTCMinutes()); // 9 5

Если нужен красивый формат вроде 09:05, минуты обычно дополнительно дополняют нулём.

Невалидная дата даёт NaN

Если объект Date содержит некорректную дату, результатом будет NaN.

const date = new Date("invalid");

console.log(date.getUTCMinutes()); // NaN

Это полезно помнить, если дата приходит из формы, API или пользовательского ввода.

getUTCMinutes() не создаёт дату и не форматирует строку

Этот метод не создаёт новую дату и не превращает её в текст.

Он только возвращает число минут по UTC.

const date = new Date(Date.UTC(2025, 0, 15, 14, 30, 45));

console.log(date.getUTCMinutes()); // 30

Если нужен красивый вывод времени, его придётся формировать отдельно.

Частые ошибки

Путать getUTCMinutes() и getUTCHours()

const date = new Date(Date.UTC(2025, 0, 15, 14, 30, 45));

console.log(date.getUTCMinutes()); // 30
console.log(date.getUTCHours()); // 14

Это два разных метода.

Ожидать диапазон не от 0 до 59

const date = new Date(Date.UTC(2025, 0, 15, 14, 0, 0));

console.log(date.getUTCMinutes()); // 0

В JavaScript минуты идут от 0 до 59.

Путать getUTCMinutes() и getMinutes()

const date = new Date("2025-01-15T14:30:00+03:30");

console.log(date.getUTCMinutes()); // 0

Если нужен именно UTC, используйте getUTCMinutes(), а не getMinutes().

Вызывать getUTCMinutes() не у объекта Date

Правильно:

const date = new Date();

console.log(date.getUTCMinutes());

Неправильно:

Date.getUTCMinutes();

Метод getUTCMinutes() работает у экземпляра Date, а не у самого объекта Date.

Ожидать локальное время вместо UTC

getUTCMinutes() специально работает по UTC, а не по часовому поясу пользователя.

Если нужны минуты по локальному времени, лучше использовать getMinutes().

Не учитывать NaN у невалидной даты

const date = new Date("invalid");

console.log(date.getUTCMinutes()); // NaN

Если дата может быть некорректной, полезно сначала проверить сам объект даты.

Быстрая памятка

  • getUTCMinutes() вызывается у объекта Date
  • метод возвращает минуты числом
  • диапазон значений: от 0 до 59
  • 0 - это начало часа
  • getUTCMinutes() не возвращает часы
  • для часов есть getUTCHours()
  • getUTCMinutes() работает по UTC
  • для локального времени есть getMinutes()
  • у невалидной даты результатом будет NaN

Коротко

getUTCMinutes() в JavaScript нужен, чтобы получить минуты из объекта Date по всемирному времени UTC. Главное, что стоит запомнить: метод возвращает число от 0 до 59, не зависит от локального часового пояса пользователя, не изменяет саму дату и его очень важно не путать с getUTCHours(), который отвечает уже за часы.