Date.prototype.setSeconds()

Try it

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

event.setSeconds(42);

console.log(event.getSeconds());
// Expected output: 42

console.log(event);
// Expected output: "Sat Apr 19 1975 23:15:42 GMT+0100 (CET)"
// Note: your timezone may vary

Cú pháp

setSeconds(secondsValue)
setSeconds(secondsValue, msValue)

Tham số

secondsValue

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

msValue Optional

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 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 tham số msValue, giá trị được trả về từ phương thức getMilliseconds() 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, setSeconds() 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 được lưu trong đối tượng Date sẽ tăng thêm 1, và 40 sẽ được dùng cho giây.

Vì setSeconds() 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 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 setUTCSeconds() 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 setSeconds()

const theBigDay = new Date();
theBigDay.setSeconds(30);

Đặc tả kỹ thuật

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

Xem thêm

• Date.prototype.getSeconds()
• Date.prototype.setUTCSeconds()