Temporal.PlainYearMonth.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.PlainYearMonth.from() (ngoại trừ calendar): era và eraYear, month, monthCode, year. Các thuộc tính không được chỉ định sẽ sử dụng các giá trị từ năm-tháng 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ị 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 cắt bớt về 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.PlainYearMonth 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 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 được cung cấp chỉ định cùng một thành phần nhưng mâu thuẫn nhau.
• 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ột mã tháng hợp lệ trong calendar 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".
• Kết quả không nằm trong phạm vi có thể biểu diễn, tức là ±(10⁸ + 1) ngày, hoặc khoảng ±273.972,6 năm, tính từ Unix epoch.

Ví dụ

Sử dụng with()

const ym = Temporal.PlainYearMonth.from("2021-07");
const newYM = ym.with({ year: 2024 });
console.log(newYM.toString()); // "2024-07"

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

Đặc tả kỹ thuật

Khả năng tương thích với trình duyệt

Xem thêm

• Temporal.PlainYearMonth
• Temporal.PlainYearMonth.from()