Temporal.Instant.prototype.add()

Cú pháp

add(duration)

Tham số

duration

Một chuỗi, một đối tượng, hoặc một thực thể Temporal.Duration biểu diễn khoảng thời gian cần thêm vào instant này. Nó được chuyển đổi thành đối tượng Temporal.Duration bằng cùng thuật toán như Temporal.Duration.from().

Giá trị trả về

Một đối tượng Temporal.Instant mới biểu diễn việc thêm duration vào instant này. Nếu duration là dương, thì instant được trả về muộn hơn instant này; nếu duration là âm, thì instant được trả về sớm hơn instant này.

Ngoại lệ

RangeError

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

• duration là khoảng thời gian theo lịch (nó có years, months, hoặc weeks khác không), hoặc có days khác không, vì khoảng thời gian theo lịch là mơ hồ mà không có lịch và tham chiếu thời gian.
• Kết quả không nằm trong phạm vi có thể biểu diễn, là ±10⁸ ngày, hoặc khoảng ±273.972,6 năm, từ epoch Unix.

Mô tả

Về bản chất, phương thức add() trước tiên lấy số nano giây được biểu diễn bởi duration, cộng nó vào epochNanoseconds của instant này, sau đó tạo một đối tượng Temporal.Instant mới từ kết quả. Do đó, khoảng thời gian phải biểu diễn một lượng thời gian cố định một cách rõ ràng.

Nếu bạn muốn thêm một khoảng thời gian theo lịch, việc cộng phải được thực hiện trong ngữ cảnh của lịch và múi giờ để tính đến độ dài thay đổi của các tháng, năm và ngày (do giờ tiết kiệm ánh sáng ban ngày). Trong trường hợp này, hãy chuyển đổi instant thành đối tượng Temporal.ZonedDateTime, thêm khoảng thời gian, sau đó chuyển đổi kết quả trở lại thành instant.

Thêm một khoảng thời gian tương đương với việc trừ giá trị phủ định của nó.

Ví dụ

Thêm một Temporal.Duration

const instant = Temporal.Instant.fromEpochMilliseconds(0);
const duration = Temporal.Duration.from("PT1S");
const newInstant = instant.add(duration);
console.log(newInstant.epochMilliseconds); // 1000

Thêm một đối tượng hoặc chuỗi

const instant = Temporal.Instant.fromEpochMilliseconds(0);
const newInstant = instant.add({ seconds: 1 });
console.log(newInstant.epochMilliseconds); // 1000

const newInstant2 = instant.add("PT1S");
console.log(newInstant2.epochMilliseconds); // 1000

Thêm một khoảng thời gian theo lịch

const instant = Temporal.Instant.fromEpochMilliseconds(1730610000000);
const duration = Temporal.Duration.from({ days: 1 });

// This instant is 2024-11-03T01:00:00-04:00[America/New_York],
// which is a DST transition day in the US.
const instant2 = instant
  .toZonedDateTimeISO("America/New_York")
  .add(duration)
  .toInstant();
console.log(instant2.epochMilliseconds); // 1730700000000

// The same instant is not a DST transition day in Paris.
const instant3 = instant
  .toZonedDateTimeISO("Europe/Paris")
  .add(duration)
  .toInstant();
console.log(instant3.epochMilliseconds); // 1730696400000

Đặc tả

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

Xem thêm

• Temporal.Instant
• Temporal.Duration
• Temporal.Instant.prototype.subtract()