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 baseado nesse formatador com a zona de substituição solicitada, não nula

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 null.

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, então 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, então um DateTimeException será lançado. 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 foi analisada diretamente do texto, talvez porque DateTimeFormatterBuilder#appendZoneId() foi usada, então essa zona de substituição não tem efeito. Se nenhuma zona tiver sido analisada, essa zona de substituição será incluída no resultado da análise, onde poderá ser usada para criar instantes e datas-horas.

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

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

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

Aplica-se a