DateUtils.FormatDateRange Método

Definición

Espacio de nombres:: Android.Text.Format

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Sobrecargas

Nombre	Description
FormatDateRange(Context, Int64, Int64, FormatStyleFlags)	Da formato a una fecha o un intervalo de tiempo según las convenciones locales.
FormatDateRange(Context, Formatter, Int64, Int64, FormatStyleFlags)	Da formato a una fecha o un intervalo de tiempo según las convenciones locales.
FormatDateRange(Context, Formatter, Int64, Int64, FormatStyleFlags, String)	Da formato a una fecha o un intervalo de tiempo según las convenciones locales.

FormatDateRange(Context, Int64, Int64, FormatStyleFlags)

Da formato a una fecha o un intervalo de tiempo según las convenciones locales.

[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

Parámetros

context: Context

el contexto solo es necesario si se muestra la hora

startMillis: Int64

la hora de inicio en milisegundos UTC

endMillis: Int64

la hora de finalización en milisegundos UTC

flags: FormatStyleFlags

máscara de bits de las opciones Consulte #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange

Devoluciones

String

cadena que contiene el intervalo de fecha y hora con formato.

Atributos: RegisterAttribute

Comentarios

Da formato a una fecha o un intervalo de tiempo según las convenciones locales.

Tenga en cuenta que se trata de un método de conveniencia. Su uso implica crear una instancia interna java.util.Formatter sobre la marcha, que es algo costosa en términos de memoria y tiempo. Esto es probablemente aceptable si usa el método solo rara vez, pero si se basa en él para dar formato a un gran número de fechas, considere la posibilidad de crear y reutilizar su propia java.util.Formatter instancia y usar la versión de #formatDateRange(Context, long, long, int) formatDateRange que toma un java.util.Formatter.

Java documentación para android.text.format.DateUtils.formatDateRange(android.content.Context, long, long, int).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a

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

Da formato a una fecha o un intervalo de tiempo según las convenciones locales.

[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

Parámetros

context: Context

el contexto solo es necesario si se muestra la hora

formatter: Formatter

formateador usado para dar formato al intervalo de fechas. Nota: asegúrese de llamar a setLength(0) en StringBuilder pasado al constructor formateador, a menos que desee que se acumulen los resultados.

startMillis: Int64

la hora de inicio en milisegundos UTC

endMillis: Int64

la hora de finalización en milisegundos UTC

flags: FormatStyleFlags

máscara de bits de las opciones Consulte #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange

Devoluciones

Formatter

cadena que contiene el intervalo de fecha y hora con formato.

Atributos: RegisterAttribute

Comentarios

Da formato a una fecha o un intervalo de tiempo según las convenciones locales.

Tenga en cuenta que se trata de un método de conveniencia para dar formato al intervalo de fecha o hora en la zona horaria local. Si desea especificar la zona horaria, use #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange.

Java documentación para android.text.format.DateUtils.formatDateRange(android.content.Context, java.util.Formatter, long, long, int).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a

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

Da formato a una fecha o un intervalo de tiempo según las convenciones locales.

[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

Parámetros

context: Context

el contexto solo es necesario si se muestra la hora

formatter: Formatter

startMillis: Int64

la hora de inicio en milisegundos UTC

endMillis: Int64

la hora de finalización en milisegundos UTC

flags: FormatStyleFlags

máscara de bits de las opciones

timeZone: String

el identificador de la zona horaria en la que se va a calcular la cadena. Use null para local o si se usa la marca FORMAT_UTC.

Devoluciones

Formatter

formateador con el intervalo de fecha y hora con formato anexado al búfer de cadenas.

Atributos: RegisterAttribute

Comentarios

Da formato a una fecha o un intervalo de tiempo según las convenciones locales.

Cadenas de salida de ejemplo (formatos de fecha en estos ejemplos se muestran mediante la convención de formato de fecha de EE. UU., pero esto puede cambiar según la configuración local): ul>li 10:15am</li li>><3:00pm< - 4pm</<>><>li li>3PM - 4PM</li<>li>08:00 - 17:00</>><li oct 9</li><>tue, 9< de octubre/li li><>9 de octubre,><< 9 de octubre de 2007</li<>li>9 - 10</li li>><9 - 10, 2007</li li>><28 de octubre - 3 de noviembre de 2007</li<>li>31, 2007 - 1 de enero de 2008</li li<>>9, 8:00am - Oct 10, 5:00pm</li li><>12/31/2007 - 01/01/2008</li></ul>

El argumento flags es una máscara de bits de las opciones de la lista siguiente:

<ul>li FORMAT_SHOW_TIME/li><>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>><li FORMAT_CAP_AMPM</><>li li FORMAT_NO_NOON</li><li>FORMAT_CAP_NOON</li 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><>

Si se establece FORMAT_SHOW_TIME, la hora se muestra como parte del intervalo de fechas. Si la hora de inicio y finalización son las mismas, solo se muestra la hora de inicio.

Si se establece FORMAT_SHOW_WEEKDAY, se muestra el día de la semana.

Si se establece FORMAT_SHOW_YEAR, siempre se muestra el año. Si no se establece FORMAT_SHOW_YEAR, el año solo se muestra si es diferente del año actual o si las fechas de inicio y finalización se encuentran en diferentes años.

Normalmente, la fecha se muestra a menos que el día de inicio y finalización sean los mismos. Si se establece FORMAT_SHOW_DATE, siempre se muestra la fecha, incluso para los mismos intervalos de días.

Si se establece FORMAT_NO_MONTH_DAY, si se muestra la fecha, solo se mostrará el nombre del mes, no el día del mes. Por ejemplo, "enero de 2008" en lugar del "6 de enero al 12 de 2008".

Si se establece FORMAT_CAP_AMPM y se usa la hora de 12 horas, se escriben "AM" y "PM". No debe usar esta marca porque en algunas configuraciones regionales estos términos no se pueden poner en mayúsculas y, en muchos otros, no tiene sentido hacerlo aunque sea posible.

Si se establece FORMAT_NO_NOON y se usa la hora de 12 horas, se muestra "12pm" en lugar de "mediodía".

Si se establece FORMAT_CAP_NOON y se usa la hora de 12 horas, se muestra "Mediodía" en lugar de "mediodía". Probablemente no debería usar esta marca porque en muchas configuraciones regionales no tendrá sentido capitalizar el término.

Si se establece FORMAT_NO_MIDNIGHT y se usa la hora de 12 horas, se muestra "12am" en lugar de "medianoche".

Si se establece FORMAT_CAP_MIDNIGHT y se usa la hora de 12 horas, se muestra "Medianoche" en lugar de "medianoche". Probablemente no debería usar esta marca porque en muchas configuraciones regionales no tendrá sentido capitalizar el término.

Si se establece FORMAT_12HOUR y se muestra la hora, la hora se muestra en el formato de hora 12 horas. Normalmente no debería establecer esto. En su lugar, deje que el formato de hora se elija automáticamente según la configuración del sistema. Si se establecen FORMAT_12HOUR y FORMAT_24HOUR, FORMAT_24HOUR tiene prioridad.

Si se establece FORMAT_24HOUR y se muestra la hora, la hora se muestra en el formato de hora 24 horas. Normalmente no debería establecer esto. En su lugar, deje que el formato de hora se elija automáticamente según la configuración del sistema. Si se establecen FORMAT_12HOUR y FORMAT_24HOUR, FORMAT_24HOUR tiene prioridad.

Si se establece FORMAT_UTC, la zona horaria UTC se usa para los milisegundos inicial y final, a menos que se especifique una zona horaria. Si se especifica una zona horaria, se usará independientemente de la marca FORMAT_UTC.

Si se establece FORMAT_ABBREV_TIME y se usa el formato de hora de 12 horas, las horas de inicio y finalización (si se muestran) se abrevian sin mostrar los minutos si son cero. Por ejemplo, en lugar de "3:00pm", la hora se abreviaría a "3pm".

Si se establece FORMAT_ABBREV_WEEKDAY, el día de la semana (si se muestra) se abrevia en una cadena de 3 letras.

Si se establece FORMAT_ABBREV_MONTH, el mes (si se muestra) se abrevia en una cadena de 3 letras.

Si se establece FORMAT_ABBREV_ALL, el día de la semana y el mes (si se muestra) se abrevian en cadenas de 3 letras.

Si se establece FORMAT_NUMERIC_DATE, la fecha se muestra en formato numérico en lugar de usar el nombre del mes. Por ejemplo, "12/31/2008" en lugar del "31 de diciembre de 2008".

Si la fecha de finalización finaliza a las 12:00 a. m. al principio de un día, se da formato como final del día anterior en dos escenarios: <ul><li>Para eventos de un solo día. Esto da como resultado "8pm - medianoche" en lugar de "Nov 10, 8pm - Nov 11, 12am".</li li><>Cuando no se muestra la hora. Esto da como resultado "10 de noviembre a 11" para un evento con una fecha de inicio del 10 de noviembre y una fecha de finalización del 12 de noviembre a las 00:00.</li></ul>

Java documentación para android.text.format.DateUtils.formatDateRange(android.content.Context, java.util.Formatter, long, long, int, java.lang.String).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a