Learn JavaScript
Справочник / setUTCMinutes()

setUTCMinutes() - изменение минут по UTC в JavaScript

setUTCMinutes() изменяет минуты в объекте Date по UTC, меняет существующую дату. При необходимости этот метод может сразу обновить не только минуты, но и секунды с миллисекундами.

Синтаксис

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

date.setUTCMinutes(minutesValue)
date.setUTCMinutes(minutesValue, secondsValue)
date.setUTCMinutes(minutesValue, secondsValue, msValue)

Где:

  • date - это объект Date
  • minutesValue - новые минуты по UTC
  • secondsValue - необязательные секунды
  • msValue - необязательные миллисекунды

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

Метод возвращает timestamp - количество миллисекунд с 1 января 1970 года.

const date = new Date(Date.UTC(2025, 0, 15, 10, 20, 30, 400));
const result = date.setUTCMinutes(45);

console.log(typeof result); // "number"
console.log(result === date.getTime()); // true
console.log(date.toISOString()); // "2025-01-15T10:45:30.400Z"

Это важно: setUTCMinutes() возвращает число, а не новый объект Date.

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

const date = new Date(Date.UTC(2025, 0, 15, 10, 20, 30));

date.setUTCMinutes(45);

console.log(date.getUTCMinutes()); // 45
console.log(date.toISOString()); // "2025-01-15T10:45:30.000Z"

Здесь:

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

После вызова метода минуты по UTC становятся 45.

Обычно используют значения от 0 до 59

В большинстве случаев в setUTCMinutes() передают обычные минуты внутри часа:

  • 0 - начало часа
  • 30 - середина часа
  • 59 - последняя минута перед следующим часом
const date = new Date(Date.UTC(2025, 0, 15, 10, 20, 30));

date.setUTCMinutes(0);

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

Но у setUTCMinutes() есть полезная особенность: он умеет работать и со значениями вне этого диапазона.

Можно сразу изменить минуты, секунды и миллисекунды

У setUTCMinutes() есть дополнительные аргументы.

С их помощью можно за один вызов изменить сразу несколько частей времени по UTC.

const date = new Date(Date.UTC(2025, 0, 15, 10, 20, 30, 400));

date.setUTCMinutes(45, 50, 900);

console.log(date.getUTCMinutes()); // 45
console.log(date.getUTCSeconds()); // 50
console.log(date.getUTCMilliseconds()); // 900
console.log(date.toISOString()); // "2025-01-15T10:45:50.900Z"

Если дополнительные аргументы не передавать, текущие секунды и миллисекунды сохраняются.

setUTCMinutes() меняет исходную дату

Это главное отличие от методов вроде getUTCMinutes().

setUTCMinutes() не просто читает значение, а изменяет сам объект Date.

const date = new Date(Date.UTC(2025, 0, 15, 10, 20, 30));

date.setUTCMinutes(45);

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

Если объект даты используется в нескольких местах, это поведение важно учитывать.

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

Эти методы связаны, но делают разное.

  • getUTCMinutes() читает минуты по UTC
  • setUTCMinutes() изменяет минуты по UTC
const date = new Date(Date.UTC(2025, 0, 15, 10, 20, 30));

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

date.setUTCMinutes(45);

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

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

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

Метод setUTCMinutes() изменяет дату с точки зрения UTC, а не локального часового пояса пользователя.

Если вы работаете с серверным временем, ISO-строками и данными из API, это поведение обычно удобнее и предсказуемее.

Чем setUTCMinutes() отличается от setMinutes()

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

  • setUTCMinutes() изменяет минуты по UTC
  • setMinutes() изменяет минуты по локальному времени

Во многих случаях результат может совпасть, но это всё равно разные системы времени.

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

date.setUTCMinutes(15);

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

У setMinutes() похожий вызов менял бы именно локальные минуты, а не минуты по UTC.

Минуты могут выходить за пределы 0..59

Это одна из полезных особенностей Date.

Если передать значение больше 59, JavaScript автоматически перенесёт время на следующий час.

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

date.setUTCMinutes(60);

console.log(date.getUTCFullYear()); // 2025
console.log(date.getUTCMonth()); // 0
console.log(date.getUTCDate()); // 15
console.log(date.getUTCHours()); // 11
console.log(date.getUTCMinutes()); // 0
console.log(date.toISOString()); // "2025-01-15T11:00:00.000Z"

