Date.prototype.setMilliseconds()

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 setMilliseconds() của các instance Date thay đổi mili giây cho ngày này theo giờ địa phương.

Try it

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

console.log(event.getMilliseconds());
// Expected output: 0

event.setMilliseconds(456);

console.log(event.getMilliseconds());
// Expected output: 456

Cú pháp

js
setMilliseconds(millisecondsValue)

Tham số

millisecondsValue

Một số nguyên từ 0 đến 999 đại diện cho mili giây.

Giá trị trả về

Thay đổi đối tượng Date tại chỗ và trả về timestamp mới của nó. Nếu millisecondsValueNaN (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 chỉ định một số ngoài phạm vi dự kiến, thông tin ngày trong đối tượng Date sẽ được cập nhật tương ứng. Ví dụ, nếu bạn chỉ định 1005, số giây sẽ tăng thêm 1 và 5 sẽ được dùng cho mili giây.

setMilliseconds() hoạt động theo giờ địa phương, việc vượt qua ranh giới Giờ tiết kiệm ánh sáng ban ngày (DST) có thể dẫn đến thời gian trôi qua khác với dự kiến. Ví dụ, nếu việc đặt mili giây vượt qua chuyển tiếp mùa xuân (mất một giờ), sự chênh lệch timestamp giữa ngày mới và ngày cũ sẽ ít hơn một giờ so với chênh lệch thời gian danh nghĩa. Ngược lại, việc vượt qua chuyển tiếp mùa thu (tăng một giờ) sẽ dẫn đến thêm một giờ. Nếu bạn cần điều chỉnh ngày theo một lượng thời gian cố định, hãy cân nhắc sử dụng setUTCMilliseconds() hoặc setTime().

Nếu thời gian địa phương mới nằm trong một chuyển tiếp offset, thời gian chính xác được suy ra bằng cách sử dụng hành vi tương tự như tùy chọn disambiguation: "compatible" của Temporal. Nghĩa là, nếu thời gian địa phương tương ứng với hai thời điểm, thời điểm trước được chọn; nếu thời gian địa phương không tồn tại (có khoảng trống), chúng ta tiến về phía trước bằng khoảng thời gian của khoảng trống.

Ví dụ

Sử dụng setMilliseconds()

js
const theBigDay = new Date();
theBigDay.setMilliseconds(100);

Đặc tả kỹ thuật

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

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

Xem thêm