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

js
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ờ.

minutesValue Optional

Một số nguyên từ 0 đến 59 đại diện cho phút.

secondsValue Optional

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ỉ định minutesValue.

msValue Optional

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ỉ định minutesValuesecondsValue.

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 DateNaN được trả về.

Mô tả

Nếu bạn không chỉ định các tham số minutesValue, secondsValuemsValue, các giá trị được trả về từ phương thức getUTCMinutes(), getUTCSeconds()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()

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

Đặc tả kỹ thuật

Specification
ECMAScript® 2027 Language Specification
# sec-date.prototype.setutchours

Tương thích trình duyệt

Xem thêm