DateUtils.FormatDateRange Método

[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

Retornos

uma cadeia de caracteres que contém o intervalo de data/hora formatado.

Atributos

RegisterAttribute

Comentários

Formata uma data ou um intervalo de tempo de acordo com as convenções locais.

Observe que esse é um método de conveniência. Usá-la envolve a criação de uma instância interna java.util.Formatter em tempo real, que é um pouco dispendiosa em termos de memória e tempo. Isso provavelmente é aceitável se você usar o método apenas raramente, mas se você depender dele para formatar um grande número de datas, considere criar e reutilizar sua própria java.util.Formatter instância e usar a versão disso #formatDateRange(Context, long, long, int) formatDateRange requer um java.util.Formatter.

Java documentação para android.text.format.DateUtils.formatDateRange(android.content.Context, long, long, int).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

[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

Retornos

uma cadeia de caracteres que contém o intervalo de data/hora formatado.

Atributos

RegisterAttribute

Comentários

Formata uma data ou um intervalo de tempo de acordo com as convenções locais.

Observe que esse é um método de conveniência para formatar a data ou o intervalo de tempo no fuso horário local. Se você quiser especificar o fuso horário, use #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange.

Java documentação para android.text.format.DateUtils.formatDateRange(android.content.Context, java.util.Formatter, long, long, int).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

[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

Retornos

o formatador com o intervalo de data/hora formatado acrescentado ao buffer de cadeia de caracteres.

Atributos

RegisterAttribute

Comentários

Formata uma data ou um intervalo de tempo de acordo com as convenções locais.

Exemplo de cadeias de caracteres de saída (formatos de data nestes exemplos são mostrados usando a convenção de formato de data dos EUA, mas isso pode mudar dependendo das configurações locais): ul>li 10:15am</li><li>15:00pm - 16:00pm</li><li>15h às 16h</li<>li>15h - 16h</li><li>08:00 - 17:00</li<>>out 9</li><li>Tue, 9</li out<>li>9 de outubro,><< 2007</li><>9 de outubro - 10</li<>li>9 a 10 de outubro, 2007</li><>28 out - Nov 3, 2007</li li<>>31, 2007 - Jan 1, 2008</li<>>9 out, 8:00am - Out 10, 5:00pm</li li><>31/12/2007 - 01/01/2008</li></ul>

O argumento flags é uma máscara de bits de opções da seguinte lista:

<ul>li FORMAT_SHOW_TIME/li><li>FORMAT_SHOW_WEEKDAY</li<>li>FORMAT_SHOW_YEAR</li>><li FORMAT_SHOW_DATE</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><FORMAT_NO_MIDNIGHT/li><li>FORMAT_CAP_MIDNIGHT</li><li>FORMAT_UTC</li<>>FORMAT_ABBREV_TIME</li><li>FORMAT_ABBREV_WEEKDAY</li<>>FORMAT_ABBREV_MONTH</li<>li>FORMAT_ABBREV_ALL</li><li>FORMAT_NUMERIC_DATE</li></ul>

Se FORMAT_SHOW_TIME estiver definida, a hora será mostrada como parte do intervalo de datas. Se a hora de início e término for a mesma, apenas a hora de início será mostrada.

Se FORMAT_SHOW_WEEKDAY estiver definido, o dia da semana será mostrado.

Se FORMAT_SHOW_YEAR estiver definido, o ano sempre será mostrado. Se FORMAT_SHOW_YEAR não estiver definido, o ano será mostrado somente se for diferente do ano atual ou se as datas de início e término cairem em anos diferentes.

Normalmente, a data é mostrada, a menos que o dia de início e de término seja o mesmo. Se FORMAT_SHOW_DATE estiver definida, a data será sempre mostrada, mesmo para os mesmos intervalos de dias.

Se FORMAT_NO_MONTH_DAY estiver definido, se a data for mostrada, apenas o nome do mês será mostrado, não o dia do mês. Por exemplo, "Janeiro de 2008" em vez de "6 a 12 de janeiro de 2008".

Se FORMAT_CAP_AMPM estiver definida e o tempo de 12 horas for usado, "AM" e "PM" serão maiúsculas. Você não deve usar esse sinalizador porque, em algumas localidades, esses termos não podem ser maiúsculas e, em muitos outros, não faz sentido fazê-lo mesmo que seja possível.

Se FORMAT_NO_NOON estiver definido e a hora de 12 horas for usada, "12h" será mostrado em vez de "meio-dia".

Se FORMAT_CAP_NOON estiver definida e a hora de 12 horas for usada, "Meio-dia" será mostrado em vez de "meio-dia". Você provavelmente não deve usar esse sinalizador porque em muitas localidades não fará sentido capitalizar o termo.

Se FORMAT_NO_MIDNIGHT estiver definida e a hora de 12 horas for usada, "12h" será mostrado em vez de "meia-noite".

Se FORMAT_CAP_MIDNIGHT estiver definida e o tempo de 12 horas for usado, "Meia-noite" será mostrado em vez de "meia-noite". Você provavelmente não deve usar esse sinalizador porque em muitas localidades não fará sentido capitalizar o termo.

Se FORMAT_12HOUR estiver definida e a hora for mostrada, a hora será mostrada no formato de tempo de 12 horas. Normalmente, você não deve definir isso. Em vez disso, permita que o formato de hora seja escolhido automaticamente de acordo com as configurações do sistema. Se FORMAT_12HOUR e FORMAT_24HOUR estiverem definidos, FORMAT_24HOUR terá precedência.

Se FORMAT_24HOUR estiver definida e a hora for mostrada, a hora será mostrada no formato de tempo de 24 horas. Normalmente, você não deve definir isso. Em vez disso, permita que o formato de hora seja escolhido automaticamente de acordo com as configurações do sistema. Se FORMAT_12HOUR e FORMAT_24HOUR estiverem definidos, FORMAT_24HOUR terá precedência.

Se FORMAT_UTC estiver definido, o fuso horário UTC será usado para os milissegundos de início e término, a menos que um fuso horário seja especificado. Se um fuso horário for especificado, ele será usado independentemente do sinalizador de FORMAT_UTC.

Se FORMAT_ABBREV_TIME for definido e o formato de tempo de 12 horas for usado, os horários de início e término (se mostrado) serão abreviados por não mostrarem os minutos se forem zero. Por exemplo, em vez de "15:00" a hora seria abreviada para "15h".

Se FORMAT_ABBREV_WEEKDAY estiver definida, o dia da semana (se mostrado) será abreviado para uma cadeia de caracteres de 3 letras.

Se FORMAT_ABBREV_MONTH estiver definido, o mês (se mostrado) será abreviado para uma cadeia de caracteres de 3 letras.

Se FORMAT_ABBREV_ALL estiver definido, o dia da semana e o mês (se mostrado) serão abreviados para cadeias de caracteres de 3 letras.

Se FORMAT_NUMERIC_DATE estiver definido, a data será mostrada no formato numérico em vez de usar o nome do mês. Por exemplo, "31/12/2008" em vez de "31 de dezembro de 2008".

Se a data de término terminar às 00h no início de um dia, ela será formatada como o final do dia anterior em dois cenários: <ul><li>Para eventos de dia único. Isso resulta em "20h - meia-noite" em vez de "10 de novembro, 20h - 11 de novembro, 12h".</li><li>Quando a hora não é exibida. Isso resulta em "10 a 11 de novembro" para um evento com uma data de início de 10 de novembro e uma data de término de 12 de novembro às 00:00.</li></ul>

Java documentação para android.text.format.DateUtils.formatDateRange(android.content.Context, java.util.Formatter, long, long, int, java.lang.String).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.