Temporal.PlainDateTime.prototype.with()

Cú pháp

with(info)
with(info, options)

Tham số

info

Một đối tượng chứa ít nhất một trong các thuộc tính được nhận dạng bởi Temporal.PlainDateTime.from() (ngoại trừ calendar): day, era và eraYear, hour, microsecond, millisecond, minute, month, monthCode, nanosecond, second, year. Các thuộc tính không được chỉ định sẽ sử dụng giá trị từ ngày-giờ gốc. Bạn chỉ cần cung cấp một trong month hoặc monthCode, và một trong era và eraYear hoặc year, và giá trị còn lại sẽ được cập nhật tương ứng.

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, trong đó các trường được chỉ định trong info mà không phải undefined được thay thế bằng các giá trị tương ứng, và phần còn lại được sao chép từ ngày-giờ gốc.

Ngoại lệ

TypeError

Được ném ra trong một trong các trường hợp sau:

• info không phải là một đối tượng.
• options không phải là một đối tượng hoặc undefined.

RangeError

Được ném ra trong một trong các trường hợp sau:

• Các thuộc tính cung cấp chỉ định cùng một thành phần nhưng không nhất quán.
• Các thuộc tính phi số cung cấp không hợp lệ; ví dụ, nếu monthCode không bao giờ là mã tháng hợp lệ trong lịch này.
• Các thuộc tính số cung cấp nằm ngoài phạm vi và options.overflow được đặt thành "reject".
• 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.

Ví dụ

Sử dụng with()

const dt = Temporal.PlainDateTime.from("2021-07-01T12:34:56");
const newDT = dt.with({ hour: 13 });
console.log(newDT.toString()); // "2021-07-01T13:34:56"
const newDT2 = dt.with({ month: 2, day: 22, millisecond: 222 });
console.log(newDT2.toString()); // "2021-02-22T13:34:56.222"
const nextDecade = dt.with({ year: dt.year + 10 });
console.log(nextDecade.toString()); // "2031-07-01T13:34:56"

Để xem thêm ví dụ, xem tài liệu cho từng thuộc tính có thể được đặt bằng with().

Đặc tả

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

Xem thêm

• Temporal.PlainDateTime
• Temporal.PlainDateTime.prototype.withCalendar()
• Temporal.PlainDateTime.prototype.withPlainTime()
• Temporal.PlainDateTime.from()
• Temporal.PlainDateTime.prototype.add()
• Temporal.PlainDateTime.prototype.subtract()