Temporal.PlainDateTime.prototype.add()

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.

Mô tả

Để biết cách khoảng thời gian theo lịch được cộng, xem Temporal.PlainDate.prototype.add().

Cộng một khoảng thời gian tương đương với việc trừ phần âm của nó.

Ví dụ

Cộng một khoảng thời gian

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().

Đặc tả

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

Xem thêm

• Temporal.PlainDateTime
• Temporal.Duration
• Temporal.PlainDateTime.prototype.subtract()