DateTimeFormatter Klasse

Referenz

Definition

Namespace:: Java.Time.Format

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Formatierer zum 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: Object

Object
DateTimeFormatter

Attribute: RegisterAttribute

Hinweise

Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten.

Diese Klasse stellt den Standard Einstiegspunkt für das Drucken und Analysieren der Anwendung bereit und stellt gängige Implementierungen von DateTimeFormatterbereit: <ul<>li>Verwenden vordefinierter Konstanten, z<#ISO_LOCAL_DATE. B. /li><li>Verwenden von Musterbuchstaben, zuuuu-MMM-dd<. B. /li<>li Li>Using localized styles, wie medium<long or /li></ul>

Komplexere Formatierungsprogramme werden von DateTimeFormatterBuilder DateTimeFormatterBuilderbereitgestellt.

Die Standard Datum-Uhrzeit-Klassen bieten zwei Methoden: 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 gewünschtem Gebietsschema, Chronologie, ZoneId und DecimalStyle erstellt werden.

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

Die #withChronology withChronology -Methode gibt einen neuen Formatierer zurück, der die Chronologie außer Kraft setzt. Beim Überschreiben wird der Datum-Uhrzeit-Wert 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 außer Kraft setzt. Beim Überschreiben wird der Datums-Uhrzeit-Wert vor der Formatierung in zonedDateTime 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 das DecimalStyleüberschreibt. Die DecimalStyle-Symbole werden zum Formatieren und Analysieren 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 zurück java.text.Format.

<h2 id="vordefinierte">Vordefinierte Formatters</h2><table class="striped" style="text-align:left"><Untertitel> Predefined Formatters</Untertitel>< thead><tr><th scope="col">Formatter</th<>th scope="col"Description/th th scope="col">Description</th<>th scope="col">Example</th<>/tr></thead><Tbody><tr><th scope="row"<>#ofLocalizedDate ofLocalizedDate(dateStyle)/th<>td> Formatter with date style from the locale </td><td> '2011-12-03'/td></<tr><tr><th scope="row"<#ofLocalizedTime ofLocalizedTime(timeStyle)>/th<>td> Formatter with time style from the locale </td td><> '10:15:30'</td<>/tr><tr><tr th scope="row"<#ofLocalizedDateTime ofLocalizedDateTime(dateTimeStyle)>/th><td td> Formatierer mit einem Format für Datum und Uhrzeit aus dem Gebietsschema</td<>td td> '3 Jun 2008 11:05:30'</td></tr><tr><th scope="row"#ofLocalizedDateTime ofLocalizedDateTime(dateStyle,timeStyle)></th><td> Formatter mit Datums- und Uhrzeitformaten aus dem Gebietsschema </td<>td> '3 Jun 2008 11:05'</td<>/tr><tr><tr th scope="row"<>#BASIC_ISO_DATE/th><td td>Basic ISO date </td><td td'> 20111203'/<td<>/tr<>tr><th scope="row"#ISO_LOCAL_DATE></th<>td> ISO Local Date </td td td'2011-12-03<>>'/<td<>/tr<>tr<>th bereich="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 Datum mit oder ohne Offset </td><td> '2011-12-03+01:00'; '2011-12-03'</td></tr><tr<>tr th scope="row"#ISO_LOCAL_TIME<>/th><td> Time without offset </td td td'10<>>:15:30'</td/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">#ISO_TIME</th><td> Time with or without offset </td td><td'10>:15:30+01:00'; '10:15:30'</td<>/tr><tr><tr th scope="row"<>#ISO_LOCAL_DATE_TIME/th<>td> ISO Local Date and Time </td td td'2011-12-03T10><>:15:30'</t d<>/tr><tr<>th scope="row"#ISO_OFFSET_DATE_TIME<>/th><td> Date Time with Offset </td td><td'2011-12-03T10>:15:30+01:00'</td<>/tr<>tr th>< scope="row">#ISO_ZONED_DATE_TIME</th<>td> Zoned Date Time </td td'2011-12-03T10<>>:15:30+01:00[Europe/Paris]'</td<>/tr><tr<>th scope="row"<>#ISO_DATE_TIME/th><td> Datum und Uhrzeit mit ZoneId </td td><td'2011-12-03T10>:15:30+01:00[Europe/Paris]'</td></tr<>tr<>th scope="row"/>#ISO_ORDINAL_DATE< th><td> Year and day of year </td td><td'2012-337>'</td></tr><tr><tr th scope="row"><#ISO_WEEK_DATE/th><td> Year and Week </td td td'2012-W48><> -6'/<td></tr><tr<>tr th scope="row"><#ISO_INSTANT/th><td> Datum und Uhrzeit eines Instant </td 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<>td'Tue>, 3 Jun 2008 11:05:30 GMT'</td<>/tr<>/tbody></table>

