Temporal.Instant.from()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Phương thức tĩnh Temporal.Instant.from() tạo một đối tượng Temporal.Instant mới từ đối tượng Temporal.Instant khác, hoặc một chuỗi RFC 9557.
Cú pháp
js
Temporal.Instant.from(info)
Tham số
info-
Một trong các giá trị sau:
- Một thực thể
Temporal.Instant, tạo một bản sao của thực thể. - Một chuỗi RFC 9557 chứa ngày, giờ và độ lệch múi giờ. Tên múi giờ bị bỏ qua; chỉ độ lệch được sử dụng.
- Một thực thể
Giá trị trả về
Một đối tượng Temporal.Instant mới biểu diễn thời điểm được chỉ định bởi info.
Ngoại lệ
TypeError-
Được ném nếu
infokhông phải là thực thểTemporal.Instanthay chuỗi. RangeError-
Được ném trong một trong các trường hợp sau:
- Chuỗi không phải là chuỗi RFC 9557 hợp lệ.
- Thông tin không nằm trong phạm vi có thể biểu diễn, là ±108 ngày, hoặc khoảng ±273.972,6 năm, từ epoch Unix.
Ví dụ
Tạo một instant từ chuỗi
js
const instant = Temporal.Instant.from("1970-01-01T00Z");
console.log(instant.toString()); // 1970-01-01T00:00:00Z
const instant2 = Temporal.Instant.from("1970-01-01T00+08:00");
console.log(instant2.toString()); // 1969-12-31T16:00:00Z
// America/New_York is UTC-5 in January 1970, not UTC+8
const instant3 = Temporal.Instant.from("1970-01-01T00+08:00[America/New_York]");
console.log(instant3.toString()); // 1969-12-31T16:00:00Z; the time zone name is ignored
Tạo một instant từ instant khác
js
const instant = Temporal.Instant.from("1970-01-01T00Z");
const instant2 = Temporal.Instant.from(instant);
console.log(instant2.toString()); // 1970-01-01T00:00:00Z
Đặc tả
| Specification |
|---|
| Temporal # sec-temporal.instant.from |