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);
Спецификации
Совместимость с браузерами
| Десктопные | Мобильные | Серверные | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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 |
Смотрите также
© 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