<h2 id="patterns"Patterns">Patterns for Formatierung and Parsing</h2> Patterns basieren auf einer einfachen Sequenz von Buchstaben und Symbolen. Ein Muster wird verwendet, um mithilfe der #ofPattern(String) Methoden und #ofPattern(String, Locale) einen Formatierer zu erstellen. Formatieren Sie beispielsweise "d MMM uuuu" 2011-12-03 als '3 Dez 2011'. Ein aus einem Muster erstelltes Formatierer kann so oft wie nötig verwendet werden, 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"><Untertitel> Pattern Letters and Symbols</Untertitel<> 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><td>text</td td>><AD; Anno Domini; A</td><tr><th scope="row">u</th<>td>year</td><td year</td>td jahr/td td><td>2004; 04</td><tr><th scope="row">y</th><td>year-of-era</td><td>year</td 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; Juli; Juli; J</td><tr><th scope="row">d</th><td>day-of-month</td><td<> number/td<>td td>10</td<>tr><th scope="row">g</th><td>modified-julian-day</td><td>number</td td<>>2451334</td>

<tr><th scope="row">Q/q</th><td>quartal-of-year</td><td>number/text</td td td>><3; 03; Q3; 3. Quartal</td><tr><th scope="row">Y</th><td>week-based-year</td td><>year</td td<>>1996; 96</td<>tr><th scope="row">w</th<>td>Week-of-week-based-year</td<>td td>number</td<>td>27</td<>tr><th scope="row">W</th><td>Week-of-Month</td><td>number</td><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>><number/text</td td td><>2; 02; Tue; 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- 12)</td><td td>number</td<>td>12</td<>tr><th scope="row">K</th<>td>hour-of-am-pm (0-11)</td td><td>number</td td><td>0</td<>tr><th scope="row">k</th<>td>clock-hour-of-day (1-24)</td td>><number</td td<>td>24</td>

<tr><th scope="row">H</th<>td>Stunde des Tages (0-23)</td td<>td>number</td><td>0</td<>tr><th scope="row">m</th><td>minute-of-hour</td><td td>number</td<>td td>30</td<>tr><th scope="row">s</th<>td>second-of-minute</td td>><number</td td><>55</Td><tr><th scope="row">S</th><td td>fraction-of-second</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>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>zeitzonen-ID</td><td>zone-id</td td><>America/Los_Angeles; Z; -08:30</td<>tr><th scope="row">v</th><td>generischer Zeitzonenname</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' for zero</td td><td>offset-X</td td><>Z; -08; -0830; -08:30; -083015; -08:30:15</td><tr><th scope="row">x</th><td>zone-offset</td td>><offset-x</td td>><+0000; -08; -0830; -08:30; -083015; -08:30:15</td><tr><th scope="row">Z</th<>td>zone-offset</td td>><offset-Z</td td><td>+0000; -0800; -08:00</td>

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

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

Die Anzahl der Musterbuchstaben bestimmt das Format.

