DateUtils.FormatDateRange Methode

Definition

Namespace:: Android.Text.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.

Überlädt

Name	Beschreibung
FormatDateRange(Context, Int64, Int64, FormatStyleFlags)	Formatiert einen Datums- oder Zeitbereich gemäß den lokalen Konventionen.
FormatDateRange(Context, Formatter, Int64, Int64, FormatStyleFlags)	Formatiert einen Datums- oder Zeitbereich gemäß den lokalen Konventionen.
FormatDateRange(Context, Formatter, Int64, Int64, FormatStyleFlags, String)	Formatiert einen Datums- oder Zeitbereich gemäß den lokalen Konventionen.

FormatDateRange(Context, Int64, Int64, FormatStyleFlags)

Formatiert einen Datums- oder Zeitbereich gemäß den lokalen Konventionen.

[Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;JJI)Ljava/lang/String;", "")]
public static string? FormatDateRange(Android.Content.Context? context, long startMillis, long endMillis, Android.Text.Format.FormatStyleFlags flags);

[<Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;JJI)Ljava/lang/String;", "")>]
static member FormatDateRange : Android.Content.Context * int64 * int64 * Android.Text.Format.FormatStyleFlags -> string

Parameter

context: Context

Der Kontext ist nur erforderlich, wenn die Uhrzeit angezeigt wird.

startMillis: Int64

die Startzeit in UTC Millisekunden

endMillis: Int64

Endzeit in UTC-Millisekunden

flags: FormatStyleFlags

ein bisschen Maske der Optionen siehe #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange

Gibt zurück

String

eine Zeichenfolge, die den formatierten Datums-/Uhrzeitbereich enthält.

Attribute: RegisterAttribute

Hinweise

Formatiert einen Datums- oder Zeitbereich gemäß den lokalen Konventionen.

Beachten Sie, dass dies eine Komfortmethode ist. Die Verwendung umfasst das Erstellen einer internen java.util.Formatter Instanz im Fly-On-Fly, was in Bezug auf Arbeitsspeicher und Zeit etwas kostspielig ist. Dies ist wahrscheinlich akzeptabel, wenn Sie die Methode nur selten verwenden, aber wenn Sie darauf angewiesen sind, eine große Anzahl von Datumsangaben zu formatieren, erwägen Sie, Ihre eigene java.util.Formatter Instanz zu erstellen und erneut zu verwenden und die Version dieser #formatDateRange(Context, long, long, int) formatDateRange Methode zu java.util.Formatterverwenden.

Java Dokumentation für android.text.format.DateUtils.formatDateRange(android.content.Context, long, long, int).

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.

Gilt für:

FormatDateRange(Context, Formatter, Int64, Int64, FormatStyleFlags)

Formatiert einen Datums- oder Zeitbereich gemäß den lokalen Konventionen.

[Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;Ljava/util/Formatter;JJI)Ljava/util/Formatter;", "")]
public static Java.Util.Formatter? FormatDateRange(Android.Content.Context? context, Java.Util.Formatter? formatter, long startMillis, long endMillis, Android.Text.Format.FormatStyleFlags flags);

[<Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;Ljava/util/Formatter;JJI)Ljava/util/Formatter;", "")>]
static member FormatDateRange : Android.Content.Context * Java.Util.Formatter * int64 * int64 * Android.Text.Format.FormatStyleFlags -> Java.Util.Formatter

Parameter

context: Context

Der Kontext ist nur erforderlich, wenn die Uhrzeit angezeigt wird.

formatter: Formatter

der zum Formatieren des Datumsbereichs verwendete Formatierer. Hinweis: Rufen Sie setLength(0) für StringBuilder auf, der an den Formatter-Konstruktor übergeben wird, es sei denn, Sie möchten, dass die Ergebnisse akkumuliert werden.

startMillis: Int64

die Startzeit in UTC Millisekunden

endMillis: Int64

Endzeit in UTC-Millisekunden

flags: FormatStyleFlags

ein bisschen Maske der Optionen siehe #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange

Gibt zurück

Formatter

eine Zeichenfolge, die den formatierten Datums-/Uhrzeitbereich enthält.

Attribute: RegisterAttribute

Hinweise

Formatiert einen Datums- oder Zeitbereich gemäß den lokalen Konventionen.

Beachten Sie, dass dies eine Bequeme Methode zum Formatieren des Datums- oder Uhrzeitbereichs in der lokalen Zeitzone ist. Wenn Sie die Zeitzone angeben möchten, verwenden #formatDateRange(Context, Formatter, long, long, int, String) formatDateRangeSie bitte .

Java Dokumentation für android.text.format.DateUtils.formatDateRange(android.content.Context, java.util.Formatter, long, long, int).

Gilt für:

FormatDateRange(Context, Formatter, Int64, Int64, FormatStyleFlags, String)

Formatiert einen Datums- oder Zeitbereich gemäß den lokalen Konventionen.

[Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;Ljava/util/Formatter;JJILjava/lang/String;)Ljava/util/Formatter;", "")]
public static Java.Util.Formatter? FormatDateRange(Android.Content.Context? context, Java.Util.Formatter? formatter, long startMillis, long endMillis, Android.Text.Format.FormatStyleFlags flags, string? timeZone);

[<Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;Ljava/util/Formatter;JJILjava/lang/String;)Ljava/util/Formatter;", "")>]
static member FormatDateRange : Android.Content.Context * Java.Util.Formatter * int64 * int64 * Android.Text.Format.FormatStyleFlags * string -> Java.Util.Formatter

Parameter

context: Context

Der Kontext ist nur erforderlich, wenn die Uhrzeit angezeigt wird.

formatter: Formatter

startMillis: Int64

die Startzeit in UTC Millisekunden

endMillis: Int64

Endzeit in UTC-Millisekunden

flags: FormatStyleFlags

eine Bitmaske von Optionen

timeZone: String

die ID der Zeitzone, in der die Zeichenfolge berechnet werden soll. Verwenden Sie "NULL" für "lokal" oder wenn das FORMAT_UTC-Flag verwendet wird.

Gibt zurück

Formatter

der Formatierer mit dem formatierten Datums-/Uhrzeitbereich, der an den Zeichenfolgenpuffer angefügt ist.

Attribute: RegisterAttribute

Hinweise

Formatiert einen Datums- oder Zeitbereich gemäß den lokalen Konventionen.

Beispielausgabezeichenfolgen (Datumsformate in diesen Beispielen werden mithilfe der US-Datumsformatkonvention gezeigt, die sich jedoch je nach den lokalen Einstellungen ändern können): ul>li 10:15am</li li>><3:00 - 17:00< Uhr/li li>><3pm - 4pm><<></li><li li>08:00 - 17:00</li li><li>9</li><>Tue, 9<. Oktober/li li><>9. Oktober,><< 2007</li li>><Okt 9 - 10</li li<>>Okt 9 - 10, 2007</li li>Okt 28 - 3. November 2007</li li>Li 31. Dezember 2007 - 1. Januar 2008</li>><><9, 8:00 - 10. Oktober 10,00< Uhr/li><li>><12.31.2007 - 01.01.2008</li/ul><>

Das Flags-Argument ist eine Bitmaske von Optionen aus der folgenden Liste:

<ul>li FORMAT_SHOW_TIME/li><>FORMAT_SHOW_WEEKDAY</li><li>FORMAT_SHOW_YEAR</li><li>FORMAT_SHOW_DATE</li><li>FORMAT_NO_MONTH_DAY</li<>li>FORMAT_12HOUR</li li><>FORMAT_24HOUR</>><li FORMAT_CAP_AMPM</li<>>li FORMAT_NO_NOON</li li>FORMAT_CAP_NOON</li>><<><<li><FORMAT_NO_MIDNIGHT/li><li>FORMAT_CAP_MIDNIGHT</li><>li FORMAT_UTC</li<>li>FORMAT_ABBREV_TIME</li li>FORMAT_ABBREV_WEEKDAY</li><<>li>FORMAT_ABBREV_MONTH</li<>li>FORMAT_ABBREV_ALL</li><li>FORMAT_NUMERIC_DATE</li></ul>

Wenn FORMAT_SHOW_TIME festgelegt ist, wird die Uhrzeit als Teil des Datumsbereichs angezeigt. Wenn die Start- und Endzeit identisch ist, wird nur die Startzeit angezeigt.

Wenn FORMAT_SHOW_WEEKDAY festgelegt ist, wird der Wochentag angezeigt.

Wenn FORMAT_SHOW_YEAR festgelegt ist, wird das Jahr immer angezeigt. Wenn FORMAT_SHOW_YEAR nicht festgelegt ist, wird das Jahr nur angezeigt, wenn es sich von dem aktuellen Jahr unterscheidet oder die Anfangs- und Enddaten auf unterschiedliche Jahre fallen.

Normalerweise wird das Datum angezeigt, es sei denn, der Anfangs- und Endtag ist identisch. Wenn FORMAT_SHOW_DATE festgelegt ist, wird das Datum immer angezeigt, auch für dieselben Tagesbereiche.

Wenn FORMAT_NO_MONTH_DAY festgelegt ist, wird nur der Monatsname angezeigt, nicht der Tag des Monats. Beispiel: "January, 2008" anstelle von "6. - 12. Januar 2008".

Wenn FORMAT_CAP_AMPM festgelegt ist und die 12-Stunden-Zeit verwendet wird, werden "AM" und "PM" großgeschrieben. Sie sollten diese Kennzeichnung nicht verwenden, da diese Begriffe in einigen Gebietsschemas nicht groß geschrieben werden können, und in vielen anderen ist es nicht sinnvoll, dies auch dann zu tun, wenn es möglich ist.

Wenn FORMAT_NO_NOON festgelegt und die 12-Stunden-Zeit verwendet wird, wird "12pm" anstelle von "Noon" angezeigt.

Wenn FORMAT_CAP_NOON festgelegt und die 12-Stunden-Zeit verwendet wird, wird "Noon" anstelle von "Noon" angezeigt. Sie sollten dieses Flag wahrscheinlich nicht verwenden, da es in vielen Gebietsschemas nicht sinnvoll ist, den Begriff groß zu machen.

Wenn FORMAT_NO_MIDNIGHT festgelegt ist und die 12-Stunden-Zeit verwendet wird, wird "12am" anstelle von "Mitternacht" angezeigt.

Wenn FORMAT_CAP_MIDNIGHT festgelegt ist und 12-Stunden-Zeit verwendet wird, wird "Mitternacht" anstelle von "Mitternacht" angezeigt. Sie sollten dieses Flag wahrscheinlich nicht verwenden, da es in vielen Gebietsschemas nicht sinnvoll ist, den Begriff groß zu machen.

Wenn FORMAT_12HOUR festgelegt ist und die Uhrzeit angezeigt wird, wird die Uhrzeit im 12-Stunden-Format angezeigt. Sie sollten dies normalerweise nicht festlegen. Lassen Sie stattdessen das Zeitformat gemäß den Systemeinstellungen automatisch ausgewählt werden. Wenn sowohl FORMAT_12HOUR als auch FORMAT_24HOUR festgelegt sind, hat FORMAT_24HOUR Vorrang.

Wenn FORMAT_24HOUR festgelegt ist und die Uhrzeit angezeigt wird, wird die Uhrzeit im 24-Stunden-Zeitformat angezeigt. Sie sollten dies normalerweise nicht festlegen. Lassen Sie stattdessen das Zeitformat gemäß den Systemeinstellungen automatisch ausgewählt werden. Wenn sowohl FORMAT_12HOUR als auch FORMAT_24HOUR festgelegt sind, hat FORMAT_24HOUR Vorrang.

Wenn FORMAT_UTC festgelegt ist, wird die UTC-Zeitzone für die Start- und End millisekunden verwendet, es sei denn, es wird eine Zeitzone angegeben. Wenn eine Zeitzone angegeben wird, wird sie unabhängig von der FORMAT_UTC-Kennzeichnung verwendet.

Wenn FORMAT_ABBREV_TIME festgelegt ist und das 12-Stunden-Zeitformat verwendet wird, werden die Start- und Endzeiten (sofern angezeigt) abgekürzt, indem die Minuten nicht angezeigt werden, wenn sie null sind. Statt z. B. "13:00 Uhr" würde die Uhrzeit auf "13:00 Uhr" gekürzt.

Wenn FORMAT_ABBREV_WEEKDAY festgelegt ist, wird der Wochentag (sofern angezeigt) mit einer 3-Buchstaben-Zeichenfolge abgekürzt.

Wenn FORMAT_ABBREV_MONTH festgelegt ist, wird der Monat (sofern angezeigt) mit einer 3-Buchstaben-Zeichenfolge abgekürzt.

Wenn FORMAT_ABBREV_ALL festgelegt ist, werden der Wochentag und der Monat (sofern angezeigt) auf 3-Buchstaben-Zeichenfolgen gekürzt.

Wenn FORMAT_NUMERIC_DATE festgelegt ist, wird das Datum im numerischen Format angezeigt, anstatt den Namen des Monats zu verwenden. Beispiel: "12.31.2008" anstelle von "31. Dezember 2008".

Wenn das Enddatum am Anfang eines Tages um 12:00 Uhr endet, wird es in zwei Szenarien als Ende des vorherigen Tags formatiert: <ul><li>Für einzelne Tagesereignisse. Dies führt zu "11:00 - Mitternacht" anstelle von "10. November 11. November 12.00 Uhr".</li li><>Wenn die Uhrzeit nicht angezeigt wird. Dies führt zu "Nov 10 - 11" für eine Veranstaltung mit einem Startdatum vom 10. November und einem Enddatum vom 12. November um 00:00 Uhr.</li></ul>

Java Dokumentation für android.text.format.DateUtils.formatDateRange(android.content.Context, java.util.Formatter, long, long, int, java.lang.String).

Gilt für: