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()возвращает минуты поUTCgetUTCHours()возвращает часы по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()возвращает минуты поUTCgetMinutes()возвращает минуты по локальному времени
Иногда результат будет совпадать, а иногда может отличаться из-за часового пояса.
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(), который отвечает уже за часы.