Пожалуйста, учтите, что спецификации и другая информация, содержащаяся здесь, не являются заключительными и могут быть изменены. Информация доступна для вас исключительно ради ознакомления.
 Платформа Java™
Стандарт Эд. 8

Проект сборка-b92

Пакет java.time.temporal

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

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

Пакет 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
 Платформа Java™
Стандарт Эд. 8

Проект сборка-b92

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.

Проект сборка-b92




Spec-Zone.ru - all specs in one place