Здесь 60 означает переход на начало следующего часа по UTC.

Можно перейти и на предыдущий день

Если передать отрицательное значение, JavaScript сдвинет дату назад.

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

date.setUTCMinutes(-1);

console.log(date.getUTCFullYear()); // 2025
console.log(date.getUTCMonth()); // 0
console.log(date.getUTCDate()); // 14
console.log(date.getUTCHours()); // 23
console.log(date.getUTCMinutes()); // 59
console.log(date.toISOString()); // "2025-01-14T23:59:00.000Z"

Здесь время переходит на предыдущий день по UTC.

setUTCMinutes() не меняет секунды сам по себе

Это полезно помнить.

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

const date = new Date(Date.UTC(2025, 0, 15, 10, 20, 30, 400));

date.setUTCMinutes(45);

console.log(date.getUTCMinutes()); // 45
console.log(date.getUTCSeconds()); // 30
console.log(date.getUTCMilliseconds()); // 400

Invalid Date не восстанавливается через setUTCMinutes()

Если объект уже невалидный, setUTCMinutes() не сможет сделать его рабочим снова.

const date = new Date("invalid");

console.log(date.setUTCMinutes(10)); // NaN
console.log(String(date)); // "Invalid Date"

Невалидное значение делает дату Invalid Date

Если в setUTCMinutes() передать NaN или значение, которое превращается в NaN, результатом будет невалидная дата.

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

console.log(date.setUTCMinutes(NaN)); // NaN
console.log(String(date)); // "Invalid Date"

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

setUTCMinutes() не создаёт новый объект даты

Этот метод не создаёт новую дату рядом со старой.

Он изменяет уже существующий объект Date.

const date = new Date(Date.UTC(2025, 0, 15, 10, 20, 30));
const sameDate = date;

date.setUTCMinutes(45);

console.log(sameDate.getUTCMinutes()); // 45

Обе переменные указывают на один и тот же объект.

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

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

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

Пример:

const meeting = new Date("2025-01-15T10:20:30Z");

meeting.setUTCMinutes(0);

console.log(meeting.toISOString()); // "2025-01-15T10:00:30.000Z"

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

Ожидать новый объект Date, а не изменение старого

const date = new Date(Date.UTC(2025, 0, 15, 10, 20, 30));

date.setUTCMinutes(45);

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

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

Ожидать объект Date в результате

const date = new Date(Date.UTC(2025, 0, 15, 10, 20, 30));
const result = date.setUTCMinutes(45);

console.log(typeof result); // "number"

Результат метода - timestamp, а не объект даты.

Забывать, что можно передать дополнительные аргументы

const date = new Date(Date.UTC(2025, 0, 15, 10, 20, 30, 400));

date.setUTCMinutes(45, 50, 900);

setUTCMinutes() умеет менять не только минуты, но и остальные части времени.

Думать, что значение больше 59 вызовет ошибку

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

date.setUTCMinutes(60);

Ошибка не появится. JavaScript просто перенесёт время на следующий час.

Забывать про переход на предыдущий день

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

date.setUTCMinutes(-1);

Отрицательное значение может перенести время назад.

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

const date = new Date(Date.UTC(2025, 0, 15, 10, 20, 30));

console.log(date.getUTCMinutes()); // 20
date.setUTCMinutes(45);

Один метод читает значение, другой его изменяет.

Путать setUTCMinutes() и setMinutes()

setUTCMinutes() работает по UTC, а setMinutes() - по локальному часовому поясу пользователя.

Если важен именно UTC, лучше использовать setUTCMinutes().

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

  • setUTCMinutes() вызывается у объекта Date
  • метод изменяет исходную дату
  • результатом является timestamp
  • можно передать только минуты или сразу минуты, секунды и миллисекунды
  • обычно минуты идут от 0 до 59
  • значения меньше 0 и больше 59 нормализуются автоматически
  • setUTCMinutes() работает по UTC
  • для локального времени есть setMinutes()
  • у невалидного аргумента результатом будет Invalid Date
  • Invalid Date через setUTCMinutes() не восстанавливается

Коротко

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

← setUTCHours() - изменение часов по UTC в JavaScript
setUTCSeconds() - изменение секунд по UTC в JavaScript →