<b>Text</b>: Die Textart wird basierend auf der Anzahl der verwendeten Musterbuchstaben bestimmt. Weniger als 4 Musterbuchstaben verwenden den TextStyle#SHORT short form. Genau vier Musterbuchstaben verwenden den TextStyle#FULL full form. Genau 5 Musterbuchstaben verwenden den TextStyle#NARROW narrow form. Die Musterbuchstaben "L", "c" und "q" geben die eigenständige Form der Textarten 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. Das folgende Muster von Buchstaben hat Einschränkungen für die Anzahl der Buchstaben. Es kann nur ein Buchstabe von "c" und "F" angegeben werden. Es können bis zu zwei Buchstaben von "d", "H", "h", "K", "k", "m" und "s" angegeben werden. Es können bis zu drei Buchstaben "D" angegeben werden.

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

<b>Fraction</b>: Gibt das Nano-of-Second-Feld als Sekundenbruchteil aus. Der Nano-of-Second-Wert hat neun Ziffern, sodass die Anzahl der Musterbuchstaben zwischen 1 und 9 liegt. 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 mindeste Feldbreite, unter der der Abstand verwendet wird. Wenn die Anzahl der Buchstaben zwei ist, wird eine DateTimeFormatterBuilder#appendValueReduced reduced zweistellige Form 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 Zeichen nur für negative Jahre gemäß SignStyle#NORMALausgegeben. Andernfalls wird das Zeichen ausgegeben, wenn die Padbreite gemäß überschritten SignStyle#EXCEEDS_PADwird.

<b>ZoneId</b>: Gibt die Zeitzonen-ID aus, z. B. "Europa/Paris". Wenn die Anzahl der Buchstaben zwei ist, wird die Zeitzonen-ID ausgegeben. Jede andere Anzahl von Buchstaben löst aus IllegalArgumentException.

<b>Zonennamen</b>: Gibt den Anzeigenamen der Zeitzonen-ID aus. Wenn der Musterbuchstabe "z" lautet, ist die Ausgabe der Name der Sommerzeitzone. Wenn nicht genügend Informationen vorhanden sind, um zu bestimmen, ob die Sommerzeit gilt, wird der Name verwendet, der die Sommerzeit 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 lösen aus IllegalArgumentException.

Wenn der Musterbuchstabe "v" ist, gibt die Ausgabe den Zonennamen an, der die Sommerzeit ignoriert. 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 lösen aus IllegalArgumentException.

<b>Offset X und x</b>: Hier wird der Offset basierend auf der Anzahl der Musterbuchstaben formatiert. Ein Buchstabe gibt nur die Stunde aus, z. B. "+01", es sei denn, die Minute ist ungleich Null. In diesem Fall wird auch die Minute ausgegeben, z. B. "+0130". Zwei Buchstaben geben die Stunde und die Minute ohne Doppelpunkt aus, z. B. "+0130". Drei Buchstaben geben die Stunde und die Minute mit einem Doppelpunkt aus, z. B. "+01:30". Vier Buchstaben geben die Stunde und Minute und optional die Sekunde ohne Doppelpunkt aus, z. B. "+013015". Fünf Buchstaben geben die Stunde und Minute und optional eine Sekunde mit einem Doppelpunkt aus, z. B. "+01:30:15". Sechs oder mehr Buchstaben lösen aus IllegalArgumentException. Der Musterbuchstabe "X" (Großbuchstaben) gibt "Z" aus, wenn der Ausgabeoffset null ist, während der Musterbuchstabe "x" (Kleinbuchstaben) "+00", "+0000" oder "+00:00" ausgibt.

<b>Offset O</b>: Bei einem Offset ungleich 0 (Null) formatiert dieser den lokalisierten Offset basierend auf der Anzahl der Musterbuchstaben. Ein Buchstabe gibt die Kurzform TextStyle#SHORT des lokalisierten Offsets aus, bei dem es sich um lokalisierten Offsettext handelt, z. B. "GMT", mit Stunde ohne führende Null, optional 2-stellige Minute und Sekunde, wenn nicht null, und Doppelpunkt, z. B. "GMT+8". Vier Buchstaben geben die Vollform TextStyle#FULL aus, bei der es sich um lokalisierten Offsettext handelt, z. B. "GMT" mit 2-stelligem Stunden- und Minutenfeld, optionales zweites Feld bei ungleich Null und Doppelpunkt, z. B. "GMT+08:00". Wenn der Offset null ist, wird nur lokalisierter Text ausgegeben. Jede andere Anzahl von Buchstaben löst aus IllegalArgumentException.

