Temporal.PlainMonthDay.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.PlainMonthDay.from() (ngoại trừ calendar): day, era và eraYear, month, monthCode, year. Các thuộc tính không được chỉ định sử dụng các giá trị từ tháng-ngày gốc. Bạn cần cung cấp năm nếu và chỉ nếu bạn cung cấp month và lịch không phải iso8601. 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ị kia 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 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.PlainMonthDay 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ủa các trường được sao chép từ ngày gốc.

Ngoại lệ

TypeError

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

• info không phải là đối tượng.
• options không phải là đối tượng hay undefined.

RangeError

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

• Các thuộc tính được 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 không phải số được 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ố được cung cấp nằm ngoài phạm vi, và options.overflow được đặt thành "reject".
• Nếu năm được cung cấp, lịch không phải iso8601, và năm không nằm trong phạm vi có thể biểu diễn hoặc năm, từ -271821 đến 275760.

Ví dụ

Sử dụng with()

const md = Temporal.PlainMonthDay.from("07-01");
const newMd = md.with({ day: 2 });
console.log(newMd.toString()); // "07-02"

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

Đặc tả kỹ thuật

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

Xem thêm

• Temporal.PlainMonthDay
• Temporal.PlainMonthDay.from()