Spec-Zone.ru › JavaScript

Date.prototype.setUTCHours()

Базовый уровень Широко доступен

Эта возможность хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

Метод setUTCHours() экземпляров Date изменяет часы, минуты, секунды и/или миллисекунды для этой даты в соответствии с универсальным временем.

Попробуйте

const event = new Date("August 19, 1975 23:15:30 GMT-3:00");

console.log(event.toUTCString());
// Expected output: "Wed, 20 Aug 1975 02:15:30 GMT"

console.log(event.getUTCHours());
// Expected output: 2

event.setUTCHours(23);

console.log(event.toUTCString());
// Expected output: "Wed, 20 Aug 1975 23:15:30 GMT"

Синтаксис

setUTCHours(hoursValue)
setUTCHours(hoursValue, minutesValue)
setUTCHours(hoursValue, minutesValue, secondsValue)
setUTCHours(hoursValue, minutesValue, secondsValue, msValue)

Параметры

hoursValue
Целое число от 0 до 23, представляющее часы.
minutesValue Необязательно
Целое число от 0 до 59, представляющее минуты.
secondsValue Необязательно
Целое число от 0 до 59, представляющее секунды. Если вы указываете secondsValue, вы также должны указать minutesValue.
msValue Необязательно
Целое число от 0 до 999, представляющее миллисекунды. Если вы указываете msValue, вы также должны указать minutesValue и secondsValue.

Возвращаемое значение

Изменяет объект Date на месте и возвращает его новую отметку времени. Если параметр равен NaN (или другим значениям, которые приводятся к NaN, например undefined), дата устанавливается как Недопустимая дата и возвращается NaN.

Описание

Если вы не указываете параметры minutesValue, secondsValue и msValue, используются значения, возвращаемые методами getUTCMinutes(), getUTCSeconds() и getUTCMilliseconds().

Если указанный вами параметр выходит за пределы ожидаемого диапазона, setUTCHours() пытается соответствующим образом обновить информацию о дате в объекте Date. Например, если вы используете 100 для secondsValue, минуты будут увеличены на 1 (minutesValue + 1), а для секунд будет использовано 40.

Примеры

Использование setUTCHours()

const theBigDay = new Date();
theBigDay.setUTCHours(8);

Спецификации

Спецификация
Спецификация языка ECMAScript® 2027
# sec-date.prototype.setutchours

Совместимость с браузерами

Десктопные Мобильные Серверные
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on iOS Samsung Internet WebView Android WebView on iOS Bun Deno Node.js
setUTCHours
1
12
1
4
1
18
4
10.1
1
1.0
4.4
1
1.0.0
1.0
0.10.0

Смотрите также

  • Date.prototype.getUTCHours()
  • Date.prototype.setHours()

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/setUTCHours

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API