Temporal.PlainDateTime.prototype.withPlainTime()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Phương thức withPlainTime() của các instance Temporal.PlainDateTime trả về một đối tượng Temporal.PlainDateTime mới đại diện cho ngày-giờ này với phần thời gian được thay thế hoàn toàn bởi thời gian mới (theo dạng có thể chuyển đổi bởi Temporal.PlainTime.from())

Phương thức này sẽ thay thế tất cả các thuộc tính thời gian, mặc định là 0 với các thuộc tính không được chỉ định. Nếu bạn chỉ muốn thay thế một số thuộc tính thời gian, hãy dùng phương thức with() thay thế.

Cú pháp

js
withPlainTime()
withPlainTime(plainTime)

Tham số

plainTime Optional

Một chuỗi, một đối tượng, hoặc một instance Temporal.PlainTime đại diện cho thời gian mới. Nó được chuyển đổi thành đối tượng Temporal.PlainTime sử dụng cùng thuật toán như Temporal.PlainTime.from(). Nếu không được chỉ định, phần thời gian sẽ được đặt thành 00:00:00.

Giá trị trả về

Một đối tượng Temporal.PlainDateTime mới, với phần ngày được sao chép từ ngày-giờ gốc và phần thời gian được thay thế bởi thời gian mới.

Ví dụ

Sử dụng withPlainTime()

js
const dt = Temporal.PlainDateTime.from("2021-07-01T12:34:56");

// You can pass a string
const newDT = dt.withPlainTime("13:45:00");
console.log(newDT.toString()); // "2021-07-01T13:45:00"

// You can only specify some time properties, and the rest default to 0;
// for the with() method, they would be copied from the original date-time
const newDT2 = dt.withPlainTime({ hour: 13 });
console.log(newDT2.toString()); // "2021-07-01T13:00:00"

// You can pass nothing to set the time to midnight
const newDT3 = dt.withPlainTime();
console.log(newDT3.toString()); // "2021-07-01T00:00:00"

Đặc tả

Specification
Temporal
# sec-temporal.plaindatetime.prototype.withplaintime

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

Xem thêm