Temporal.PlainDateTime.prototype.add()

Khả dụng hạn chế

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Phương thức add() của các instance Temporal.PlainDateTime trả về một đối tượng Temporal.PlainDateTime mới đại diện cho ngày-giờ này tiến về phía trước một khoảng thời gian cho trước (theo dạng có thể chuyển đổi bởi Temporal.Duration.from()).

Cú pháp

add(duration)
add(duration, options)

Tham số

duration

Một chuỗi, một đối tượng, hoặc một instance Temporal.Duration đại diện cho khoảng thời gian cần thêm vào ngày-giờ này. Nó được chuyển đổi thành đối tượng Temporal.Duration sử dụng cùng thuật toán như Temporal.Duration.from().

options Optional

Một đối tượng chứa thuộc tính sau:

overflow Optional

Một chuỗi chỉ định hành vi khi một thành phần ngày nằm ngoài phạm vi. Các giá trị có thể là:

"constrain" (mặc định): Thành phần ngày được kẹp vào phạm vi hợp lệ.
"reject": Một RangeError được ném ra nếu thành phần ngày nằm ngoài phạm vi.

Giá trị trả về

Một đối tượng Temporal.PlainDateTime mới đại diện cho ngày-giờ được chỉ định bởi PlainDateTime gốc, cộng với khoảng thời gian.

Ngoại lệ

RangeError: Được ném ra nếu kết quả không nằm trong phạm vi có thể biểu diễn, là ±(10⁸ + 1) ngày, khoảng ±273.972,6 năm, tính từ Unix epoch.

const start = Temporal.PlainDateTime.from("2021-01-01T12:34:56");
const end = start.add({
  years: 1,
  months: 2,
  weeks: 3,
  days: 4,
  hours: 5,
  minutes: 6,
  seconds: 7,
  milliseconds: 8,
});
console.log(end.toString()); // 2022-03-26T17:41:03.008

Để xem thêm ví dụ, đặc biệt về cách các lịch khác nhau và tùy chọn overflow tương tác với khoảng thời gian theo lịch, xem Temporal.PlainDate.prototype.add().