ITemporal Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Интерфейс на уровне платформы, определяющий доступ для чтения и записи к темпоральным объектам, таким как дата, время, смещение или их комбинация.
[Android.Runtime.Register("java/time/temporal/Temporal", "", "Java.Time.Temporal.ITemporalInvoker", ApiSince=26)]
public interface ITemporal : IDisposable, Java.Interop.IJavaPeerable, Java.Time.Temporal.ITemporalAccessor
[<Android.Runtime.Register("java/time/temporal/Temporal", "", "Java.Time.Temporal.ITemporalInvoker", ApiSince=26)>]
type ITemporal = interface
interface ITemporalAccessor
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Производный
- Атрибуты
- Реализации
Комментарии
Интерфейс на уровне платформы, определяющий доступ для чтения и записи к темпоральным объектам, таким как дата, время, смещение или их комбинация.
Это базовый тип интерфейса для объектов даты, времени и смещения, которые достаточно завершены для обработки с помощью плюсов и минусов. Он реализуется теми классами, которые могут предоставлять и управлять информацией в виде полей Темпорального Поля или запросов TemporalQuery. См TemporalAccessor
. версию этого интерфейса, доступную только для чтения.
Большинство сведений о дате и времени можно представить в виде числа. Они смоделированы с помощью TemporalField
числа, удерживаемого с помощью для обработки больших значений long
. Год, месяц и день месяца являются простыми примерами полей, но они также включают мгновенные и смещения. См. ChronoField
стандартный набор полей.
Два фрагмента данных даты и времени не могут быть представлены числами: хронология java.time.chronology и часовой пояс java.time.ZoneId. Доступ к этим файлам можно получить с помощью #query(TemporalQuery) queries
статических методов, определенных в TemporalQuery
.
Этот интерфейс является интерфейсом на уровне платформы, который не должен широко использоваться в коде приложения. Вместо этого приложения должны создавать и передавать экземпляры конкретных типов, например LocalDate
. Для этого существует множество причин, часть из которых заключается в том, что реализации этого интерфейса могут находиться в системах календаря, отличных от ISO. Более java.time.chrono.ChronoLocalDate
подробное обсуждение этих вопросов см. в этой статье.
<h2>Когда следует реализовать</h2>
Класс должен реализовать этот интерфейс, если он соответствует трем критериям: <ul><li>он предоставляет доступ к сведениям о дате, времени и смещениях, так как в соответствии TemporalAccessor
<с li>набор полей является непрерывным от наибольшего к самому <>маленькому, так что для определения допустимого диапазона значений для полей, представленных </ul, не требуется никаких других полей.>
В четырех примерах это ясно: <ul><li>LocalDate
реализует этот интерфейс, так как он представляет набор полей, которые являются непрерывными от дней до бесконечности и не требуют внешней информации для определения действительности каждой даты. Таким образом, он может правильно реализовать плюс/минус. <Li>LocalTime
реализует этот интерфейс, так как представляет набор полей, которые являются смежными от nanos до в течение нескольких дней и не требуют внешней информации для определения допустимости. Он может правильно реализовать плюс/минус, завернув в течение дня. <Li>MonthDay
, сочетание месяца года и дня месяца, не реализует этот интерфейс. Хотя сочетание является непрерывным, от нескольких дней до месяцев в годах, сочетание не имеет достаточных сведений для определения допустимого диапазона значений для дня месяца. Таким образом, он не может правильно реализовать плюс/минус. <Li>Сочетание "день недели" и "день месяца" ("пятница 13-го") не должно реализовывать этот интерфейс. Он не представляет непрерывный набор полей, так как дни к неделям перекрывают дни и месяцы. </ul>
Добавлено в версии 1.8.
Документация по Java для java.time.temporal.Temporal
.
Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License Creative Commons 2.5 Attribution License.
Свойства
Handle |
Возвращает значение JNI базового объекта Android. (Унаследовано от IJavaObject) |
JniIdentityHashCode |
Возвращает значение для упаковаемого |
JniManagedPeerState |
Состояние управляемого однорангового узла. (Унаследовано от IJavaPeerable) |
JniPeerMembers |
Поддержка доступа и вызова участников. (Унаследовано от IJavaPeerable) |
PeerReference |
JniObjectReference Возвращает экземпляр объекта Java, заключенный в оболочку. (Унаследовано от IJavaPeerable) |
Методы
Disposed() |
Вызывается при удалении экземпляра. (Унаследовано от IJavaPeerable) |
DisposeUnlessReferenced() |
Если отсутствуют незадающиеся ссылки на этот экземпляр, вызывает |
Finalized() |
Вызывается после завершения работы экземпляра. (Унаследовано от IJavaPeerable) |
Get(ITemporalField) |
Возвращает значение указанного поля в виде |
GetLong(ITemporalField) |
Возвращает значение указанного поля в виде |
IsSupported(ITemporalField) |
Проверяет, поддерживается ли указанное поле. (Унаследовано от ITemporalAccessor) |
IsSupported(ITemporalUnit) |
Проверяет, поддерживается ли указанная единица измерения. |
Minus(Int64, ITemporalUnit) |
Возвращает объект того же типа, что и этот объект, с вычитаемой заданной точкой. |
Minus(ITemporalAmount) |
Возвращает объект того же типа, что и этот объект с вычитаемой суммой. |
Plus(Int64, ITemporalUnit) |
Возвращает объект того же типа, что и данный объект с указанной добавленной точкой. |
Plus(ITemporalAmount) |
Возвращает объект того же типа, что и этот объект с добавленной суммой. |
Query(ITemporalQuery) |
Запрашивает эту дату и время. (Унаследовано от ITemporalAccessor) |
Range(ITemporalField) |
Возвращает диапазон допустимых значений для указанного поля. (Унаследовано от ITemporalAccessor) |
SetJniIdentityHashCode(Int32) |
Задайте значение, возвращаемое . |
SetJniManagedPeerState(JniManagedPeerStates) |
Интерфейс на уровне платформы, определяющий доступ для чтения и записи к темпоральным объектам, таким как дата, время, смещение или их комбинация. (Унаследовано от IJavaPeerable) |
SetPeerReference(JniObjectReference) |
Задайте значение, возвращаемое . |
UnregisterFromRuntime() |
Отмените регистрацию этого экземпляра, чтобы среда выполнения не возвращала его из будущих Java.Interop.JniRuntime+JniValueManager.PeekValue вызовов. (Унаследовано от IJavaPeerable) |
Until(ITemporal, ITemporalUnit) |
Вычисляет время до другого темпорального периода с точки зрения указанной единицы измерения. |
With(ITemporalAdjuster) |
Возвращает скорректированный объект того же типа, что и данный объект с выполненной корректировкой. |
With(ITemporalField, Int64) |
Возвращает объект того же типа, что и этот объект с указанным измененным полем. |
Методы расширения
JavaCast<TResult>(IJavaObject) |
Выполняет преобразование типа, проверенное средой выполнения Android. |
JavaCast<TResult>(IJavaObject) |
Интерфейс на уровне платформы, определяющий доступ для чтения и записи к темпоральным объектам, таким как дата, время, смещение или их комбинация. |
GetJniTypeName(IJavaPeerable) |
Интерфейс на уровне платформы, определяющий доступ для чтения и записи к темпоральным объектам, таким как дата, время, смещение или их комбинация. |