DateTimeFormatter.WithChronology(IChronology) Methode

[Android.Runtime.Register("withChronology", "(Ljava/time/chrono/Chronology;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithChronology(Java.Time.Chrono.IChronology? chrono);

[<Android.Runtime.Register("withChronology", "(Ljava/time/chrono/Chronology;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithChronology : Java.Time.Chrono.IChronology -> Java.Time.Format.DateTimeFormatter

Parameter

Gibt zurück

ein auf diesem Formatierer basierender Formatierer mit der angeforderten Außerkraftsetzungschronologie, nicht null

Attribute

RegisterAttribute

Hinweise

Gibt eine Kopie dieses Formatierers mit einer neuen Überschreibungschronologie zurück.

Dadurch wird ein Formatierer mit einem ähnlichen Zustand wie dieser Formatierer zurückgegeben, jedoch mit dem Chronologiesatz außer Kraft gesetzt. Standardmäßig weist ein Formatierer keine Außerkraftsetzungschronologie auf, wobei null zurückgegeben wird.

Wenn eine Außerkraftsetzung hinzugefügt wird, sind alle datumsformatierten oder analysierten Daten betroffen.

Wenn das zeitliche Objekt ein Datum enthält, wird es bei der Formatierung in ein Datum in der Außerkraftsetzungschronologie konvertiert. Gibt an, ob das Zeitliche ein Datum enthält, wird durch Abfragen des ChronoField#EPOCH_DAY EPOCH_DAY Felds bestimmt. Alle Zeitzonen bleiben unverändert, es sei denn, sie werden überschrieben.

Wenn das zeitliche Objekt kein Datum enthält, aber ein oder ChronoField mehrere Datumsfelder enthält, wird ein DateTimeException Fehler ausgelöst. In allen anderen Fällen wird die Außerkraftsetzungschronologie zur zeitlichen Hinzugefügt, wobei jede vorherige Chronologie ersetzt wird, ohne das Datum/die Uhrzeit zu ändern.

Bei der Analyse müssen zwei verschiedene Fälle berücksichtigt werden. Wenn eine Chronologie direkt aus dem Text analysiert wurde, vielleicht weil DateTimeFormatterBuilder#appendChronologyId() sie verwendet wurde, hat diese Außerkraftsetzungschronologie keine Auswirkung. Wenn keine Zone analysiert wurde, wird diese Außerkraftsetzungschronologie verwendet, um die ChronoField Werte gemäß den Regeln zum Auflösen des Datums der Chronologie in ein Datum zu interpretieren.

Diese Instanz ist unveränderlich und von diesem Methodenaufruf nicht betroffen.

Java-Dokumentation für java.time.format.DateTimeFormatter.withChronology(java.time.chrono.Chronology).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.