Date.prototype.setUTCHours()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Phương thức setUTCHours() của các instance Date thay đổi giờ, phút, giây và/hoặc mili giây cho ngày này theo giờ quốc tế.
Try it
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"
Cú pháp
setUTCHours(hoursValue)
setUTCHours(hoursValue, minutesValue)
setUTCHours(hoursValue, minutesValue, secondsValue)
setUTCHours(hoursValue, minutesValue, secondsValue, msValue)
Tham số
hoursValue-
Một số nguyên từ 0 đến 23 đại diện cho giờ.
minutesValueOptional-
Một số nguyên từ 0 đến 59 đại diện cho phút.
secondsValueOptional-
Một số nguyên từ 0 đến 59 đại diện cho giây. Nếu bạn chỉ định
secondsValue, bạn cũng phải chỉ địnhminutesValue. msValueOptional-
Một số nguyên từ 0 đến 999 đại diện cho mili giây. Nếu bạn chỉ định
msValue, bạn cũng phải chỉ địnhminutesValuevàsecondsValue.
Giá trị trả về
Thay đổi đối tượng Date tại chỗ và trả về timestamp mới của nó. Nếu một tham số là NaN (hoặc các giá trị khác bị ép kiểu thành NaN, chẳng hạn như undefined), ngày sẽ được đặt thành Invalid Date và NaN được trả về.
Mô tả
Nếu bạn không chỉ định các tham số minutesValue, secondsValue và msValue, các giá trị được trả về từ phương thức getUTCMinutes(), getUTCSeconds() và getUTCMilliseconds() sẽ được sử dụng.
Nếu một tham số bạn chỉ định nằm ngoài phạm vi dự kiến, setUTCHours() cố gắng cập nhật thông tin ngày trong đối tượng Date tương ứng. Ví dụ, nếu bạn dùng 100 cho secondsValue, phút sẽ tăng thêm 1 (minutesValue + 1), và 40 sẽ được dùng cho giây.
Ví dụ
>Sử dụng setUTCHours()
const theBigDay = new Date();
theBigDay.setUTCHours(8);
Đặc tả kỹ thuật
| Specification |
|---|
| ECMAScript® 2027 Language Specification> # sec-date.prototype.setutchours> |