DateIntervalInfo Classe

Definição

[Android.Runtime.Register("android/icu/text/DateIntervalInfo", ApiSince=24, DoNotGenerateAcw=true)]
public class DateIntervalInfo : Java.Lang.Object, Android.Icu.Util.IFreezable, IDisposable, Java.IO.ISerializable

[<Android.Runtime.Register("android/icu/text/DateIntervalInfo", ApiSince=24, DoNotGenerateAcw=true)>]
type DateIntervalInfo = class
    inherit Object
    interface IFreezable
    interface ICloneable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ISerializable

Herança

Object

JavaObject

Object

DateIntervalInfo

Atributos

RegisterAttribute

Implementações

IFreezable IJavaObject IJavaPeerable ISerializable ICloneable IDisposable

Comentários

DateIntervalInfo é uma classe pública para encapsular padrões de intervalo de data localizável. Ele é usado por DateIntervalFormat.

Para a maioria dos usuários, o uso comum de DateIntervalFormat não precisa criar o objeto DateIntervalInfo diretamente. DateIntervalFormat cuidará dele ao criar um formatador de intervalo de datas quando o usuário passar o esqueleto e a localidade.

Para usuários de energia, que desejam criar seus próprios padrões de intervalo de data ou desejam refinar padrões de intervalo de data, eles podem fazer isso criando diretamente DateIntervalInfo e manipulando-os.

Logicamente, os padrões de intervalo são mapeamentos de (esqueleto, the_largest_different_calendar_field) para (date_interval_pattern).

Um esqueleto <ol><li> mantém apenas a letra padrão de campo e ignora todas as outras partes em um padrão, como espaço, pontuações e literais de cadeia de caracteres. <Li> oculta a ordem dos campos. <li> pode ocultar o comprimento da letra padrão de um campo.

Para esses campos de calendário que não são dígitos, o comprimento da letra padrão é importante, como MMM, MMMM e MMMMM; EEE e EEEE, e o comprimento da letra padrão do campo é respeitado.

Para os campos de calendário de dígito, como M ou MM, d ou dd, yy ou yyyyyy, o comprimento do padrão de campo é ignorado e a melhor correspondência, que é definida em padrões de data e hora, será retornada sem honrar o comprimento da letra padrão de campo no esqueleto. </ol>

Os campos de calendário compatíveis com a formatação de intervalo são: ano, mês, data, dia da semana, am-pm, hora, hora, hora do dia, minuto e segundo (embora atualmente não tenhamos dados intervalFormat específicos para esqueletos com segundos). Esses campos de calendário podem ser definidos na seguinte ordem: ano > mês > data > am-pm > hora > minuto > segundo

Os maiores campos de calendário diferentes entre dois calendários são o primeiro campo de calendário diferente na ordem acima.

Por exemplo: os maiores campos de calendário diferentes entre "10 de janeiro de 2007" e "20 de fevereiro de 2008" é o ano.

Há um conjunto de cadeias de caracteres de esqueleto estático predefinidas. Há padrões de intervalo predefinidos para esses esqueletos predefinidos nos arquivos de recurso de localidades. Por exemplo, para um esqueleto YEAR_ABBR_MONTH_DAY, que é "yMMMd", em en_US, se o maior campo de calendário diferente entre data1 e data2 for "ano", o padrão de intervalo de data é "MMM d, yyyyy - MMM d, yyyyy", como "Jan 10, 2007 - Jan 10, 2008". Se o maior campo de calendário diferente entre data1 e data2 for "mês", o padrão de intervalo de data será "MMM d - MMM d, yyyyyy", como "10 de janeiro a 10 de fevereiro de 2007". Se o maior campo de calendário diferente entre data1 e data2 for "dia", o padrão de intervalo de data será "MMM d-d, yyyyy", como "10 a 20 de janeiro de 2007".

Para o esqueleto de data, os padrões de intervalo quando ano, mês ou data é diferente são definidos em arquivos de recurso. Para esqueleto de tempo, os padrões de intervalo quando am/pm, hora ou minuto é diferente são definidos em arquivos de recurso.

Há duas datas no padrão de intervalo. Para a maioria das localidades, a primeira data em um padrão de intervalo é a data anterior. Pode haver uma localidade na qual a primeira data em um padrão de intervalo seja a data posterior. Usamos o formato de fallback para a ordem padrão para a localidade. Por exemplo, se o formato de fallback for "{0} - {1}", isso significa que a primeira data no padrão de intervalo para essa localidade é data anterior. Se o formato de fallback for "{1} - {0}", significa que a primeira data é a data posterior. Para um padrão de intervalo específico, a ordem padrão pode ser substituída prefixando "latestFirst:" ou "earliestFirst:" no padrão de intervalo. Por exemplo, se o formato de fallback for "{0}-{1}", mas para o esqueleto "yMMMd", o padrão de intervalo quando o dia for diferente é "latestFirst:d-d MMM yyy", significa que, por padrão, a primeira data no padrão de intervalo é a data anterior. Mas para o esqueleto "yMMMd", quando o dia é diferente, a primeira data em "d-d MMM yyy" é a data posterior.

A maneira recomendada de criar um objeto DateIntervalFormat é passar a localidade. Usando um parâmetro Locale, o objeto DateIntervalFormat é inicializado com os padrões de intervalo predefinidos para uma determinada localidade ou localidade padrão.

Os usuários também podem criar o objeto DateIntervalFormat fornecendo seus próprios padrões de intervalo. Ele fornece flexibilidade para o uso de energia.

Depois que um objeto DateIntervalInfo é criado, os clientes podem modificar os padrões de intervalo usando a função setIntervalPattern conforme desejado. Atualmente, os usuários só podem definir padrões de intervalo quando os seguintes campos de calendário são diferentes: ERA, ANO, MÊS, DATA, DAY_OF_MONTH, DAY_OF_WEEK, AM_PM, HORA, HOUR_OF_DAY, MINUTO, SEGUNDO E MILISSEGUNDO. Não há suporte para padrões de intervalo quando outros campos de calendário são diferentes.

Objetos DateIntervalInfo são clonáveis. Quando os clientes obtêm um objeto DateIntervalInfo, eles podem se sentir à vontade para modificá-lo conforme necessário.

DateIntervalInfo não deve ser subclasse. Os dados de um calendário são carregados de pacotes de recursos. Por meio da UTI 4.4, os padrões de intervalo de data só têm suporte no calendário gregoriano; Calendários não gregorianos têm suporte da UTI 4.4.1.

Java documentação para android.icu.text.DateIntervalInfo.

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.