<b>Offset Z</b>: Hier wird der Offset basierend auf der Anzahl der Musterbuchstaben formatiert. Ein, zwei oder drei Buchstaben geben die Stunde und die Minute ohne Doppelpunkt aus, z. B. "+0130". Die Ausgabe lautet "+0000", wenn der Offset null ist. Mit vier Buchstaben wird die Vollform "TextStyle#FULL" des lokalisierten Offsets ausgegeben, was vier Buchstaben von Offset-O entspricht. 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 lösen aus IllegalArgumentException.

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

<b>Pad-Modifizierer</b>: Ändert das Muster, das unmittelbar folgt, um mit Leerzeichen aufgefüllt zu werden. Die Breite des Pads wird durch die Anzahl der Musterbuchstaben bestimmt. Dies entspricht dem Aufrufen DateTimeFormatterBuilder#padNext(int)von .

Beispielsweise gibt "ppH" die Tagesstunde auf der linken Seite mit Leerzeichen auf einer Breite von 2 aus.

Jeder nicht erkannte Buchstabe ist ein Fehler. Alle Zeichen ohne Buchstaben, außer "[", "]", "{", "}", "#" und das einfache Anführungszeichen werden direkt ausgegeben. Trotzdem wird empfohlen, einzelne Anführungszeichen um 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 is implemented as a two-phase operation. Zunächst wird der Text mithilfe des layouts analysiert, das vom Formatierer definiert wird, und erzeugt ein Map von feld zu wert, a ZoneId und a Chronology. Zweitens werden <die analysierten Daten aufgelöst></em>, indem die verschiedenen Felder überprüft, kombiniert und vereinfacht werden.

Diese Klasse stellt fünf Analysemethoden bereit. Vier davon führen sowohl die Analyse- als auch die Auflösungsphasen durch. 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 sind.

Ist ResolverStyle eine Enumeration, die drei verschiedene Ansätze bietet: streng, intelligent und nachsichtig. Die Smart-Option ist die Standardeinstellung. Sie kann mit #withResolverStyle(ResolverStyle)festgelegt werden.

Der #withResolverFields(TemporalField...) -Parameter ermöglicht, dass der Satz von Feldern, die aufgelöst werden, gefiltert wird, bevor das Auflösen beginnt. Wenn der Formatierer beispielsweise ein Jahr, einen Monat, einen Monat, einen Monat und einen Tag des Jahres analysiert hat, gibt es zwei Ansätze, um ein Datum aufzulösen: (Jahr + Monat + Tag des Monats) und (Jahr + Tag des Jahres). Mit den Resolverfeldern kann einer der beiden Ansätze ausgewählt werden. 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 auf eine Reihe von Klassen verteilt ist. Es folgt die folgenden Schritte: <ol><li>Die Chronologie wird bestimmt. Die Chronologie des Ergebnisses ist entweder die Chronologie, die analysiert wurde, oder wenn keine Chronologie analysiert wurde, handelt es sich um die für diese Klasse festgelegte Chronologie, oder wenn dies NULL ist, ist IsoChronologysie . <li>Die ChronoField Datumsfelder werden aufgelöst. Dies wird mithilfe von Chronology#resolveDate(Map, ResolverStyle)erreicht. Die Dokumentation zur Feldauflösung befindet sich in der Implementierung von Chronology. <li>Die ChronoField Zeitfelder werden aufgelöst. Dies ist auf ChronoField dokumentiert und ist für alle Chronologien identisch. <li>Alle Felder, die nicht ChronoField verarbeitet werden. Dies wird mithilfe von TemporalField#resolve(Map, TemporalAccessor, ResolverStyle)erreicht. Die Dokumentation zur Feldauflösung befindet sich in der Implementierung von TemporalField. <li>Die ChronoField Datums- und Uhrzeitfelder werden erneut aufgelöst. Dadurch können Felder in Schritt 4 Werte erzeugen ChronoField und zu Datums- und Uhrzeitangaben verarbeiten. <li>A LocalTime wird gebildet, wenn mindestens eine Tagesstunde verfügbar ist. Dies umfasst die Angabe von Standardwerten für Minute, Sekunde und Sekundenbruchteile. <li>Alle verbleibenden nicht aufgelösten Felder werden mit allen Datums- und/oder Uhrzeitdaten, die aufgelöst wurden, kreuzgeprüft. Daher würde eine frühere Phase (Jahr + Monat + Tag des Monats) zu einem Datum aufgelöst, und in dieser Phase würde überprüft, ob der Wochentag für das Datum gültig war. <li>Wenn eine #parsedExcessDays() übermäßig viele Tage analysiert wurde, wird sie dem Datum hinzugefügt, wenn ein Datum verfügbar ist. <li> Wenn ein zweites basiertes 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 ChronoFieldzu erfüllen. Diese werden auf 0 (null) festgelegt, wenn sie fehlen. <li>Wenn datum und 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 kombiniert, um den Moment zu bilden, wobei jede Zone ignoriert wird. Wenn ein ZoneId ohne einen Offset analysiert wurde, wird die Zone mit dem kombiniert, LocalDateTime um den Moment mithilfe der Regeln von ChronoLocalDateTime#atZone(ZoneId)zu bilden. </Ol>

