ITemporal Interface

Referência

Definição

Namespace:: Java.Time.Temporal

Assembly:: Mono.Android.dll

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.

Interface em nível de estrutura que define o acesso de leitura-gravação a um objeto temporal, como data, hora, deslocamento ou alguma combinação destes.

[Android.Runtime.Register("java/time/temporal/Temporal", "", "Java.Time.Temporal.ITemporalInvoker", ApiSince=26)]
public interface ITemporal : IDisposable, Java.Interop.IJavaPeerable, Java.Time.Temporal.ITemporalAccessor

[<Android.Runtime.Register("java/time/temporal/Temporal", "", "Java.Time.Temporal.ITemporalInvoker", ApiSince=26)>]
type ITemporal = interface
    interface ITemporalAccessor
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Derivado: Java.Time.Chrono.IChronoLocalDate

Java.Time.Chrono.IChronoLocalDateTime

Java.Time.Chrono.IChronoZonedDateTime

Java.Time.Instant

Java.Time.LocalDate

Mais…

Atributos: RegisterAttribute

Implementações: IJavaObject IJavaPeerable ITemporalAccessor IDisposable

Comentários

Interface em nível de estrutura que define o acesso de leitura-gravação a um objeto temporal, como data, hora, deslocamento ou alguma combinação destes.

Este é o tipo de interface base para objetos de data, hora e deslocamento que são completos o suficiente para serem manipulados usando mais e menos. Ele é implementado por essas classes que podem fornecer e manipular informações como campos TemporalField ou consultas TemporalQuery. Consulte TemporalAccessor a versão somente leitura desta interface.

A maioria das informações de data e hora pode ser representada como um número. Eles são modelados usando TemporalField com o número mantido usando um long para manipular valores grandes. Ano, mês e dia do mês são exemplos simples de campos, mas também incluem instantâneos e deslocamentos. Consulte ChronoField o conjunto padrão de campos.

Duas partes de informações de data/hora não podem ser representadas por números, a cronologia java.time.chrono.Chronology e o fuso horário java.time.ZoneId. Estes podem ser acessados através #query(TemporalQuery) queries do uso dos métodos estáticos definidos no TemporalQuery.

Essa interface é uma interface de nível de estrutura que não deve ser amplamente usada no código do aplicativo. Em vez disso, os aplicativos devem criar e transmitir instâncias de tipos concretos, como LocalDate. Há muitas razões para isso, parte das quais é que as implementações dessa interface podem estar em sistemas de calendário diferentes do ISO. Veja java.time.chrono.ChronoLocalDate para uma discussão mais completa das questões.

<h2>Quando implementar</h2>

Uma classe deve implementar essa interface se atender a três critérios: <ul><li>ela fornece acesso a informações de data/hora/deslocamento, pois por TemporalAccessor<li>o conjunto de campos é contíguo do maior para o menor <li>o conjunto de campos está completo, de modo que nenhum outro campo é necessário para definir o intervalo válido de valores para os campos que são representados </ul>

Quatro exemplos deixam isso claro: ul><li>LocalDate implementa essa interface, <pois ela representa um conjunto de campos que são contíguos de dias para sempre e não exigem informações externas para determinar a validade de cada data. Portanto, é capaz de implementar mais/menos corretamente. <O LI>LocalTime implementa essa interface, pois ela representa um conjunto de campos que são contíguos de nanos a dentro de dias e não exigem informações externas para determinar a validade. Ele é capaz de implementar mais/menos corretamente, enrolando ao redor do dia. <li>MonthDay, a combinação de mês-do-ano e dia-do-mês, não implementa essa interface. Embora a combinação seja contígua, de dias a meses dentro de anos, a combinação não tem informações suficientes para definir o intervalo válido de valores para o dia-do-mês. Como tal, é incapaz de implementar mais/menos corretamente. <li>A combinação dia-da-semana e dia-do-mês ("sexta-feira 13") não deve implementar esta interface. Não representa um conjunto contíguo de campos, pois dias a semanas se sobrepõem dias a meses. </ul>

