DateFormat Klasse
Definition
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.
DateFormat ist eine abstrakte Klasse für Datums-/Uhrzeitformatierungsunterklassen, die Datums- oder Uhrzeitangaben sprachunabhängig formatiert und analysiert.
[Android.Runtime.Register("java/text/DateFormat", DoNotGenerateAcw=true)]
public abstract class DateFormat : Java.Text._Format[<Android.Runtime.Register("java/text/DateFormat", DoNotGenerateAcw=true)>]
type DateFormat = class
inherit _Format- Vererbung
- Abgeleitet
- Attribute
Hinweise
DateFormat ist eine abstrakte Klasse für Datums-/Uhrzeitformatierungsunterklassen, die Datums- oder Uhrzeitangaben sprachunabhängig formatiert und analysiert. Die Formatierungsunterklasse für Datum/Uhrzeit, z SimpleDateFormat. B. , ermöglicht formatierung (d. h. datum → text), analysieren (Text → date) und Normalisierung. Das Datum wird seit Date dem 1. Januar 1970, 00:00:00 Uhr GMT, als Objekt oder als Millisekunden dargestellt.
DateFormat stellt viele Klassenmethoden zum Abrufen von Standardformatierern für Datum/Uhrzeit bereit, die auf dem Standard- oder einem bestimmten Gebietsschema und einer Reihe von Formatierungsstilen basieren. Die Formatierungsformate umfassen #FULL, #LONG, #MEDIUMund #SHORT. Weitere Details und Beispiele für die Verwendung dieser Stile finden Sie in den Methodenbeschreibungen.
DateFormat hilft Ihnen beim Formatieren und Analysieren von Datumsangaben für ein beliebiges Gebietsschema. Ihr Code kann völlig unabhängig von den Gebietsschemakonventionen für Monate, Wochentage oder sogar vom Kalenderformat sein: Mond gegen Sonne.
Um ein Datum für das aktuelle Gebietsschema zu formatieren, verwenden Sie eine der statischen Factory-Methoden: <blockquote>
{@code
myString = DateFormat.getDateInstance().format(myDate);
}
</Blockquote>
Wenn Sie mehrere Datumsangaben formatieren, ist es effizienter, das Format abzurufen und es mehrmals zu verwenden, sodass das System die Informationen über die lokale Sprache und die Länderkonventionen nicht mehrmals abrufen muss. <Blockquote>
{@code
DateFormat df = DateFormat.getDateInstance();
for (int i = 0; i < myDate.length; ++i) {
output.println(df.format(myDate[i]) + "; ");
}
}
</Blockquote>
Um ein Datum für ein anderes Gebietsschema zu formatieren, geben Sie es im Aufruf von an #getDateInstance(int, Locale) getDateInstance(). <Blockquote>
{@code
DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);
}
</Blockquote>
Sie können auch ein DateFormat verwenden, um zu analysieren. <Blockquote>
{@code
myDate = df.parse(myString);
}
</Blockquote>
Verwenden Sie getDateInstance , um das normale Datumsformat für dieses Land abzurufen. Es sind weitere statische Factorymethoden verfügbar. Verwenden Sie getTimeInstance , um das Zeitformat für dieses Land abzurufen. Verwenden Sie getDateTimeInstance , um ein Datums- und Uhrzeitformat abzurufen. Sie können verschiedene Optionen an diese Factorymethoden übergeben, um die Länge des Ergebnisses zu steuern. von bis #SHORT#MEDIUM bis #LONG bis #FULL. Das genaue Ergebnis hängt vom Gebietsschema ab, aber im Allgemeinen: ul li#SHORT ist vollständig numerisch, z12.13.52. B. oder 3:30pm<li#MEDIUM> ist länger, z. BJan 12, 1952<. li>#LONG ist länger, wie January 12, 1952 oder 3:30:32pm<li>#FULL ist ziemlich vollständig angegeben, wie .Tuesday, April 12, 1952 AD or 3:30:42pm PST>><< </ul>
Sie können bei Bedarf auch die Zeitzone für das Format festlegen. Wenn Sie noch mehr Kontrolle über das Format oder die Analyse wünschen (oder Ihren Benutzern mehr Kontrolle geben möchten), können Sie versuchen, die DateFormat von den Factorymethoden erhaltene in eine zu umwandeln SimpleDateFormat. Dies wird für die meisten Länder funktionieren; Denken Sie daran, es in einen try Block zu setzen, falls Sie auf einen ungewöhnlichen stoßen.
Sie können auch Formen der Analyse- und Formatmethoden mit ParsePosition und FieldPosition verwenden, damit Sie><>< Teile einer Zeichenfolge schrittweise analysieren können. <Richten>Sie ein bestimmtes Feld aus, oder finden Sie heraus, wo es sich zur Auswahl auf dem Bildschirm befindet. </ul>
<h2>"synchronization">Synchronization</h2>
Datumsformate werden nicht synchronisiert. Es wird empfohlen, für jeden Thread separate Formatinstanzen zu erstellen. Wenn mehrere Threads gleichzeitig auf ein Format zugreifen, muss es extern synchronisiert werden.
In Version 1.1 hinzugefügt.
Java-Dokumentation für java.text.DateFormat.
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.
Konstruktoren
| DateFormat() |
Erstellen Sie ein neues Datumsformat. |
| DateFormat(IntPtr, JniHandleOwnership) |
Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Runtime aufgerufen. |
Felder
| AmPmField |
Nützliche Konstante für AM_PM Feldausrichtung. |
| DateField |
Nützliche Konstante für die DATE-Feldausrichtung. |
| DayOfWeekField |
Nützliche Konstante für DAY_OF_WEEK Feldausrichtung. |
| DayOfWeekInMonthField |
Nützliche Konstante für DAY_OF_WEEK_IN_MONTH Feldausrichtung. |
| DayOfYearField |
Nützliche Konstante für DAY_OF_YEAR Feldausrichtung. |
| Default |
Konstante für das Standardformatmuster. |
| EraField |
Nützliche Konstante für die ERA-Feldausrichtung. |
| Full |
Konstante für das vollständige Stilmuster. |
| Hour0Field |
Nützliche Konstante für die nullbasierte HOUR-Feldausrichtung. |
| Hour1Field |
Nützliche Konstante für die Ein-basierte HOUR-Feldausrichtung. |
| HourOfDay0Field |
Nützliche Konstante für nullbasierte HOUR_OF_DAY Feldausrichtung. |
| HourOfDay1Field |
Nützliche Konstante für eine HOUR_OF_DAY Feldausrichtung. |
| Long |
Konstante für lange Formatvorlagen. |
| Medium |
Konstante für mittleres Formatmuster. |
| MillisecondField |
Nützliche Konstante für die MILLISECOND-Feldausrichtung. |
| MinuteField |
Nützliche Konstante für die MINUTE-Feldausrichtung. |
| MonthField |
Nützliche Konstante für die Monatsfeldausrichtung. |
| SecondField |
Nützliche Konstante für die Ausrichtung des ZWEITEN Felds. |
| Short |
Konstante für kurze Stilmuster. |
| TimezoneField |
Nützliche Konstante für die TIMEZONE-Feldausrichtung. |
| WeekOfMonthField |
Nützliche Konstante für WEEK_OF_MONTH Feldausrichtung. |
| WeekOfYearField |
Nützliche Konstante für WEEK_OF_YEAR Feldausrichtung. |
| YearField |
Nützliche Konstante für die Year-Feldausrichtung. |
Eigenschaften
| Calendar |
Ruft den Kalender ab, der diesem Datums-/Uhrzeitformatierer zugeordnet ist. - oder: Legen Sie den Kalender fest, der von diesem Datumsformat verwendet werden soll. |
| Class |
Gibt die Laufzeitklasse dieses |
| DateInstance |
Ruft den Datumsformatierer mit der Standardformatierungsart für das Standardgebietsschema |
| DateTimeInstance |
Ruft den Datums-/Uhrzeitformatierer mit der Standardformatierungsart für das Standardgebietsschema |
| Handle |
Das Handle zum zugrunde liegenden Android-instance. (Geerbt von Object) |
| Instance |
Rufen Sie einen Standardformatierer für Datum/Uhrzeit ab, der die SHORT-Formatvorlage sowohl für das Datum als auch die Uhrzeit verwendet. |
| JniIdentityHashCode |
|
| JniPeerMembers |
|
| Lenient |
Informieren Sie, ob die Datums-/Uhrzeitanalyse nachsichtig sein soll. - oder: Geben Sie an, ob die Datums-/Uhrzeit-Analyse nachsichtig sein soll. |
| NumberFormat |
Ruft den Zahlenformatierer ab, den dieser Datums-/Uhrzeitformatierer zum Formatieren und Analysieren einer Zeit verwendet. -or: Ermöglicht das Festlegen des Zahlenformatierers. |
| PeerReference |
|
| ThresholdClass |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
| ThresholdType |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
| TimeInstance |
Ruft den Zeitformatierer mit der Standardformatierungsart für das Standardgebietsschema |
| TimeZone |
Ruft die Zeitzone ab. - or: Legt die Zeitzone für den Kalender dieses |
Methoden
| Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von _Format) |
| Dispose() |
|
| Dispose(Boolean) |
|
| Equals(Object) |
Gibt an, ob ein anderes Objekt diesem "gleich" ist. (Geerbt von Object) |
| Format(Date) |
Formatiert eine |
| Format(Date, StringBuffer, FieldPosition) |
Formatiert eine |
| Format(Object) |
Formatiert ein Objekt, um eine Zeichenfolge zu erzeugen. (Geerbt von _Format) |
| Format(Object, StringBuffer, FieldPosition) |
Formatiert die angegebene |
| FormatToCharacterIterator(Object) |
Formatiert ein Objekt, das einen erzeugt |
| GetAvailableLocales() |
Gibt ein Array aller Gebietsschemas zurück, für die die |
| GetDateInstance(Int32) |
Ruft den Datumsformatierer mit der angegebenen Formatierungsart für das Standardgebietsschema |
| GetDateInstance(Int32, Locale) |
Ruft den Datumsformatierer mit der angegebenen Formatierungsart für das angegebene Gebietsschema ab. |
| GetDateTimeInstance(Int32, Int32) |
Ruft den Datums-/Uhrzeitformatierer mit den angegebenen Datums- und Uhrzeitformatvorlagen für das Standardgebietsschema |
| GetDateTimeInstance(Int32, Int32, Locale) |
Ruft den Datums-/Uhrzeitformatierer mit den angegebenen Formatierungsstilen für das angegebene Gebietsschema ab. |
| GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
| GetTimeInstance(Int32) |
Ruft den Zeitformatierer mit der angegebenen Formatierungsart für das Standardgebietsschema |
| GetTimeInstance(Int32, Locale) |
Ruft den Zeitformatierer mit der angegebenen Formatierungsart für das angegebene Gebietsschema ab. |
| 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) |
| 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) |
| Parse(String) |
Analysiert Text vom Anfang der angegebenen Zeichenfolge, um ein Datum zu erzeugen. |
| Parse(String, ParsePosition) |
Analysieren Sie eine Datum/Uhrzeit-Zeichenfolge entsprechend der angegebenen Analyseposition. |
| ParseObject(String) |
Analysiert Text vom Anfang der angegebenen Zeichenfolge, um ein Objekt zu erzeugen. (Geerbt von _Format) |
| ParseObject(String, ParsePosition) |
Analysiert Text aus einer Zeichenfolge, um einen |
| SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
| ToArray<T>() |
|
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| UnregisterFromRuntime() |
|
| 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) |
Explizite Schnittstellenimplementierungen
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.DisposeUnlessReferenced() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniManagedPeerState |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
Erweiterungsmethoden
| JavaCast<TResult>(IJavaObject) |
Führt eine Für Android-Runtime überprüfte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
|
| GetJniTypeName(IJavaPeerable) |
|