Temporal.PlainTime.prototype.with()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Phương thức with() của các thực thể Temporal.PlainTime trả về một đối tượng Temporal.PlainTime mới đại diện cho thời gian này với một số trường được thay thế bằng các giá trị mới. Vì tất cả các đối tượng Temporal được thiết kế để bất biến, phương thức này về cơ bản hoạt động như setter cho các trường của thời gian.
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 bởi
Temporal.PlainTime.from():hour,microsecond,millisecond,minute,nanosecond,second. Các thuộc tính không được chỉ định sẽ sử dụng giá trị từ thời gian gốc. optionsOptional-
Một đối tượng chứa thuộc tính sau:
overflowOptional-
Một chuỗi chỉ định hành vi khi một thành phần thời gian nằm ngoài phạm vi. Các giá trị có thể là:
"constrain"(mặc định)-
Thành phần thời gian đượ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 thời gian nằm ngoài phạm vi.
Giá trị trả về
Một đối tượng Temporal.PlainTime 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ừ thời gian gốc.
Ngoại lệ
TypeError-
Ném ra trong một trong các trường hợp sau:
infokhông phải là đối tượng có ít nhất một thuộc tính được nhận hoặc một chuỗi.optionskhông phải là đối tượng hoặcundefined.
RangeError-
Ném ra nếu 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".
Ví dụ
Sử dụng with()
const time = Temporal.PlainTime.from("12:34:56.123456789");
const newTime = time.with({ hour: 23 });
console.log(newTime.toString()); // '23:34:56.123456789'
Để xem thêm ví dụ, hãy xem tài liệu cho từng thuộc tính có thể được đặt bằng with().
Đặc tả
| Specification |
|---|
| Temporal # sec-temporal.plaintime.prototype.with |