Adicionado em 1.8.

Documentação Java para java.time.temporal.Temporal.

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.

Propriedades

Handle	Obtém o valor JNI do objeto Android subjacente. (Herdado de IJavaObject)
JniIdentityHashCode	Retorna o valor de `java.lang.System.identityHashCode()` para a instância encapsulada. (Herdado de IJavaPeerable)
JniManagedPeerState	Estado do par gerenciado. (Herdado de IJavaPeerable)
JniPeerMembers	Acesso de membros e suporte à invocação. (Herdado de IJavaPeerable)
PeerReference	Retorna uma JniObjectReference das instâncias do objeto Java encapsulado. (Herdado de IJavaPeerable)

Métodos

Disposed()	Chamado quando a instância tiver sido descartada. (Herdado de IJavaPeerable)
DisposeUnlessReferenced()	Se não houver referências pendentes a este caso, então chame `Dispose()`, caso contrário, não faz nada. (Herdado de IJavaPeerable)
Finalized()	Chamado quando a instância tiver sido finalizada. (Herdado de IJavaPeerable)
Get(ITemporalField)	Obtém o valor do campo especificado como um `int`arquivo . (Herdado de ITemporalAccessor)
GetLong(ITemporalField)	Obtém o valor do campo especificado como um `long`arquivo . (Herdado de ITemporalAccessor)
IsSupported(ITemporalField)	Verifica se o campo especificado é suportado. (Herdado de ITemporalAccessor)
IsSupported(ITemporalUnit)	Verifica se a unidade especificada é suportada.
Minus(Int64, ITemporalUnit)	Retorna um objeto do mesmo tipo que esse objeto com o período especificado subtraído.
Minus(ITemporalAmount)	Retorna um objeto do mesmo tipo que esse objeto com um valor subtraído.
Plus(Int64, ITemporalUnit)	Retorna um objeto do mesmo tipo que esse objeto com o período especificado adicionado.
Plus(ITemporalAmount)	Retorna um objeto do mesmo tipo que esse objeto com um valor adicionado.
Query(ITemporalQuery)	Consulta esta data-hora. (Herdado de ITemporalAccessor)
Range(ITemporalField)	Obtém o intervalo de valores válidos para o campo especificado. (Herdado de ITemporalAccessor)
SetJniIdentityHashCode(Int32)	Defina o valor retornado por `JniIdentityHashCode`. (Herdado de IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Interface em nível de estrutura que define o acesso de leitura-gravação a um objeto temporal, como data, hora, deslocamento ou alguma combinação destes. (Herdado de IJavaPeerable)
SetPeerReference(JniObjectReference)	Defina o valor retornado por `PeerReference`. (Herdado de IJavaPeerable)
UnregisterFromRuntime()	Cancele o registro dessa instância para que o tempo de execução não a retorne de chamadas futuras Java.Interop.JniRuntime+JniValueManager.PeekValue . (Herdado de IJavaPeerable)
Until(ITemporal, ITemporalUnit)	Calcula a quantidade de tempo até outro temporal em termos da unidade especificada.
With(ITemporalAdjuster)	Retorna um objeto ajustado do mesmo tipo que esse objeto com o ajuste feito.
With(ITemporalField, Int64)	Retorna um objeto do mesmo tipo que esse objeto com o campo especificado alterado.

Métodos de Extensão

JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo verificada em tempo de execução do Android.
JavaCast<TResult>(IJavaObject)	Interface em nível de estrutura que define o acesso de leitura-gravação a um objeto temporal, como data, hora, deslocamento ou alguma combinação destes.
GetJniTypeName(IJavaPeerable)	Interface em nível de estrutura que define o acesso de leitura-gravação a um objeto temporal, como data, hora, deslocamento ou alguma combinação destes.

Aplica-se a

Compartilhar via