Temporal.Instant.prototype.since()

Метод since() экземпляров Temporal.Instant возвращает новый объект Temporal.Duration, представляющий собой продолжительность от другого момента времени (в форме, конвертируемой методом Temporal.Instant.from()) до этого момента времени. Продолжительность положительна, если другой момент времени предшествует этому, и отрицательна, если следует за ним.

Этот метод this - other. Чтобы other - this, используйте метод until().

Синтаксис

since(other)
since(other, options)

Параметры

other

Строка или экземпляр Temporal.Instant, представляющий момент времени, который нужно вычесть из этого момента времени. Он преобразуется в объект Temporal.Instant с использованием того же алгоритма, что и Temporal.Instant.from().

options Необязательный

Объект, содержащий параметры для Temporal.Duration.prototype.round(), включая largestUnit, roundingIncrement, roundingMode и smallestUnit. largestUnit и smallestUnit принимают только единицы измерения: "hours", "minutes", "seconds", "milliseconds", "microseconds", "nanoseconds" или их единственные формы. Для largestUnit значение по умолчанию "auto" означает "seconds" или smallestUnit, в зависимости от того, какое значение больше. Для smallestUnit значение по умолчанию — "nanoseconds".

Возвращаемое значение

Новый объект Temporal.Duration, представляющий продолжительность *с* other до этого момента времени. Продолжительность положительна, если other предшествует этому моменту времени, и отрицательна, если следует за ним.

Исключения

RangeError

Выбрасывается, если какой-либо из параметров недопустим.

Примеры

Использование since()

const lastUpdated = Temporal.Instant.fromEpochMilliseconds(1735235418000);
const now = Temporal.Now.instant();
const duration = now.since(lastUpdated, { smallestUnit: "minute" });
console.log(`Last updated ${duration.toLocaleString("en-US")} ago`);

Балансировка результирующей продолжительности

Поскольку момент времени не содержит календарной информации, результирующая продолжительность избегает календарных продолжительностей, которые неоднозначны без календаря и опорной точки времени. Поэтому результат несбалансирован, так как hours может быть больше 24. Чтобы сбалансировать продолжительность, округлите результирующую продолжительность еще раз с использованием желаемого largestUnit, передав relativeTo, который несет календарную информацию.

const lastUpdated = Temporal.Instant.fromEpochMilliseconds(1735235418000);
const now = Temporal.Now.instant();
const duration = now.since(lastUpdated, { smallestUnit: "minutes" });
const roundedDuration = duration.round({
  largestUnit: "years",
  // Use the ISO calendar; you can convert to another calendar using
  // withCalendar()
  relativeTo: now.toZonedDateTimeISO("UTC"),
});
console.log(`Last updated ${roundedDuration.toLocaleString("en-US")} ago`);

Спецификации

Совместимость с браузерами

См. также

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