In Version 1.8 hinzugefügt.

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

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In 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 überschreibende Chronologie ab, die während der Formatierung verwendet werden soll.
Class	Gibt die Laufzeitklasse dieses `Object`zurück. (Geerbt von Object)
DecimalStyle	Ruft den DecimalStyle ab, der während der Formatierung verwendet werden soll.
Handle	Das Handle zum zugrunde liegenden Android-instance. (Geerbt von Object)
IsoDate	Der ISO-Datumsformatierer, der ein Datum mit dem Offset formatiert oder analysiert, sofern verfügbar, z. B. "2011-12-03" oder "2011-12-03+01:00".
IsoDateTime	Der ISO-ähnliche Datums-Uhrzeit-Formatierer, der eine Datums-Uhrzeit mit dem Offset und der Zone formatiert oder analysiert, sofern verfügbar, z. B. "2011-12-03T10:15:30", "2011-12-03T10:15:30+01:00" oder "2011-12-03T10:15:30+01:00[Europe/Paris]".
IsoInstant	Der ISO-Sofortformatierer, der einen Moment 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-Datums-Uhrzeitformatierer, der datums-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 Datums-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 Ordnungsdatum ohne Offset formatiert oder analysiert, z. B. "2012-337".
IsoTime	Der ISO-Zeitformatierer, der eine Zeit formatiert oder analysiert, mit dem Offset, falls verfügbar, 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 datums-uhrzeit mit Offset und Zone formatiert oder analysiert, z. B. "2011-12-03T10:15:30+01:00[Europe/Paris]".
JniIdentityHashCode	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten. (Geerbt von Object)
JniPeerMembers	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten.
Locale	Ruft das Gebietsschema ab, das während der Formatierung verwendet werden soll.
PeerReference	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten. (Geerbt von Object)
ResolverFields	Ruft die Resolverfelder ab, die während der Analyse verwendet werden sollen.
ResolverStyle	Ruft den Resolverstil ab, der während der Analyse verwendet werden soll.
Rfc1123DateTime	Der RFC-1123-Datums-Uhrzeit-Formatierer, z. B. "Di, 3 Jun 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 überschreibende Zone 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 zum Drucken und Analysieren von Datums-/Uhrzeitobjekten. (Geerbt von Object)
Dispose(Boolean)	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten. (Geerbt von Object)
Equals(Object)	Gibt an, ob ein anderes Objekt diesem "gleich" ist. (Geerbt von Object)
Format(ITemporalAccessor)	Formatiert ein Datum-Uhrzeit-Objekt mit diesem Formatierer.
FormatTo(ITemporalAccessor, IAppendable)	Formatiert ein Datum-Uhrzeit-Objekt mithilfe dieses Formatierungsprogramms in ein `Appendable` .
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 feststellt, dass keine Verweise mehr auf das Objekt vorhanden sind. (Geerbt von Object)
LocalizedBy(Locale)	Gibt eine Kopie dieses Formatierungsprogramms mit lokalisierten Werten des Gebietsschemas, Kalenders, Dezimalformats und/oder Zeitzones zurück, die Werte in diesem Formatierer ersetzt haben.
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 unter Verwendung des angegebenen Musters und Gebietsschemas.
Parse(ICharSequence)	Analysiert vollständig den Text, der ein temporales Objekt erzeugt.
Parse(ICharSequence, ITemporalQuery)	Analysiert den Text vollständig und erzeugt ein Objekt des angegebenen Typs.
Parse(ICharSequence, ParsePosition)	Analysiert den Text mithilfe dieses Formatierungsprogramms und ermöglicht die Kontrolle über die Textposition.
Parse(String)	Analysiert vollständig den Text, der ein temporales Objekt erzeugt.
Parse(String, ITemporalQuery)	Analysiert den Text vollständig und erzeugt ein Objekt des angegebenen Typs.
Parse(String, ParsePosition)	Analysiert den Text mithilfe dieses Formatierungsprogramms und ermöglicht die Kontrolle über die Textposition.
ParseBest(ICharSequence, ITemporalQuery[])	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten.
ParseBest(String, ITemporalQuery[])	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten.
ParsedExcessDays()	Eine Abfrage, die Zugriff auf die überschüssigen Tage ermöglicht, die analysiert wurden.
ParsedLeapSecond()	Eine Abfrage, die Zugriff darauf ermöglicht, ob eine Schaltekunde analysiert wurde.
ParseUnresolved(ICharSequence, ParsePosition)	Analysiert den Text mit diesem Formatierer, ohne das für erweiterte Anwendungsfälle vorgesehene Ergebnis aufzulösen.
ParseUnresolved(String, ParsePosition)	Analysiert den Text mit diesem Formatierer, ohne das für erweiterte Anwendungsfälle vorgesehene Ergebnis aufzulösen.
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
ToArray<T>()	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten. (Geerbt von Object)
ToFormat()	Gibt diesen Formatierer als `java.text.Format` instance zurück.
ToFormat(ITemporalQuery)	Gibt diesen Formatierer als instance `java.text.Format` zurück, der mithilfe der angegebenen Abfrage analysiert wird.
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel durch em benachrichtigen/em> oder <em>interrupted</em>.<>< (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel, indem <er>benachrichtigt</em> oder <em>interrupted</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel, indem <er>benachrichtigt</em> oder <em>interrupted</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
WithChronology(IChronology)	Gibt eine Kopie dieses Formatierungsprogramms mit einer neuen Überschreibungschronologie zurück.
WithDecimalStyle(DecimalStyle)	Gibt eine Kopie dieses Formatters 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 Formatierungsprogramms mit einem neuen Satz von Resolverfeldern zurück.
WithResolverFields(ITemporalField[])	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten.
WithResolverStyle(ResolverStyle)	Gibt eine Kopie dieses Formatierungsprogramms mit einem neuen Resolverformat zurück.
WithZone(ZoneId)	Gibt eine Kopie dieses Formatierungsprogramms mit einer neuen Überschreibungszone zurück.

Explizite Schnittstellenimplementierungen

IJavaPeerable.Disposed()	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten. (Geerbt von Object)
IJavaPeerable.Finalized()	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten. (Geerbt von Object)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)	Führt eine Für Android-Runtime überprüfte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten.
GetJniTypeName(IJavaPeerable)	Formatierer zum Drucken und Analysieren von Datums-/Uhrzeitobjekten.

Gilt für: