DateTimeFormatter.WithChronology(IChronology) Método

[Android.Runtime.Register("withChronology", "(Ljava/time/chrono/Chronology;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithChronology(Java.Time.Chrono.IChronology? chrono);

[<Android.Runtime.Register("withChronology", "(Ljava/time/chrono/Chronology;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithChronology : Java.Time.Chrono.IChronology -> Java.Time.Format.DateTimeFormatter

Parâmetros

Retornos

um formatador com base nesse formatador com a cronologia de substituição solicitada, não nulo

Atributos

RegisterAttribute

Comentários

Retorna uma cópia desse formatador com uma nova cronologia de substituição.

Isso retorna um formatador com estado semelhante a esse formatador, mas com a cronologia de substituição definida. Por padrão, um formatador não tem cronologia de substituição, retornando nulo.

Se uma substituição for adicionada, qualquer data formatada ou analisada será afetada.

Ao formatar, se o objeto temporal contiver uma data, ele será convertido em uma data na cronologia de substituição. Se o temporal contém uma data é determinado consultando o ChronoField#EPOCH_DAY EPOCH_DAY campo. Qualquer fuso horário ou zona será mantido sem alterações, a menos que seja substituído.

Se o objeto temporal não contiver uma data, mas contiver um ou mais ChronoField campos de data, um DateTimeException será gerado. Em todos os outros casos, a cronologia de substituição é adicionada ao temporal, substituindo qualquer cronologia anterior, mas sem alterar a data/hora.

Ao analisar, há dois casos distintos a serem considerados. Se uma cronologia tiver sido analisada diretamente do texto, talvez porque DateTimeFormatterBuilder#appendChronologyId() tenha sido usada, essa cronologia de substituição não terá efeito. Se nenhuma zona tiver sido analisada, essa cronologia de substituição será usada para interpretar os ChronoField valores em uma data de acordo com as regras de resolução de data da cronologia.

Essa instância é imutável e não afetada por essa chamada de método.

Java documentação para java.time.format.DateTimeFormatter.withChronology(java.time.chrono.Chronology).

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.