ZonedDateTime Classe
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.
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como 2007-12-03T10:15:30+01:00 Europe/Paris.
[Android.Runtime.Register("java/time/ZonedDateTime", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class ZonedDateTime : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Time.Chrono.IChronoZonedDateTime[<Android.Runtime.Register("java/time/ZonedDateTime", ApiSince=26, DoNotGenerateAcw=true)>]
type ZonedDateTime = class
inherit Object
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IChronoZonedDateTime
interface IComparable
interface ITemporal
interface ITemporalAccessor- Herança
- Atributos
- Implementações
Comentários
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como 2007-12-03T10:15:30+01:00 Europe/Paris.
ZonedDateTime é uma representação imutável de uma data e hora com um fuso horário. Essa classe armazena todos os campos de data e hora, para uma precisão de nanossegundos e um fuso horário, com um deslocamento de zona usado para lidar com datas locais ambíguas. Por exemplo, o valor "2 de outubro de 2007 às 13:45.30.123456789 +02:00 no fuso horário da Europa/Paris" pode ser armazenado em um ZonedDateTime.
Essa classe manipula a conversão da linha de tempo local para LocalDateTime a linha de tempo instantânea de Instant. A diferença entre as duas linhas de tempo é o deslocamento de UTC/Greenwich, representado por um ZoneOffset.
A conversão entre as duas linhas de tempo envolve calcular o deslocamento usando o ZoneRules rules acesso do ZoneId. Obter o deslocamento para um instante é simples, pois há exatamente um deslocamento válido para cada instante. Por outro lado, obter o deslocamento para uma data e hora local não é simples. Há três casos: <ul><li>Normal, com um deslocamento válido. Para a grande maioria do ano, o caso normal se aplica, em que há um único deslocamento válido para a data e hora local.</li><li>Gap, sem deslocamentos válidos. É quando os relógios avançam normalmente devido à mudança do horário de verão da primavera de "inverno" para "verão". Em uma lacuna, há valores locais de data e hora sem deslocamento válido.</li li><>Sobreposição, com dois deslocamentos válidos. É quando os relógios são recuados normalmente devido à mudança do horário de verão de outono de "verão" para "inverno". Em uma sobreposição, há valores locais de data e hora com dois deslocamentos válidos.</li></ul>
Qualquer método que seja convertido direta ou implicitamente de uma data local em um instante obtendo o deslocamento tem o potencial de ser complicado.
Para o Gaps, a estratégia geral é que, se a data local cair no meio de uma Lacuna, a data-hora zoneada resultante terá uma data-hora local deslocada para frente pelo comprimento da Lacuna, resultando em uma data-hora no deslocamento posterior, normalmente hora de "verão".
Para Sobreposições, a estratégia geral é que, se a data/hora local cair no meio de uma Sobreposição, o deslocamento anterior será mantido. Se não houver nenhum deslocamento anterior ou o deslocamento anterior for inválido, o deslocamento anterior será usado, normalmente a hora de "verão". Dois métodos #withEarlierOffsetAtOverlap() adicionais e #withLaterOffsetAtOverlap()ajudam a gerenciar o caso de uma sobreposição.
Em termos de design, essa classe deve ser vista principalmente como a combinação de um LocalDateTime e um ZoneId. É ZoneOffset uma informação vital, mas secundária, usada para garantir que a classe represente um instante, especialmente durante uma sobreposição de horário de verão.
Adicionado em 1.8.
Documentação Java para java.time.ZonedDateTime.
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.
Propriedades
| Nome | Description |
|---|---|
| Class |
Retorna a classe de runtime deste |
| DayOfMonth |
Obtém o campo dia do mês. |
| DayOfWeek |
Obtém o campo dia da semana, que é uma enumeração DayOfWeek. |
| DayOfYear |
Obtém o campo dia do ano. |
| Handle |
O identificador para a instância subjacente do Android. (Herdado de Object) |
| Hour |
Obtém o campo de hora do dia. |
| JniIdentityHashCode |
Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object) |
| JniManagedPeerState |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| JniPeerMembers |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| Minute |
Obtém o campo de minuto de hora. |
| Month |
Obtém o campo mês do ano usando a enumeração Mês. |
| MonthValue |
Obtém o campo mês do ano de 1 a 12. |
| Nano |
Obtém o campo nano-de-segundo. |
| Offset |
Obtém o deslocamento de zona, como '+01:00'. |
| PeerReference |
Obtém a referência de objeto JNI para este par Java. (Herdado de Object) |
| Second |
Obtém o campo do segundo minuto. |
| ThresholdClass |
Essa API é compatível com a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código. (Herdado de Object) |
| ThresholdType |
Essa API é compatível com a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código. (Herdado de Object) |
| Year |
Obtém o campo de ano. |
| Zone |
Obtém o fuso horário, como "Europa/Paris". |
Métodos
| Nome | Description |
|---|---|
| Clone() |
Cria e retorna uma cópia desse objeto. (Herdado de Object) |
| CompareTo(Object) |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| Dispose() |
Libera os recursos mantidos por esse par Java. (Herdado de Object) |
| Dispose(Boolean) |
Libera os recursos mantidos por esse par Java. (Herdado de Object) |
| DisposeUnlessReferenced() |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| Equals(Object) |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| Equals(Object) |
Indica se algum outro objeto é "igual a" este. (Herdado de Object) |
| Format(DateTimeFormatter) |
Formata essa data e hora usando o formatador especificado. |
| From(ITemporalAccessor) |
Obtém uma instância de ZonedDateTime de um objeto temporal. |
| Get(ITemporalField) |
Obtém o valor do campo especificado desta data e hora como um int. |
| GetHashCode() |
Retorna um valor de código hash para o objeto. (Herdado de Object) |
| GetLong(ITemporalField) |
Obtém o valor do campo especificado a partir dessa data e hora como um longo. |
| IsSupported(ITemporalField) |
Verifica se há suporte para o campo especificado. |
| IsSupported(ITemporalUnit) |
Verifica se há suporte para a unidade especificada. |
| JavaFinalize() |
Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto. (Herdado de Object) |
| Minus(Int64, ITemporalUnit) |
Retorna uma cópia dessa data e hora com a quantidade especificada subtraída. |
| Minus(ITemporalAmount) |
Retorna uma cópia dessa data e hora com a quantidade especificada subtraída. |
| MinusDays(Int64) |
Retorna uma cópia deste ZonedDateTime com o número especificado de dias subtraídos. |
| MinusHours(Int64) |
Retorna uma cópia desse ZonedDateTime com o número de horas especificado subtraído. |
| MinusMinutes(Int64) |
Retorna uma cópia deste ZonedDateTime com o número especificado de minutos subtraído. |
| MinusMonths(Int64) |
Retorna uma cópia deste ZonedDateTime com o número especificado de meses subtraído. |
| MinusNanos(Int64) |
Retorna uma cópia deste ZonedDateTime com o número especificado de nanossegundos subtraídos. |
| MinusSeconds(Int64) |
Retorna uma cópia deste ZonedDateTime com o número especificado de segundos subtraído. |
| MinusWeeks(Int64) |
Retorna uma cópia deste ZonedDateTime com o número especificado de semanas subtraídas. |
| MinusYears(Int64) |
Retorna uma cópia deste ZonedDateTime com o número especificado de anos subtraído. |
| Notify() |
Ativa um único thread que está aguardando no monitor deste objeto. (Herdado de Object) |
| NotifyAll() |
Ativa todos os threads que estão aguardando no monitor deste objeto. (Herdado de Object) |
| Now() |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| Now(Clock) |
Obtém a data e hora atuais do relógio especificado. |
| Now(ZoneId) |
Obtém a data e hora atuais do relógio do sistema no fuso horário especificado. |
| Of(Int32, Int32, Int32, Int32, Int32, Int32, Int32, ZoneId) |
Obtém uma instância de ZonedDateTime de um ano, mês, dia, hora, minuto, segundo, nanossegundo e fuso horário. |
| Of(LocalDate, LocalTime, ZoneId) |
Obtém uma instância de ZonedDateTime de uma data e hora locais. |
| Of(LocalDateTime, ZoneId) |
Obtém uma instância de ZonedDateTime de uma data e hora local. |
| OfInstant(Instant, ZoneId) |
Obtém uma instância de ZonedDateTime de um Instantâneo. |
| OfInstant(LocalDateTime, ZoneOffset, ZoneId) |
Obtém uma instância de ZonedDateTime do instante formado combinando a data e o deslocamento locais. |
| OfLocal(LocalDateTime, ZoneId, ZoneOffset) |
Obtém uma instância de ZonedDateTime de uma data e hora local usando o deslocamento preferencial, se possível. |
| OfStrict(LocalDateTime, ZoneOffset, ZoneId) |
Obtém uma instância de ZonedDateTime validando estritamente a combinação de data e hora local, deslocamento e ID de zona. |
| Parse(ICharSequence, DateTimeFormatter) |
Obtém uma instância de ZonedDateTime de uma cadeia de caracteres de texto usando um formatador específico. |
| Parse(ICharSequence) |
Obtém uma instância de ZonedDateTime de uma cadeia de texto como 2007-12-03T10:15:30+01:00[Europa/Paris]. |
| Parse(String, DateTimeFormatter) |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| Parse(String) |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| Plus(Int64, ITemporalUnit) |
Retorna uma cópia dessa data e hora com o valor especificado adicionado. |
| Plus(ITemporalAmount) |
Retorna uma cópia dessa data e hora com o valor especificado adicionado. |
| PlusDays(Int64) |
Retorna uma cópia deste ZonedDateTime com o número especificado de dias adicionados. |
| PlusHours(Int64) |
Retorna uma cópia desse ZonedDateTime com o número especificado de horas adicionadas. |
| PlusMinutes(Int64) |
Retorna uma cópia deste ZonedDateTime com o número especificado de minutos adicionados. |
| PlusMonths(Int64) |
Retorna uma cópia deste ZonedDateTime com o número especificado de meses adicionado. |
| PlusNanos(Int64) |
Retorna uma cópia deste ZonedDateTime com o número especificado de nanossegundos adicionados. |
| PlusSeconds(Int64) |
Retorna uma cópia desse ZonedDateTime com o número especificado de segundos adicionado. |
| PlusWeeks(Int64) |
Retorna uma cópia deste ZonedDateTime com o número especificado de semanas adicionadas. |
| PlusYears(Int64) |
Retorna uma cópia desse ZonedDateTime com o número especificado de anos adicionado. |
| Query(ITemporalQuery) |
Consulta essa data e hora usando a consulta especificada. |
| Range(ITemporalField) |
Obtém o intervalo de valores válidos para o campo especificado. |
| SetHandle(IntPtr, JniHandleOwnership) |
Define a propriedade Handle (Herdado de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| ToArray<T>() |
Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (Herdado de Object) |
| ToLocalDate() |
Obtém a parte LocalDate desta data e hora. |
| ToLocalDateTime() |
Obtém a parte LocalDateTime desta data e hora. |
| ToLocalTime() |
Obtém a parte LocalTime desta data e hora. |
| ToOffsetDateTime() |
Converte essa data e hora em um OffsetDateTime. |
| ToString() |
Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object) |
| TruncatedTo(ITemporalUnit) |
Retorna uma cópia deste ZonedDateTime com o tempo truncado. |
| UnregisterFromRuntime() |
Cancela o registro desse par Java do runtime de interoperabilidade. (Herdado de Object) |
| Until(ITemporal, ITemporalUnit) |
Calcula a quantidade de tempo até outra data e hora em termos da unidade especificada. |
| Wait() |
Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<> (Herdado de Object) |
| Wait(Int64, Int32) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
| Wait(Int64) |
Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object) |
| 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. |
| WithDayOfMonth(Int32) |
Retorna uma cópia deste ZonedDateTime com o dia do mês alterado. |
| WithDayOfYear(Int32) |
Retorna uma cópia deste ZonedDateTime com o dia do ano alterado. |
| WithEarlierOffsetAtOverlap() |
Retorna uma cópia dessa data-hora alterando o deslocamento de zona para o anterior dos dois deslocamentos válidos em uma sobreposição de linha de tempo local. |
| WithFixedOffsetZone() |
Retorna uma cópia dessa data e hora com a ID de zona definida como o deslocamento. |
| WithHour(Int32) |
Retorna uma cópia deste ZonedDateTime com a hora do dia alterada. |
| WithLaterOffsetAtOverlap() |
Retorna uma cópia dessa data e hora alterando o deslocamento de zona para o final dos dois deslocamentos válidos em uma sobreposição de linha de tempo local. |
| WithMinute(Int32) |
Retorna uma cópia deste ZonedDateTime com o minuto de hora alterado. |
| WithMonth(Int32) |
Retorna uma cópia deste ZonedDateTime com o mês do ano alterado. |
| WithNano(Int32) |
Retorna uma cópia deste ZonedDateTime com o nano-de-segundo alterado. |
| WithSecond(Int32) |
Retorna uma cópia deste ZonedDateTime com o segundo minuto alterado. |
| WithYear(Int32) |
Retorna uma cópia deste ZonedDateTime com o ano alterado. |
| WithZoneSameInstant(ZoneId) |
Retorna uma cópia dessa data e hora com um fuso horário diferente, mantendo o instantâneo. |
| WithZoneSameLocal(ZoneId) |
Retorna uma cópia dessa data e hora com um fuso horário diferente, mantendo a data e hora local, se possível. |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IChronoZonedDateTime.Plus(Int64, ITemporalUnit) |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| IChronoZonedDateTime.ToLocalDateTime() |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| IChronoZonedDateTime.With(ITemporalField, Int64) |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| IChronoZonedDateTime.WithEarlierOffsetAtOverlap() |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| IChronoZonedDateTime.WithLaterOffsetAtOverlap() |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| IChronoZonedDateTime.WithZoneSameInstant(ZoneId) |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| IChronoZonedDateTime.WithZoneSameLocal(ZoneId) |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| IJavaPeerable.Disposed() |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| IJavaPeerable.Finalized() |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| IJavaPeerable.JniObjectReferenceControlBlock |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| IJavaPeerable.UnregisterFromRuntime() |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
Métodos de Extensão
| Nome | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtém o nome JNI do tipo da instância |
| JavaAs<TResult>(IJavaPeerable) |
Tente coagir a digitar |
| JavaCast<TResult>(IJavaObject) |
Executa uma conversão de tipo marcada por runtime do Android. |
| JavaCast<TResult>(IJavaObject) |
Uma data e hora com um fuso horário no sistema de calendário ISO-8601, como |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Tente coagir a digitar |