Freigeben über


DateTimeFormatter Klasse

Definition

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

[Android.Runtime.Register("java/time/format/DateTimeFormatter", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class DateTimeFormatter : Java.Lang.Object
[<Android.Runtime.Register("java/time/format/DateTimeFormatter", ApiSince=26, DoNotGenerateAcw=true)>]
type DateTimeFormatter = class
    inherit Object
Vererbung
DateTimeFormatter
Attribute

Hinweise

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

Diese Klasse stellt den Haupteinstiegspunkt der Anwendung zum Drucken und Analysieren bereit und bietet allgemeine Implementierungen von : ul>li Unter Verwendung vordefinierter Konstanten, wie #ISO_LOCAL_DATE<z. B. /li>><Li Unter Verwendung von Musterbuchstaben, zuuuu-MMM-dd<. B. /li li><>Unter Verwendung lokalisierter Formatvorlagen, zlong. B. /<mediumli<>/ul><<DateTimeFormatter>

Komplexere Formatierer werden von DateTimeFormatterBuilder DateTimeFormatterBuilder.

Die wichtigsten Datum-Uhrzeit-Klassen stellen zwei Methoden bereit: eine für die Formatierung, format(DateTimeFormatter formatter)und eine für die Analyse. parse(CharSequence text, DateTimeFormatter formatter)

Beispiel: <Blockquote>

LocalDate date = LocalDate.now();
             String text = date.format(formatter);
             LocalDate parsedDate = LocalDate.parse(text, formatter);

</blockquote>

Zusätzlich zum Format können Formatierer mit dem gewünschten Gebietsschema, der Chronologie, der ZoneId und DecimalStyle erstellt werden.

Die #withLocale withLocale Methode gibt einen neuen Formatierer zurück, der das Gebietsschema überschreibt. Das Gebietsschema wirkt sich auf einige Aspekte der Formatierung und Analyse aus. Beispielsweise stellt der #ofLocalizedDate ofLocalizedDate Formatierer einen Formatierer bereit, der das gebietsschemaspezifische Datumsformat verwendet.

Die #withChronology withChronology Methode gibt einen neuen Formatierer zurück, der die Chronologie überschreibt. Wenn der Wert für Datum und Uhrzeit überschrieben wird, vor der Formatierung in die Chronologie konvertiert. Während der Analyse wird der Datum-Uhrzeit-Wert in die Chronologie konvertiert, bevor er zurückgegeben wird.

Die #withZone withZone Methode gibt einen neuen Formatierer zurück, der die Zone überschreibt. Wenn der Wert für Datum und Uhrzeit überschrieben wird, wird er vor der Formatierung in eine ZonedDateTime-Eigenschaft mit der angeforderten ZoneId konvertiert. Während der Analyse wird die ZoneId angewendet, bevor der Wert zurückgegeben wird.

Die #withDecimalStyle withDecimalStyle Methode gibt einen neuen Formatierer zurück, der die DecimalStyle. Die DecimalStyle-Symbole werden für die Formatierung und Analyse verwendet.

Einige Anwendungen müssen möglicherweise die ältere Format java.text.Format Klasse für die Formatierung verwenden. Die #toFormat() Methode gibt eine Implementierung von java.text.Format.

<h2 id="vordefinierte"Vordefinierte Formatter/h2><Table class="striped" style="text-align:left"><caption Vordefinierte Formatters</caption>><thead<>tr><th scope="col">Formatter</th th<>scope="col"Description</th th><scope="col">col">example</th<>/tr/thead<>tbody><tr>><< th scope="row"<>#ofLocalizedDate ofLocalizedDate(dateStyle)/th<>><td-Formatierer> mit Datumsformatvorlage aus dem Gebietsschema </td td><> '2011-12-03'</td<>/tr tr><<>th scope="row">#ofLocalizedTime ofLocalizedTime(timeStyle)</th<>td> Formatter mit Zeitformat aus dem lokalen /<td>>< '10:15:30'</td<>/tr tr><><th scope="row"#ofLocalizedDateTime ofLocalizedDateTime(dateTimeStyle)<>/th<>td> Formatter mit einem Format für Datum und Uhrzeit aus dem Gebietsschema</td td td><> '3 Jun 2008 11:05:30'</td<>/tr tr tr<>><th scope="row"><#ofLocalizedDateTime ofLocalizedDateTime(dateStyle,timeStyle)/th><td> Formatter mit Datums- und Uhrzeitformatvorlagen aus dem Gebietsschema </td><td> '3 Jun 2008 11:05'</td></tr tr><<>th scope="row"<#BASIC_ISO_DATE>/th><td>Basic ISO date </td'20111203<>>'</td<>/tr tr><><th scope="row" >#ISO_LOCAL_DATE</th>td> ISO Local Date /td'2011-12-03><>'</td></tr tr tr><th scope="row"<>#ISO_OFFSET_DATE/th><td> ISO Date <with offset </td td'2011-12-03><>+01:00'</td<>/tr<>tr<><>th scope="row"#ISO_DATE<>/th<>td> ISO Date with or without offset </td><' td '>< 2011-12-03+01:00'; '2011-12-03'</td<>/tr tr><><th scope="row"#ISO_LOCAL_TIME></th<>td> Time without offset </td'10<>>:15:30'</td<>/tr><tr><th scope="row"><#ISO_OFFSET_TIME/th<>td> Time with offset </td td'10><>:15:30+01:00'</td<>/tr tr<>><th scope="row">/th><td> Time with or without offset </td'10><>:15:30+01:00';#ISO_TIME< '10:15:30'</td></tr tr<<>>th scope="row"#ISO_LOCAL_DATE_TIME<>/th<>td> ISO Local Date and Time </td'2011-12-03T10>><:15:30'</t d></tr tr><<>th scope="row"<#ISO_OFFSET_DATE_TIME>/th><td> Date Time with Offset </td'2011-12-03T10><>:15:30+01:00'</td></tr tr th><>< scope="row">#ISO_ZONED_DATE_TIME</th<>td Zoned> Date Time </td'2011-12-03T10<>>:15:30+01:00[Europe/Paris]'</td></tr tr tr><<>th scope="row"<#ISO_DATE_TIME>/td<>> Datum und Uhrzeit mit ZoneId </td'2011-12-03T10><>:15:30+01:00[Europe/Paris]'</td<>/tr tr tr>><<th scope="row"/>#ISO_ORDINAL_DATE< td> Jahr und Tag des Jahres </td'2012-337><>'</td></tr tr tr><><th scope="row"><#ISO_WEEK_DATE/th><td> Jahr und Woche </td'2012-W48><> -6'</td></tr tr><<>th scope="row"#ISO_INSTANT<>/th<>td> Date and Time of an Instant </td td'2011-12-03T10>><:15:30Z'><</Td></tr tr>><<th scope="row"<#RFC_1123_DATE_TIME>/th><td> RFC 1123 / RFC 822 </td td'Tue<>>, 3 Jun 2008 11:05:30 GMT'</td<>/tr<>/tbody></table>

<h2 id="patterns">Patterns for Formatting and Parsing</h2> Patterns are based on a simple sequence of letters and symbols. Ein Muster wird verwendet, um einen Formatierer mit den #ofPattern(String) und #ofPattern(String, Locale) den Methoden zu erstellen. Wird z. B "d MMM uuuu" . 2011-12-03 als "3  Dec  2011'. Ein aus einem Muster erstelltes Formatierer kann so oft wie nötig verwendet werden, es ist unveränderlich und threadsicher.

Beispiel: <Blockquote>

LocalDate date = LocalDate.now();
             DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy MM dd");
             String text = date.format(formatter);
             LocalDate parsedDate = LocalDate.parse(text, formatter);

</blockquote>

Alle Buchstaben "A" bis "Z" und "a" bis "z" sind als Musterbuchstaben reserviert. Die folgenden Musterbuchstaben sind definiert: <Table class="striped"><caption>Pattern Letters and Symbols</caption><thead><tr><th scope="col">Symbol</th th><scope="col">Meaning</th th><scope="col">Presentation</th th<>scope="col">examples</th></thead><tbody><tr><th scope="row">G</th<>td era</td>><td>text</td><>AD; Nach Christus; A</td><tr><th scope="row">u</th<>td>year</td>year/td><td year</td td>><2004; 04</td><tr><th scope="row">y</th<>td>year-of-era</td td>jahr</td><<>td>2004; 04</td><tr><th scope="row">D</th<>td>day-of-year</td td<>number</td>><td>189</td<>tr><th scope="row">M/L</th><td>month-of-year</td td>><number/text</td td><>7; 07; Jul; Juli; J</td><tr><th scope="row">d</th<>td>day-of-month</td td><>number</td td><>10</td<>tr><th scope="row">g</th><td>modified-julian-day</td td><>number</td td<>td 2451334</td>>

<tr><th scope="row">Q/q</th><td>quartal-of-year</td td><>number/text</td td><>3; 03; Q3; 3. Quartal</td<>tr><th scope="row">Y</th><td>week-based-year</td td>><jahr</td><td td>1996; 96</td<>tr><th scope="row">w</th<>td>week-of-week-based-year</td td<>>number</td<>td td>27</td<>tr><th scope="row">W</th><td>week-of-month</td><td>number</td><td>4</td><tr><th scope="row">E</th<>td>day-of-week</td><td>text</td td><>Tue; Dienstag; T</td><tr><th scope="row">e/c</th<>td>lokalisierter Wochentag</td td td><>zahl/text</td td><>2; 02; Di; Dienstag; T</td><tr><th scope="row">F</th<>td>day-of-week-in-month</td td>><number</td<>td td>3</td>

<tr><th scope="row">a</th<>td>am-pm-of-day</td td><>text</td td td><>PM</td tr th scope="row"h/th td clock-hour-of-am-pm (1--td><tr><th scope="row">h</th<>td>clock-hour-of-am-pm 12)</td<>td>number</td><td>12</td><tr><th scope="row">K</th<>td>hour-of-am-pm (0-11)</td><td>number</td td t><>0</td<>tr><th scope="row">k</th><td>clock-hour-of-day (1-24)</td td td>><number</td<>>24</td>

<tr><th scope="row">H</th<>td>hour-of-day (0-23)</td td><>number</td td<>>0</td><tr><th scope="row">m</th><td td>minute-of-hour</td<>td>number</td<>td>30</td<>tr><th scope="row">s</th<>td>second-of-minute</td><td>number</td td td><>55</Td><tr><th scope="row">S</th><td td>fraction-of-second</td td>><< td><td td>978</td><tr><th scope="row">A</th<>td>milli-of-day</td td<>>td number</td><td>1234</td><tr><th scope="row">n</th<>td>nano-of-second</td<>td td>number/td<> td number</tdtd>987654321</td<>tr><th scope="row">N</th><td>nano-of-day</td td>><number</td<>td td>1234000000</td>

<tr><th scope="row">V</th<>td>zeitzone ID</td td>><zone-id</td td><>America/Los_Angeles; Z; -08:30</td<>tr><th scope="row">v</th<>td>generic time-zone name</td><td>zone-name</td td><>Pacific Time; PT</td><tr><th scope="row">z</th><td>time-zone name</td td><>zone-name</td td><>Pacific Standard Time; PST</td><tr><th scope="row">O</th<>td>localized zone-offset</td<>td>offset-O</td td><>GMT+8; GMT+08:00; UTC-08:00</td<>tr><th scope="row">X</th><td>zone-offset 'Z' für null</td<>td>offset-X</td td><>Z; -080; -0830; -08:30; -083015; -08:30:15</td><tr><th scope="row">x</th<>td>zone-offset/td><td>offset-x<</td td<>td>+0000; -0830; -08:30; -083015; -08:30:15</td><tr><th scope="row">Z</th><td>zone-offset</td><td>offset-Z</td td><>+0000; -0800; -08:00</td>

<tr><th scope="row">p</th<>td>pad next</td td><>pad modifier</td td><>1</td>

<tr><th scope="row">/<th<>td>escape for text</td<>td td>delimiter</td td td<><> tr<><>th scope="row"'>'</th<>td>td single quote</<>td td td>literal</td td td><>'</td<>tr><th scope="row">[</th><td td>optional section start</td><td></td tr><><><><th scope="row">]</th>td>optional section end</td><td></td<>td/td<><> tr><th scope="row">#</th><td td>reserved for future use</td><td>< td/><<>><td>< tr th scope="row">{</th><td td>reserved for future use</td<>td/td>< td></td<>tr><th scope="row">}</th<>td><<>reserviert für zukünftige Verwendung</td><td></td><td/td/td></tbody>><</table>

Die Anzahl der Musterbuchstaben bestimmt das Format.

<b>Text</b>: Die Textformatvorlage wird basierend auf der Anzahl der verwendeten Musterbuchstaben bestimmt. Weniger als 4 Musterbuchstaben verwenden die TextStyle#SHORT short form. Genau 4 Musterbuchstaben verwenden die TextStyle#FULL full form. Genau 5 Musterbuchstaben verwenden die TextStyle#NARROW narrow form. Musterbuchstaben "L", "c" und "q" geben die eigenständige Form der Textformatvorlagen an.

<b>Zahl</b>: Wenn die Anzahl der Buchstaben eins ist, wird der Wert mit der minimalen Anzahl von Ziffern und ohne Abstand ausgegeben. Andernfalls wird die Anzahl der Ziffern als Breite des Ausgabefelds verwendet, wobei der Wert ggf. mit Nullen aufgefüllt wird. Die folgenden Musterbuchstaben weisen Einschränkungen für die Anzahl der Buchstaben auf. Es kann nur ein Buchstabe von "c" und "F" angegeben werden. Bis zu zwei Buchstaben von 'd', 'H', 'h', 'K', 'k', 'm' und 's' können angegeben werden. Bis zu drei Buchstaben von "D" können angegeben werden.

<b>Zahl/Text</b>: Wenn die Anzahl der Musterbuchstaben 3 oder größer ist, verwenden Sie die obigen Textregeln. Verwenden Sie andernfalls die obigen Regeln für Zahlen.

<b>Bruch</b>: Gibt das Nano-of-Second-Feld als Bruchteil der Sekunde aus. Der Nano-of-Second-Wert hat neun Ziffern, daher beträgt die Anzahl der Musterbuchstaben von 1 bis 9. Wenn er kleiner als 9 ist, wird der Nano-of-Second-Wert abgeschnitten, wobei nur die wichtigsten Ziffern ausgegeben werden.

<b>Jahr</b>: Die Anzahl der Buchstaben bestimmt die Mindestfeldbreite, unter der Abstand verwendet wird. Wenn die Anzahl der Buchstaben zwei ist, wird ein DateTimeFormatterBuilder#appendValueReduced reduced zweistelliges Formular verwendet. Beim Drucken werden die zwei äußersten rechten Ziffern ausgegeben. Bei der Analyse wird der Basiswert 2000 verwendet, was zu einer Jahreszahl im Bereich von 2000 bis einschließlich 2099 führt. Wenn die Anzahl der Buchstaben kleiner als vier (aber nicht zwei) ist, wird das Vorzeichen nur für negative Jahre pro Jahr SignStyle#NORMALausgegeben. Andernfalls wird das Zeichen ausgegeben, wenn die Padbreite überschritten wird, wie pro SignStyle#EXCEEDS_PAD.

<b>ZoneId</b>: Dies gibt die Zeitzonen-ID aus, z. B. "Europe/Paris". Wenn die Anzahl der Buchstaben zwei ist, wird die Zeitzonen-ID ausgegeben. Alle anderen Buchstabenanzahl wird IllegalArgumentExceptionausgelöst.

<b>Zonennamen</b>: Dadurch wird der Anzeigename der Zeitzonen-ID ausgegeben. Wenn der Musterbuchstabe "z" lautet, ist die Ausgabe der Name der Zone für sommersparfähiges Licht. Wenn nicht genügend Informationen vorhanden sind, um festzustellen, ob DST gilt, wird der Name verwendet, der Sommerzeit wird ignoriert. Wenn die Anzahl der Buchstaben eins, zwei oder drei ist, wird der Kurzname ausgegeben. Wenn die Anzahl der Buchstaben vier beträgt, wird der vollständiger Name ausgegeben. Fünf oder mehr Buchstaben werfen IllegalArgumentException.

Wenn der Musterbuchstabe "v" lautet, stellt die Ausgabe den Zonennamen bereit, der sommerzeitsparend ignoriert wird. Wenn die Anzahl der Buchstaben eins ist, wird der Kurzname ausgegeben. Wenn die Anzahl der Buchstaben vier beträgt, wird der vollständiger Name ausgegeben. Zwei, drei und fünf oder mehr Buchstaben werfen IllegalArgumentException.

<b>Offset X und x</b>: Dies formatiert den Offset basierend auf der Anzahl der Musterbuchstaben. Ein Buchstabe gibt nur die Stunde aus, z. B. "+01", es sei denn, die Minute ist nicht null, in diesem Fall wird auch die Minute ausgegeben, z. B. "+0130". Zwei Buchstaben geben die Stunde und Minute ohne Doppelpunkt aus, z. B. "+0130". Drei Buchstaben geben die Stunde und Minute mit einem Doppelpunkt aus, z. B. "+01:30". Vier Buchstaben geben die Stunde und Minute und optionale Sekunde ohne Doppelpunkt aus, z. B. "+013015". Fünf Buchstaben geben die Stunde und Minute und optionale Sekunde mit einem Doppelpunkt aus, z. B. "+01:30:15". Sechs oder mehr Buchstaben werfen IllegalArgumentException. Der Musterbuchstabe "X" (Großbuchstabe) gibt "Z" aus, wenn der zu ausgabede Offset null wäre, während der Musterbuchstaben "x" (Kleinbuchstabe) "+000", "+0000" oder "+00:00" ausgegeben wird.

<b>Offset O</b>: Bei einem Offset ungleich Null formatiert dies den lokalisierten Offset basierend auf der Anzahl der Musterbuchstaben. Ein Buchstabe gibt die Kurzform "TextStyle#SHORT" des lokalisierten Offsets aus, der lokalisierten Offsettext, z. B. "GMT", mit Stunde ohne vorangestellte Null, optional 2-stellige Minute und Sekunde, wenn nicht Null und Doppelpunkt, z. B. "GMT+8", ausgegeben wird. Vier Buchstaben geben das vollständige TextStyle#FULL-Formular aus, das lokalisierten Offsettext, z. B. "GMT, mit 2-stelligem Stunden- und Minutenfeld, optionales zweites Feld, wenn ungleich Null und Doppelpunkt, z. B. "GMT+08:00", ausgegeben wird. Wenn der Offset null ist, wird nur lokalisierter Text ausgegeben. Alle anderen Buchstabenanzahl wird IllegalArgumentExceptionausgelöst.

<b>Offset Z</b>: Dies formatiert den Offset basierend auf der Anzahl der Musterbuchstaben. Ein, zwei oder drei Buchstaben geben die Stunde und Minute ohne Doppelpunkt aus, z. B. "+0130". Die Ausgabe lautet "+0000", wenn der Offset null ist. Vier Buchstaben geben den TextStyle#FULL-Format des lokalisierten Offsets aus, entspricht vier Buchstaben von Offset-O. Die Ausgabe ist der entsprechende lokalisierte Offsettext, wenn der Offset null ist. Bei fünf Buchstaben werden Stunden und Minuten und optional die Sekunden, wenn nicht 0 (null), mit Doppelpunkt ausgegeben. Es gibt "Z" aus, wenn der Offset null ist. Sechs oder mehr Buchstaben werfen IllegalArgumentException.

<b>Optionaler Abschnitt</b>: Die optionalen Abschnittsmarkierungen funktionieren genau wie Aufrufe DateTimeFormatterBuilder#optionalStart() und DateTimeFormatterBuilder#optionalEnd().

<b>Pad modifier</b>: Ändert das Muster, das unmittelbar folgt, um mit Leerzeichen zu aufgefüllt werden. Die Padbreite wird durch die Anzahl der Musterbuchstaben bestimmt. Dies ist identisch mit dem Aufrufen DateTimeFormatterBuilder#padNext(int).

So gibt z. B. "ppH" den auf der linken Seite aufgefüllten Stundenabstand mit Leerzeichen auf eine Breite von 2 aus.

Ein unbekannter Buchstabe ist ein Fehler. Alle nicht buchstabenfreien Zeichen, außer '[', ']', '{', '}', '#' und das einfache Anführungszeichen werden direkt ausgegeben. Trotzdem wird empfohlen, einzelne Anführungszeichen für alle Zeichen zu verwenden, die Sie direkt ausgeben möchten, um sicherzustellen, dass zukünftige Änderungen Ihre Anwendung nicht unterbrechen.

<h2 id="resolving">Resolving</h2> Parsing wird als zweistufiger Vorgang implementiert. Zunächst wird der Text mithilfe des vom Formatierer definierten Layouts analysiert, wobei ein Map Feld zu Wert, a ZoneId und a Chronologyerstellt wird. Zweitens werden <die analysierten Daten aufgelöst></em> durch Validieren, Kombinieren und Vereinfachen der verschiedenen Felder in nützlichere Felder.

Fünf Analysemethoden werden von dieser Klasse bereitgestellt. Vier davon führen die Analyse- und Auflösungsphasen aus. Die fünfte Methode führt #parseUnresolved(CharSequence, ParsePosition)nur die erste Phase aus, sodass das Ergebnis nicht aufgelöst wird. Daher handelt es sich im Wesentlichen um einen Vorgang auf niedriger Ebene.

Die Auflösungsphase wird durch zwei Parameter gesteuert, die für diese Klasse festgelegt werden.

Dies ResolverStyle ist eine Enumeration, die drei verschiedene Ansätze, streng, smart und lenient bietet. Die intelligente Option ist die Standardeinstellung. Sie kann mit #withResolverStyle(ResolverStyle).

Der #withResolverFields(TemporalField...) Parameter ermöglicht den Satz von Feldern, die vor dem Auflösen gefiltert werden sollen. Wenn der Formatierer beispielsweise ein Jahr, monat, tag-of-month und tag-of-year analysiert hat, gibt es zwei Ansätze zum Auflösen eines Datums: (Jahr + Monat + Tag des Monats) und (Jahr + Tag des Jahres). Die Auflösungsfelder ermöglichen die Auswahl einer der beiden Ansätze. Wenn keine Resolverfelder festgelegt sind, müssen beide Ansätze zum gleichen Datum führen.

Das Auflösen separater Felder, um ein vollständiges Datum und eine vollständige Uhrzeit zu bilden, ist ein komplexer Prozess, bei dem das Verhalten über eine Reihe von Klassen verteilt ist. Es folgt den folgenden Schritten: <ol><li>Die Chronologie wird bestimmt. Die Chronologie des Ergebnisses ist entweder die Chronologie, die analysiert wurde, oder wenn keine Chronologie analysiert wurde, ist sie die für diese Klasse festgelegte Chronologie, oder wenn dies null ist.IsoChronology <li>Die ChronoField Datumsfelder werden aufgelöst. Dies wird mithilfe von Chronology#resolveDate(Map, ResolverStyle). Dokumentation zur Feldauflösung befindet sich in der Implementierung von Chronology. <li>Die ChronoField Zeitfelder werden aufgelöst. Dies ist dokumentiert ChronoField und ist für alle Chronologien identisch. <li>Alle Felder, die nicht ChronoField verarbeitet werden. Dies wird mithilfe von TemporalField#resolve(Map, TemporalAccessor, ResolverStyle). Dokumentation zur Feldauflösung befindet sich in der Implementierung von TemporalField. <li>Die ChronoField Felder für Datum und Uhrzeit werden erneut aufgelöst. Auf diese Weise können Felder in Schritt 4 Werte erzeugen ChronoField und in Datums- und Uhrzeitangaben verarbeitet werden. <li>A LocalTime wird gebildet, wenn mindestens eine Stunde von Tag verfügbar ist. Dazu müssen Standardwerte für Minute, Sekunde und Bruchteil der Sekunde bereitgestellt werden. <li>Alle verbleibenden nicht aufgelösten Felder werden mit jedem Datum und/oder einer Uhrzeit, die aufgelöst wurde, kreuzgecheckt. Daher würde eine frühere Phase (Jahr + Monat + Tag des Monats) zu einem Datum auflösen, und diese Phase würde überprüfen, ob der Wochentag für das Datum gültig war. <li>Wenn eine #parsedExcessDays() übermäßige Anzahl von Tagen analysiert wurde, wird sie dem Datum hinzugefügt, wenn ein Datum verfügbar ist. <li> Wenn ein zweites Feld vorhanden ist, aber LocalTime nicht analysiert wurde, stellt der Resolver sicher, dass Milli-, Mikro- und Nano-Sekunden-Werte verfügbar sind, um den Vertrag von ChronoField. Diese werden bei fehlendem Fehlen auf Null festgelegt. <li>Wenn sowohl Datum als auch Uhrzeit analysiert wurden und entweder ein Offset oder eine Zone vorhanden ist, wird das Feld ChronoField#INSTANT_SECONDS erstellt. Wenn ein Offset analysiert wurde, wird der Offset mit dem LocalDateTime zu bildenden Sofortigen kombiniert, wobei jede Zone ignoriert wird. Wenn eine ZoneId Analyse ohne Offset erfolgt ist, wird die Zone mit dem LocalDateTime Zusatz kombiniert, um die sofortige Verwendung der Regeln zu ChronoLocalDateTime#atZone(ZoneId)bilden. </ol>

Hinzugefügt in 1.8.

Java-Dokumentation für java.time.format.DateTimeFormatter.

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

BasicIsoDate

Der ISO-Datumsformatierer, der ein Datum ohne Offset formatiert oder analysiert, z. B. "20111203".

Chronology

Ruft die überschriebene Chronologie ab, die während der Formatierung verwendet werden soll.

Class

Gibt die Laufzeitklasse dieses Werts Objectzurück.

(Geerbt von Object)
DecimalStyle

Ruft den DecimalStyle ab, der während der Formatierung verwendet werden soll.

Handle

Das Handle für die zugrunde liegende Android-Instanz.

(Geerbt von Object)
IsoDate

Der ISO-Datumsformatierer, der ein Datum mit dem Offset formatiert oder analysiert, falls verfügbar, z. B. "2011-12-03" oder "2011-12-03+01:00".

IsoDateTime

Der ISO-ähnliche Datums-Uhrzeit-Formatierer, der eine Datums- und Uhrzeitangabe mit dem Offset und der Zone formatiert oder analysiert, falls verfügbar, wie "2011-12-03T10:15:30", "2011-12-03T10:15:30+01:00" oder "2011-12-03T10:15:30+01:00[Europa/Paris]".

IsoInstant

Der ISO-Sofortformatierer, der eine Instanz in UTC formatiert oder analysiert, z. B. "2011-12-03T10:15:30Z".

IsoLocalDate

Der ISO-Datumsformatierer, der ein Datum ohne Offset formatiert oder analysiert, z. B. "2011-12-03".

IsoLocalDateTime

Der ISO-Datum-Uhrzeit-Formatierer, der eine Datum-Uhrzeit ohne Offset formatiert oder analysiert, z. B. "2011-12-03T10:15:30".

IsoLocalTime

Der ISO-Zeitformatierer, der eine Zeit ohne Offset formatiert oder analysiert, z. B. "10:15" oder "10:15:30".

IsoOffsetDate

Der ISO-Datumsformatierer, der ein Datum mit einem Offset formatiert oder analysiert, z. B. "2011-12-03+01:00".

IsoOffsetDateTime

Der ISO-Datums-Uhrzeit-Formatierer, der eine Datum-Uhrzeit mit einem Offset formatiert oder analysiert, z. B. "2011-12-03T10:15:30+01:00".

IsoOffsetTime

Der ISO-Zeitformatierer, der eine Zeit mit einem Offset formatiert oder analysiert, z. B. "10:15+01:00" oder "10:15:30+01:00".

IsoOrdinalDate

Der ISO-Datumsformatierer, der das Ordinaldatum ohne Offset formatiert oder analysiert, z. B. "2012-337".

IsoTime

Der ISO-Zeitformatierer, der eine Zeit formatiert oder analysiert, wobei der Offset verfügbar ist, z. B. "10:15", "10:15:30" oder "10:15:30+01:00".

IsoWeekDate

Der ISO-Datumsformatierer, der das wochenbasierte Datum ohne Offset formatiert oder analysiert, z. B. "2012-W48-6".

IsoZonedDateTime

Der ISO-ähnliche Datums-Uhrzeit-Formatierer, der eine Datum-Uhrzeit mit Offset und Zone analysiert, z. B. "2011-12-03T10:15:30+01:00[Europa/Paris]".

JniIdentityHashCode

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

(Geerbt von Object)
JniPeerMembers

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

Locale

Ruft das Gebietsschema ab, das während der Formatierung verwendet werden soll.

PeerReference

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

(Geerbt von Object)
ResolverFields

Ruft die Resolverfelder ab, die während der Analyse verwendet werden sollen.

ResolverStyle

Ruft die Auflösungsformatvorlage ab, die während der Analyse verwendet werden soll.

Rfc1123DateTime

Der RFC-1123-Datums-Uhrzeit-Formatierer, z. B. "Di, 3. Juni 2008 11:05:30 GMT".

ThresholdClass

Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

(Geerbt von Object)
ThresholdType

Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

(Geerbt von Object)
Zone

Ruft die Überschreibungszone ab, die während der Formatierung verwendet werden soll.

Methoden

Clone()

Erstellt und gibt eine Kopie dieses Objekts zurück.

(Geerbt von Object)
Dispose()

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

(Geerbt von Object)
Dispose(Boolean)

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

(Geerbt von Object)
Equals(Object)

Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist.

(Geerbt von Object)
Format(ITemporalAccessor)

Formatiert ein Datum-Uhrzeit-Objekt mit diesem Formatierer.

FormatTo(ITemporalAccessor, IAppendable)

Formatiert ein Datum-Uhrzeit-Objekt in einen Appendable mit diesem Formatierer verwendeten Formatierer.

GetHashCode()

Gibt einen Hashcodewert für das Objekt zurück.

(Geerbt von Object)
JavaFinalize()

Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind.

(Geerbt von Object)
LocalizedBy(Locale)

Gibt eine Kopie dieses Formatierers mit lokalisierten Werten des Gebietsschemas, des Kalenders, des Dezimalformats und/oder der Zeitzone zurück, die werte in diesem Formatierer übergeordnet sind.

Notify()

Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet.

(Geerbt von Object)
NotifyAll()

Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten.

(Geerbt von Object)
OfLocalizedDate(FormatStyle)

Gibt ein gebietsschemaspezifisches Datumsformat für die ISO-Chronologie zurück.

OfLocalizedDateTime(FormatStyle)

Gibt einen gebietsschemaspezifischen Datum-Uhrzeit-Formatierer für die ISO-Chronologie zurück.

OfLocalizedDateTime(FormatStyle, FormatStyle)

Gibt ein gebietsschemaspezifisches Datums- und Uhrzeitformat für die ISO-Chronologie zurück.

OfLocalizedTime(FormatStyle)

Gibt ein gebietsschemaspezifisches Zeitformat für die ISO-Chronologie zurück.

OfPattern(String)

Erstellt einen Formatierer mit dem angegebenen Muster.

OfPattern(String, Locale)

Erstellt einen Formatierer mit dem angegebenen Muster und Gebietsschema.

Parse(ICharSequence)

Analysiert den Text vollständig, der ein zeitliches Objekt erzeugt.

Parse(ICharSequence, ITemporalQuery)

Analysiert den Text vollständig, der ein Objekt des angegebenen Typs erzeugt.

Parse(ICharSequence, ParsePosition)

Analysiert den Text mithilfe dieses Formatierers, wodurch die Kontrolle über die Textposition bereitgestellt wird.

Parse(String)

Analysiert den Text vollständig, der ein zeitliches Objekt erzeugt.

Parse(String, ITemporalQuery)

Analysiert den Text vollständig, der ein Objekt des angegebenen Typs erzeugt.

Parse(String, ParsePosition)

Analysiert den Text mithilfe dieses Formatierers, wodurch die Kontrolle über die Textposition bereitgestellt wird.

ParseBest(ICharSequence, ITemporalQuery[])

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

ParseBest(String, ITemporalQuery[])

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

ParsedExcessDays()

Eine Abfrage, die Zugriff auf die überzähligen Tage bietet, die analysiert wurden.

ParsedLeapSecond()

Eine Abfrage, die Zugriff darauf bietet, ob ein Schalt-Second analysiert wurde.

ParseUnresolved(ICharSequence, ParsePosition)

Analysiert den Text mithilfe dieses Formatierers, ohne das Ergebnis aufzulösen, das für erweiterte Anwendungsfälle vorgesehen ist.

ParseUnresolved(String, ParsePosition)

Analysiert den Text mithilfe dieses Formatierers, ohne das Ergebnis aufzulösen, das für erweiterte Anwendungsfälle vorgesehen ist.

SetHandle(IntPtr, JniHandleOwnership)

Legt die Handle-Eigenschaft fest.

(Geerbt von Object)
ToArray<T>()

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

(Geerbt von Object)
ToFormat()

Gibt diesen Formatierer als java.text.Format Instanz zurück.

ToFormat(ITemporalQuery)

Gibt diesen Formatierer als java.text.Format Instanz zurück, die mithilfe der angegebenen Abfrage analysiert wird.

ToString()

Gibt eine Zeichenfolgendarstellung des Objekts zurück.

(Geerbt von Object)
UnregisterFromRuntime()

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

(Geerbt von Object)
Wait()

Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em> oder <em>unterbrochen</em>.<><

(Geerbt von Object)
Wait(Int64)

Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist.

(Geerbt von Object)
Wait(Int64, Int32)

Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist.

(Geerbt von Object)
WithChronology(IChronology)

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

WithDecimalStyle(DecimalStyle)

Gibt eine Kopie dieses Formatierers mit einem neuen DecimalStyle zurück.

WithLocale(Locale)

Gibt eine Kopie dieses Formatierers mit einem neuen Gebietsschema zurück.

WithResolverFields(ICollection<ITemporalField>)

Gibt eine Kopie dieses Formatierers mit einer neuen Gruppe von Auflösungsfeldern zurück.

WithResolverFields(ITemporalField[])

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

WithResolverStyle(ResolverStyle)

Gibt eine Kopie dieses Formatierers mit einer neuen Auflösungsformatvorlage zurück.

WithZone(ZoneId)

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

Explizite Schnittstellenimplementierungen

IJavaPeerable.Disposed()

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

(Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

(Geerbt von Object)
IJavaPeerable.Finalized()

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

(Geerbt von Object)
IJavaPeerable.JniManagedPeerState

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

(Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

(Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

(Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

(Geerbt von Object)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)

Führt eine android-laufzeitgecheckte Typkonvertierung aus.

JavaCast<TResult>(IJavaObject)

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

GetJniTypeName(IJavaPeerable)

Formatierer für das Drucken und Analysieren von Datums-/Uhrzeitobjekten.

Gilt für: