DateUtils.FormatDateRange Metodo

[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

Parametri

Valori restituiti

stringa contenente l'intervallo di data/ora formattato.

Attributi

RegisterAttribute

Commenti

Formatta una data o un intervallo di tempo in base alle convenzioni locali.

Si noti che si tratta di un metodo pratico. L'uso comporta la creazione di un'istanza interna java.util.Formatter in tempo reale, che è piuttosto costosa in termini di memoria e tempo. Ciò è probabilmente accettabile se si usa il metodo solo raramente, ma se si fa affidamento su di esso per la formattazione di un numero elevato di date, è consigliabile creare e riutilizzare l'istanza java.util.Formatter e usare la versione di #formatDateRange(Context, long, long, int) formatDateRange che accetta un .java.util.Formatter

per android.text.format.DateUtils.formatDateRange(android.content.Context, long, long, int).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

[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

Parametri

Valori restituiti

stringa contenente l'intervallo di data/ora formattato.

Attributi

RegisterAttribute

Commenti

Formatta una data o un intervallo di tempo in base alle convenzioni locali.

Si noti che si tratta di un metodo pratico per la formattazione dell'intervallo di data o ora nel fuso orario locale. Se si vuole specificare il fuso orario, usare #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange.

per android.text.format.DateUtils.formatDateRange(android.content.Context, java.util.Formatter, long, long, int).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

[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

Parametri

Valori restituiti

formattatore con l'intervallo di data/ora formattato aggiunto al buffer di stringa.

Attributi

RegisterAttribute

Commenti

Formatta una data o un intervallo di tempo in base alle convenzioni locali.

Le stringhe di output di esempio (formati di data in questi esempi vengono visualizzate usando la convenzione di formato data usa ma che possono cambiare a seconda delle impostazioni locali): ul>li 10:15am</li>><3:00pm - 4:00pm</li>><3pm - 3pm</li><>3PM - 4PM</li><>08:00 - 17:00</li>><9</>><li Tue, Ottobre 9</li li><>ottobre 9,><< 2007</li li>><Ottobre 9 - 10</li><ottobre>9 - 10, 2007</li li><>Oct 28 - Nov 3, 2007</li<>>Dec 31, 2007 - Jan 1, 2008</li><>Oct 9, 8:00am - Oct 10, 5:00pm</li><>12/31/2007 - 01/01/2008</li></ul>

L'argomento flags è una maschera di bit di opzioni nell'elenco seguente:

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

Se FORMAT_SHOW_TIME è impostato, l'ora viene visualizzata come parte dell'intervallo di date. Se l'ora di inizio e di fine è la stessa, viene visualizzata solo l'ora di inizio.

Se FORMAT_SHOW_WEEKDAY è impostato, viene visualizzato il giorno feriale.

Se FORMAT_SHOW_YEAR è impostato, l'anno viene sempre visualizzato. Se FORMAT_SHOW_YEAR non è impostato, l'anno viene visualizzato solo se è diverso dall'anno corrente o se le date di inizio e di fine rientrano in anni diversi.

In genere la data viene visualizzata a meno che il giorno di inizio e di fine non siano uguali. Se FORMAT_SHOW_DATE è impostato, la data viene sempre visualizzata, anche per gli stessi intervalli di giorni.

Se FORMAT_NO_MONTH_DAY è impostato, se viene visualizzata la data, verrà visualizzato solo il nome del mese, non il giorno del mese. Ad esempio, "Gennaio, 2008" anziché "6 gennaio - 12, 2008".

Se FORMAT_CAP_AMPM è impostato e viene usata l'ora di 12 ore, le maiuscole e minuscole sono "AM" e "PM". Non è consigliabile usare questo flag perché in alcune impostazioni locali questi termini non possono essere maiuscole e in molti altri non ha senso farlo anche se è possibile.

Se FORMAT_NO_NOON è impostato e viene usata l'ora di 12 ore, viene visualizzato "12pm" anziché "mezzogiorno".

Se FORMAT_CAP_NOON è impostato e viene usata l'ora di 12 ore, viene visualizzato "Noon" invece di "mezzogiorno". Probabilmente non usare questo flag perché in molte impostazioni locali non sarà opportuno usare maiuscole e minuscole per il termine.

Se FORMAT_NO_MIDNIGHT è impostato e viene usata l'ora di 12 ore, viene visualizzato "12:00" anziché "mezzanotte".

Se FORMAT_CAP_MIDNIGHT è impostato e viene usata l'ora di 12 ore, viene visualizzato "Mezzanotte" anziché "mezzanotte". Probabilmente non usare questo flag perché in molte impostazioni locali non sarà opportuno usare maiuscole e minuscole per il termine.

Se FORMAT_12HOUR è impostato e viene visualizzato l'ora, l'ora viene visualizzata nel formato di ora di 12 ore. In genere non è consigliabile impostare questa impostazione. Lasciare invece che il formato dell'ora venga scelto automaticamente in base alle impostazioni di sistema. Se vengono impostati sia FORMAT_12HOUR che FORMAT_24HOUR, FORMAT_24HOUR ha la precedenza.

Se FORMAT_24HOUR è impostato e viene visualizzato l'ora, l'ora viene visualizzata nel formato di ora di 24 ore. In genere non è consigliabile impostare questa impostazione. Lasciare invece che il formato dell'ora venga scelto automaticamente in base alle impostazioni di sistema. Se vengono impostati sia FORMAT_12HOUR che FORMAT_24HOUR, FORMAT_24HOUR ha la precedenza.

Se FORMAT_UTC è impostato, il fuso orario UTC viene usato per i millisecondi di inizio e fine, a meno che non venga specificato un fuso orario. Se viene specificato un fuso orario, verrà usato indipendentemente dal flag FORMAT_UTC.

Se FORMAT_ABBREV_TIME è impostato e viene usato il formato ora di 12 ore, l'ora di inizio e di fine (se visualizzata) viene abbreviata non mostrando i minuti se sono zero. Ad esempio, invece di "3:00pm", l'ora verrebbe abbreviata in "3pm".

Se FORMAT_ABBREV_WEEKDAY è impostato, il giorno feriale (se visualizzato) viene abbreviato in una stringa di 3 lettere.

Se FORMAT_ABBREV_MONTH è impostato, il mese (se visualizzato) viene abbreviato in una stringa di 3 lettere.

Se FORMAT_ABBREV_ALL è impostato, il giorno feriale e il mese (se visualizzato) sono abbreviati in stringhe di 3 lettere.

Se FORMAT_NUMERIC_DATE è impostato, la data viene visualizzata in formato numerico anziché usare il nome del mese. Ad esempio, "31/12/2008" anziché "31 dicembre 2008".

Se la data di fine termina alle 12:00 all'inizio di un giorno, viene formattata come fine del giorno precedente in due scenari: <ul><li>Per eventi di un singolo giorno. Questo risultato è "8:00 - mezzanotte" anziché "10 novembre, 10:00 - 11 novembre, 12:00".</li><li>Quando l'ora non viene visualizzata. Questo risultato è "Nov 10 - 11" per un evento con una data di inizio del 10 novembre e una data di fine del 12 novembre alle 00:00.</li></ul>

per android.text.format.DateUtils.formatDateRange(android.content.Context, java.util.Formatter, long, long, int, java.lang.String).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.