Пакет java.time.temporal

Доступ до настоящего времени и время, используя поля и модули, и регуляторы времени даты.

См.: Описание

Сводка интерфейса

Интерфейс	Описание
Временный	Интерфейс на уровне платформы, определяющий доступ для чтения-записи к временному объекту, такому как дата, время, смещение или некоторая комбинация их.
TemporalAccessor	Интерфейс на уровне платформы, определяющий доступ только для чтения к временному объекту, такому как дата, время, смещение или некоторая комбинация их.
TemporalAdjuster	Стратегия корректировки временного объекта.
TemporalAmount	Интерфейс на уровне платформы, определяющий количество времени, такое как "6 часов", "8 дней" или "2 года и 3 месяца".
TemporalField	Поле разовых датой, такое как месяц-летнего или час-минутного.
TemporalQuery <R>	Стратегия запросов временного объекта.
TemporalUnit	Модуль разовых датой, такой как Дни или Часы.

Сводка класса

Класс	Описание
IsoFields	Поля и модули, определенные для календарной системы ISO 8601, включая четверть-летнего и "неделя базируемый год".
JulianFields	Ряд полей даты, которые обеспечивают доступ к Юлианским Дням.
ValueRange	Диапазон допустимых значений для разового датой поля.
WeekFields	Локализованные определения дня-недельного, недели-месячного и недельных-летнего полей.

Перечислимая Сводка

Перечисление	Описание
ChronoField	Стандартный набор полей.
ChronoUnit	Стандартный набор модулей периодов даты.

Сводка исключения

Исключение	Описание
UnsupportedTemporalTypeException	UnsupportedTemporalTypeException указывает, что ChronoField или ChronoUnit не поддерживаются для Временного class.

Пакет java.time.temporal Описание

Доступ до настоящего времени и время, используя поля и модули, и регуляторы времени даты.

Этот пакет подробно останавливается на основном пакете, чтобы обеспечить дополнительную функциональность для более мощных вариантов использования. Поддержка включается для:

• Модули разовых датой, такие как годы, месяцы, дни и часы
• Поля разовых датой, такие как месяц-летнего, день-недельного или час-дневного
• Разовые датой функции корректировки
• Различные определения недель

Поля и Модули

Даты и времена выражаются с точки зрения полей и модулей. Модуль используется, чтобы измерить количество времени, такое как годы, дни или минуты. Вся реализация модулей TemporalUnit. Набор известных модулей определяется в ChronoUnit, такой как DAYS. Интерфейс модуля разрабатывается, чтобы позволить приложениям определенные модули.

Поле используется, чтобы выразить часть большего разового датой, такую как год, месяц-летнего или второй-минутного. Вся полевая реализация TemporalField. Набор известных полей определяется в ChronoField, такой как HOUR_OF_DAY. Дополнительные поля определяются JulianFields, WeekFields и IsoFields. Полевой интерфейс разрабатывается, чтобы позволить приложениям определенные поля.

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

Одно использование полей в коде программы должно получить поля, для которых нет никакого метода удобства. Например, получение дня-месячного достаточно распространено, что есть метод на LocalDate вызванный getDayOfMonth(). Однако для более необычных полей необходимо использовать поле. Например, date.get(ChronoField.ALIGNED_WEEK_OF_MONTH). Поля также обеспечивают доступ к диапазону допустимых значений.

Корректировка и Запрос

Ключевая роль разового датой пространства задач корректирует дату к новому, связанному значению, такой как "в последний день месяца", или "следующей среды". Они моделируются как функции, которые корректируют разовую датой основу. Реализация функций TemporalAdjuster и работайте на Temporal. В ряде общих функций обеспечивают TemporalAdjuster. Например, чтобы найти первое возникновение дня-недельного после данной даты, использовать TemporalAdjuster.next(DayOfWeek), такой как date.with(next(MONDAY)). Приложения могут также определить регуляторы, реализовывая TemporalAdjuster.

TemporalAmount количество моделей интерфейса относительного времени.

В дополнение к корректировке разового датой интерфейс обеспечивается, чтобы позволить запросить - TemporalQuery. Наиболее распространенные реализации интерфейса запроса являются ссылками метода. from(TemporalAccessor) методы на главных классах могут все использоваться, такой как LocalDate::from или Month::from. В дальнейших реализациях обеспечивают TemporalQuery как статические методы. Приложения могут также определить запросы, реализовывая TemporalQuery.

Недели

У различных локалей есть различные определения недели. Например, в Европе неделя обычно запускается в понедельник, в то время как в US это запускается в воскресенье. WeekFields class моделирует это различие.

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

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

Если не указано иное, передача нулевого параметра конструктору или методу в любом class или интерфейсу в этом пакете вызовет a NullPointerException быть брошенным. Javadoc "@param" определение используется, чтобы суммировать нулевое поведение. "@throws NullPointerException"явно не документируется в каждый метод.

Все вычисления должны проверить на числовое переполнение и бросить любого ArithmeticException или a DateTimeException.

С тех пор:

JDK1.8