ZonedDateTime.With Método

Definição

Namespace:
Java.Time
Assembly:
Mono.Android.dll

Sobrecargas

Nome Description
With(ITemporalField, Int64)

Retorna uma cópia dessa data e hora com o campo especificado definido como um novo valor.
With(ITemporalAdjuster)

Retorna uma cópia ajustada desta data e hora.

With(ITemporalField, Int64)

Retorna uma cópia dessa data e hora com o campo especificado definido como um novo valor.

[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/ZonedDateTime;", "", ApiSince=26)]
public Java.Time.Temporal.ITemporal? With(Java.Time.Temporal.ITemporalField? field, long newValue);
[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalField;J)Ljava/time/ZonedDateTime;", "", ApiSince=26)>]
abstract member With : Java.Time.Temporal.ITemporalField * int64 -> Java.Time.Temporal.ITemporal
override this.With : Java.Time.Temporal.ITemporalField * int64 -> Java.Time.Temporal.ITemporal

Parâmetros

field
ITemporalField

o campo a ser definido no resultado, não nulo

newValue
Int64

o novo valor do campo no resultado

Retornos

ITemporal

um ZonedDateTime com base nisso com o conjunto de campos especificado, não nulo

Atributos
RegisterAttribute

Comentários

Retorna uma cópia dessa data e hora com o campo especificado definido como um novo valor. Isso retorna um ZonedDateTime, com base neste, com o valor do campo especificado alterado. Isso pode ser usado para alterar qualquer campo com suporte, como o ano, mês ou dia do mês. Se não for possível definir o valor, porque o campo não tem suporte ou por algum outro motivo, uma exceção é gerada. Em alguns casos, alterar o campo especificado pode fazer com que a data-hora resultante se torne inválida, como alterar o mês de 31 de janeiro para fevereiro tornaria o dia do mês inválido. Em casos como esse, o campo é responsável por resolver a data. Normalmente, ele escolherá a data válida anterior, que seria o último dia válido de fevereiro neste exemplo. Se o campo for um ChronoField, o ajuste será implementado aqui. O campo INSTANT_SECONDS retornará uma data e hora com o instante especificado. A zona e o nano-de-segundo não são alterados. O resultado terá um deslocamento derivado da nova zona instantânea e original. Se o novo valor instantâneo estiver fora do intervalo válido, um DateTimeException será gerado. O campo OFFSET_SECONDS normalmente será ignorado. O deslocamento de um ZonedDateTime é controlado principalmente pelo fuso horário. Dessa forma, a alteração do deslocamento geralmente não faz sentido, pois há apenas um deslocamento válido para a data e o fuso horário local. Se a data-hora zoneada estiver em uma sobreposição de horário de verão, o deslocamento será usado para alternar entre os dois deslocamentos válidos. Em todos os outros casos, o deslocamento é ignorado. Se o novo valor de deslocamento estiver fora do intervalo válido, um DateTimeException será gerado. Os outros campos com suporte se comportarão de acordo com o método correspondente em LocalDateTime. A zona não faz parte do cálculo e não será alterada. Ao converter de volta em ZonedDateTime, se a data local estiver em uma sobreposição, o deslocamento será mantido, se possível, caso contrário, o deslocamento anterior será usado. Se estiver em uma lacuna, a data e hora local serão ajustadas para frente pelo comprimento da lacuna. Todas as outras instâncias de ChronoField lançarão um UnsupportedTemporalTypeException. Se o campo não for um ChronoField, o resultado desse método será obtido invocando TemporalField.adjustInto(Temporal, long) passando isso como o argumento. Nesse caso, o campo determina se e como ajustar o instantâneo. Essa instância é imutável e não afetada por essa chamada de método.

Java referência para java.time.ZonedDateTime.with.

Aplica-se a

With(ITemporalAdjuster)

Retorna uma cópia ajustada desta data e hora.

[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/ZonedDateTime;", "", ApiSince=26)]
public Java.Time.ZonedDateTime? With(Java.Time.Temporal.ITemporalAdjuster? adjuster);
[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/ZonedDateTime;", "", ApiSince=26)>]
member this.With : Java.Time.Temporal.ITemporalAdjuster -> Java.Time.ZonedDateTime

Parâmetros

adjuster
ITemporalAdjuster

o ajustador a ser usado, não nulo

Retornos

ZonedDateTime

um ZonedDateTime com base nisso com o ajuste feito, não nulo

Atributos
RegisterAttribute

Comentários

Retorna uma cópia ajustada desta data e hora. Isso retorna um ZonedDateTime, com base neste, com a data e hora ajustadas. O ajuste ocorre usando o objeto de estratégia do ajustador especificado. Leia a documentação do ajustador para entender qual ajuste será feito. Um ajuste simples pode simplesmente definir um dos campos, como o campo de ano. Um ajustador mais complexo pode definir a data para o último dia do mês. Uma seleção de ajustes comuns é fornecida em TemporalAdjusters. Isso inclui encontrar o "último dia do mês" e "na próxima quarta-feira". As principais classes de data e hora também implementam a interface TemporalAdjuster, como Month e MonthDay. O ajustador é responsável por lidar com casos especiais, como os diferentes períodos de meses e anos bissextos. Por exemplo, este código retorna uma data no último dia de julho: as classes LocalDate e LocalTime implementam TemporalAdjuster, portanto, esse método pode ser usado para alterar a data, hora ou deslocamento: ZoneOffset também implementa TemporalAdjuster, no entanto, usá-lo como um argumento normalmente não tem efeito. O deslocamento de um ZonedDateTime é controlado principalmente pelo fuso horário. Dessa forma, a alteração do deslocamento geralmente não faz sentido, pois há apenas um deslocamento válido para a data e o fuso horário local. Se a data-hora zoneada estiver em uma sobreposição de horário de verão, o deslocamento será usado para alternar entre os dois deslocamentos válidos. Em todos os outros casos, o deslocamento é ignorado. O resultado desse método é obtido invocando o método TemporalAdjuster.adjustInto(Temporal) no ajustador especificado passando isso como o argumento. Essa instância é imutável e não afetada por essa chamada de método.

Java referência para java.time.ZonedDateTime.with.

Aplica-se a