OffsetDateTime.With Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| 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. |
With(ITemporalAdjuster)
Retorna uma cópia ajustada desta data e hora.
[Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/OffsetDateTime;", "", ApiSince=26)]
public Java.Time.OffsetDateTime? With(Java.Time.Temporal.ITemporalAdjuster? adjuster);
[<Android.Runtime.Register("with", "(Ljava/time/temporal/TemporalAdjuster;)Ljava/time/OffsetDateTime;", "", ApiSince=26)>]
member this.With : Java.Time.Temporal.ITemporalAdjuster -> Java.Time.OffsetDateTime
Parâmetros
- adjuster
- ITemporalAdjuster
o ajustador a ser usado, não nulo
Retornos
um OffsetDateTime com base nisso com o ajuste feito, não nulo
- Atributos
Comentários
Retorna uma cópia ajustada desta data e hora. Isso retorna um OffsetDateTime, 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, LocalTime e ZoneOffset implementam TemporalAdjuster, portanto, esse método pode ser usado para alterar a data, hora ou deslocamento: 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.OffsetDateTime.with.
Aplica-se a
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/OffsetDateTime;", "", 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/OffsetDateTime;", "", 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
um OffsetDateTime com base nisso com o conjunto de campos especificado, não nulo
Implementações
- Atributos
Comentários
Retorna uma cópia dessa data e hora com o campo especificado definido como um novo valor. Isso retorna um OffsetDateTime, 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. O deslocamento e o nano-de-segundo estão inalterados. Se o novo valor instantâneo estiver fora do intervalo válido, um DateTimeException será gerado. O campo OFFSET_SECONDS retornará uma data e hora com o deslocamento especificado. A data/hora local não está marcada. 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. Nesse caso, o deslocamento não faz parte do cálculo e não será alterado. 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.OffsetDateTime.with.