DateTimeFormatter.WithZone(ZoneId) Método

[Android.Runtime.Register("withZone", "(Ljava/time/ZoneId;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithZone(Java.Time.ZoneId? zone);

[<Android.Runtime.Register("withZone", "(Ljava/time/ZoneId;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithZone : Java.Time.ZoneId -> Java.Time.Format.DateTimeFormatter

Parâmetros

Retornos

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

Atributos

RegisterAttribute

Comentários

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

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

Se uma substituição for adicionada, qualquer instante formatado ou analisado será afetado.

Ao formatar, se o objeto temporal contiver um instante, ele será convertido em uma data-hora zoneada usando a zona de substituição. Se o temporal é um instante é determinado consultando o ChronoField#INSTANT_SECONDS INSTANT_SECONDS campo. Se a entrada tiver uma cronologia, ela será mantida, a menos que seja substituída. Se a entrada não tiver uma cronologia, como Instant, a cronologia ISO será usada.

Se o objeto temporal não contiver um instante, mas contiver um deslocamento, uma verificação adicional será feita. Se a zona de substituição normalizada for um deslocamento diferente do deslocamento do temporal, uma DateTimeException será gerada. Em todos os outros casos, a zona de substituição é adicionada ao temporal, substituindo qualquer zona anterior, mas sem alterar a data/hora.

Ao analisar, há dois casos distintos a serem considerados. Se uma zona tiver sido analisada diretamente do texto, talvez porque DateTimeFormatterBuilder#appendZoneId() tenha sido usada, essa zona de substituição não terá efeito. Se nenhuma zona tiver sido analisada, essa zona de substituição será incluída no resultado da análise em que ela pode ser usada para criar instantâneos e datas.

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

Java documentação para java.time.format.DateTimeFormatter.withZone(java.time.ZoneId).

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.