compact1, compact2, compact3

java.time.temporal

Интерфейс TemporalAmount

Все Известные Классы с реализацией:

Продолжительность, Период

public interface TemporalAmount

Интерфейс на уровне платформы, определяющий количество времени, такое как "6 часов", "8 дней" или "2 года и 3 месяца".

Это - основной тип интерфейса для количества времени. Количество отлично от даты или времени суток, в котором оно не связывается ни к какому отдельному моменту на временной шкале.

Количество может считаться a Map из TemporalUnit к long, представленный через getUnits() и get(TemporalUnit). У простого случая могла бы быть пара значения единого блока, такая как "6 часов". У более сложного случая могут быть многократные пары значения модуля, такие как "7 лет, 3 месяца и 5 дней".

Есть две общих реализации. Period основанная на дате реализация, храня годы, месяцы и дни. Duration основанная на времени реализация, храня секунды и наносекунды, но обеспечивая некоторый доступ, используя другую продолжительность базируемые модули, такие как минуты, часы и фиксировала 24-часовые дни.

Этот интерфейс является интерфейсом на уровне платформы, который не должен широко использоваться в коде программы. Вместо этого приложения должны создать и раздать экземпляры конкретных типов, такой как Period и Duration.

Требования реализации:

Этот интерфейс не устанавливает ограничений для переменчивости реализаций, однако неизменность строго рекомендуется.

С тех пор:

1.8

Сводка метода

Модификатор и Тип	Метод и Описание
Временный	addTo(Temporal temporal) Добавляет к указанному временному объекту.
long	get(TemporalUnit unit) Возвращает значение требуемого модуля.
List<TemporalUnit>	getUnits() Возвращает список модулей, уникально определяющих значение этого TemporalAmount.
Временный	subtractFrom(Temporal temporal) Вычитает этот объект из указанного временного объекта.

Деталь метода

добраться

long get(TemporalUnit unit)

Возвращает значение требуемого модуля. Модули, возвращенные из getUnits() уникально определите значение TemporalAmount. Значение должно быть возвращено для каждого модуля, перечисленного в getUnits.

Требования реализации:

Реализации могут объявить поддержку модулей, не перечисленных getUnits(). Как правило, реализация определила бы дополнительные модули как преобразования для удобства разработчиков.

Параметры:

unit - TemporalUnit для которого можно возвратить значение

Возвраты:

длинное значение модуля

Броски:

DateTimeException - если значение для модуля не может быть получено

UnsupportedTemporalTypeException - если unit не поддерживается

getUnits

List<TemporalUnit> getUnits()

Возвращает список модулей, уникально определяющих значение этого TemporalAmount. Список TemporalUnits определяется реализацией class. Список является снимком модулей в это время getUnits вызывается и не изменчив. Модули упорядочиваются от самой долгой продолжительности до самой короткой продолжительности модуля.

Требования реализации:

Список модулей полностью и уникально представляет состояние объекта без пропуска, перекрытий или дублирования. Модули в порядке от самой долгой продолжительности до самого короткого.

Возвраты:

Список TemporalUnits; не нуль

addTo

Temporal addTo(Temporal temporal)

Добавляет к указанному временному объекту.

Добавляет количество к указанному временному объекту, используя логику, инкапсулировавшую в реализации class.

Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод непосредственно. Второе должно использовать Temporal.plus(TemporalAmount):

   // These two lines are equivalent, but the second approach is recommended
   dateTime = amount.addTo(dateTime);
   dateTime = dateTime.plus(adder);
 

Рекомендуется использовать второй подход, plus(TemporalAmount), поскольку это является намного более четким, чтобы читать в коде.

Требования реализации:

Реализация должна взять входной объект и добавить к нему. Реализация определяет логику дополнения и ответственна за документирование той логики. Это может использовать любой метод на Temporal запрашивать временный объект и выполнять дополнение. У возвращенного объекта должен быть тот же самый заметный тип как входной объект

Входной объект не должен быть изменен. Вместо этого должна быть возвращена скорректированная копия оригинала. Это обеспечивает эквивалентное, безопасное поведение для неизменных и изменчивых временных объектов.

Ввод временный объект может быть в календарной системе кроме ISO. Реализации могут хотеть документировать совместимость с другими календарными системами, или отклонять не-ISO временные объекты querying the chronology.

Этот метод можно вызвать от многократных потоков параллельно. Это должно быть ориентировано на многопотоковое исполнение когда вызвано.

Параметры:

temporal - временный объект добавить количество к, не нуль

Возвраты:

объект того же самого заметного типа со сделанным дополнением, не нуль

Броски:

DateTimeException - если неспособный добавить

ArithmeticException - если числовое переполнение происходит

subtractFrom

Temporal subtractFrom(Temporal temporal)

Вычитает этот объект из указанного временного объекта.

Вычитает количество из указанного временного объекта, используя логику, инкапсулировавшую в реализации class.

Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод непосредственно. Второе должно использовать Temporal.minus(TemporalAmount):

   // these two lines are equivalent, but the second approach is recommended
   dateTime = amount.subtractFrom(dateTime);
   dateTime = dateTime.minus(amount);
 

Рекомендуется использовать второй подход, minus(TemporalAmount), поскольку это является намного более четким, чтобы читать в коде.

Требования реализации:

Реализация должна взять входной объект и вычесть из него. Реализация определяет логику вычитания и ответственна за документирование той логики. Это может использовать любой метод на Temporal запрашивать временный объект и выполнять вычитание. У возвращенного объекта должен быть тот же самый заметный тип как входной объект

Входной объект не должен быть изменен. Вместо этого должна быть возвращена скорректированная копия оригинала. Это обеспечивает эквивалентное, безопасное поведение для неизменных и изменчивых временных объектов.

Ввод временный объект может быть в календарной системе кроме ISO. Реализации могут хотеть документировать совместимость с другими календарными системами, или отклонять не-ISO временные объекты querying the chronology.

Этот метод можно вызвать от многократных потоков параллельно. Это должно быть ориентировано на многопотоковое исполнение когда вызвано.

Параметры:

temporal - временный объект вычесть количество из, не нуль

Возвраты:

объект того же самого заметного типа со сделанным вычитанием, не нуль

Броски:

DateTimeException - если неспособный вычитать

ArithmeticException - если числовое переполнение происходит