ITemporal Schnittstelle

Definition

[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

Abgeleitet

Java.Time.Chrono.IChronoLocalDate

Java.Time.Chrono.IChronoLocalDateTime

Java.Time.Chrono.IChronoZonedDateTime

Java.Time.Instant

Java.Time.LocalDate

Mehr …

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable ITemporalAccessor IDisposable

Hinweise

Schnittstelle auf Frameworkebene, die den Lese-/Schreibzugriff auf ein zeitliches Objekt definiert, z. B. ein Datum, eine Uhrzeit, einen Offset oder eine Kombination dieser Objekte.

Dies ist der Basisschnittstellentyp für Datums-, Uhrzeit- und Offsetobjekte, die vollständig genug sind, um mit Plus- und Minuszeichen bearbeitet zu werden. Sie wird von diesen Klassen implementiert, die Informationen als TemporalField-Felder oder TemporalQuery-Abfragen bereitstellen und bearbeiten können. Lesen Sie TemporalAccessor die schreibgeschützte Version dieser Schnittstelle.

Die meisten Datums- und Uhrzeitinformationen können als Zahl dargestellt werden. Diese werden mit TemporalField der Zahl modelliert, die verwendet long wird, um große Werte zu verarbeiten. Jahr, Monat und Tag-für-Monat sind einfache Beispiele für Felder, aber sie enthalten auch Sofort- und Offsets. Siehe ChronoField den Standardsatz von Feldern.

Zwei Teile von Datums-/Uhrzeitinformationen können nicht durch Zahlen dargestellt werden, die java.time.chrono.Chronology-Chronologie und die Zeitzone java.time.ZoneId. Auf diese können Sie über #query(TemporalQuery) queries die statischen Methoden zugreifen, die für TemporalQuery.

Diese Schnittstelle ist eine Schnittstelle auf Frameworkebene, die nicht weit verbreitet im Anwendungscode verwendet werden sollte. Stattdessen sollten Anwendungen Instanzen konkreter Typen erstellen und übergeben, z LocalDate. B. . Dafür gibt es viele Gründe, von denen ein Teil davon ist, dass Implementierungen dieser Schnittstelle in anderen Kalendersystemen als ISO enthalten sein können. Eine umfassendere Erläuterung der Probleme finden Sie java.time.chrono.ChronoLocalDate unter .

<h2>Wann implementieren</h2>

Eine Klasse sollte diese Schnittstelle implementieren, wenn sie drei Kriterien erfüllt: <ul<>li>bietet Zugriff auf Datums-/Uhrzeit-/Offsetinformationen, da<TemporalAccessor> die Gruppe der Felder von der größten bis zur kleinsten <Position>zusammenhängend ist, sodass kein anderes Feld erforderlich ist, um den gültigen Wertebereich für die Felder zu definieren, die /ul dargestellt <werden.>

Vier Beispiele machen dies deutlich: <Ul><li>LocalDate implementiert diese Schnittstelle, da sie eine Reihe von Feldern darstellt, die von Tagen bis für immer zusammenhängend sind und keine externen Informationen benötigen, um die Gültigkeit jedes Datums zu bestimmen. Daher ist es in der Lage, Plus/Minus richtig zu implementieren. <li>LocalTime implementiert diese Schnittstelle, da sie eine Reihe von Feldern darstellt, die von Nanos bis innerhalb von Tagen zusammenhängend sind und keine externen Informationen zur Bestimmung der Gültigkeit erfordern. Sie ist in der Lage, Plus/Minus richtig zu implementieren, indem sie um den Tag herum umschließen. <li>MonthDay, die Kombination aus Monat und Tag des Monats, implementiert diese Schnittstelle nicht. Während die Kombination zusammenhängend ist, verfügt die Kombination von Tagen bis zu Monaten innerhalb von Jahren nicht über ausreichende Informationen, um den gültigen Wertebereich für den Tag des Monats zu definieren. Daher ist es nicht in der Lage, Plus/Minus richtig zu implementieren. <li>Die Kombination aus Wochentag und Monat ("Freitag der 13.") sollte diese Schnittstelle nicht implementieren. Es stellt keinen zusammenhängenden Satz von Feldern dar, da Tage bis Wochen Tage mit Monaten überlappen. </ul>

Hinzugefügt in 1.8.

Java-Dokumentation für java.time.temporal.Temporal.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Eigenschaften

Methoden

Erweiterungsmethoden

Gilt für: