Clock Classe

Definição

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

[Android.Runtime.Register("java/time/Clock", ApiSince=26, DoNotGenerateAcw=true)]
public abstract class Clock : Java.Lang.Object, IDisposable, Java.Time.IInstantSource
[<Android.Runtime.Register("java/time/Clock", ApiSince=26, DoNotGenerateAcw=true)>]
type Clock = class
    inherit Object
    interface IInstantSource
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
Herança
Atributos
Implementações

Comentários

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

As instâncias dessa classe abstrata são usadas para acessar uma representação plugável do instantâneo atual, que pode ser interpretada usando o fuso horário armazenado para localizar a data e a hora atuais. Por exemplo, Clock pode ser usado em vez de System#currentTimeMillis() e TimeZone#getDefault().

O uso de um Clock é opcional. Todas as principais classes de data e hora também têm um now() método de fábrica que usa o relógio do sistema no fuso horário padrão. A principal finalidade dessa abstração é permitir que relógios alternativos sejam conectados como e quando necessário. Os aplicativos usam um objeto para obter a hora atual em vez de um método estático. Isso pode simplificar o teste.

Dessa forma, essa classe abstrata não garante que o resultado represente o instante atual na linha do tempo. Em vez disso, ele permite que o aplicativo forneça uma exibição controlada sobre qual é o fuso horário e o instantâneo atual.

A melhor prática para aplicativos é passar um Clock método para qualquer método que exija o fuso horário e instantâneo atual. Uma estrutura de injeção de dependência é uma maneira de fazer isso:

public class MyBean {
               private Clock clock;  // dependency inject
               ...
               public void process(LocalDate eventDate) {
                 if (eventDate.isBefore(LocalDate.now(clock)) {
                   ...
                 }
               }
             }

Essa abordagem permite que um relógio alternativo, como #fixed(Instant, ZoneId) fixed ou #offset(Clock, Duration) offset seja, seja usado durante o teste.

Os system métodos de fábrica fornecem relógios com base no melhor relógio do sistema disponível. Isso pode usar System#currentTimeMillis()um relógio de resolução mais alta se um estiver disponível.

Adicionado em 1.8.

Java documentação para java.time.Clock.

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.

Construtores

Nome Description
Clock()

Construtor acessível por subclasses.

Clock(IntPtr, JniHandleOwnership)

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

Propriedades

Nome Description
Class

Retorna a classe de tempo de execução deste Object.

(Herdado de Object)
Handle

O identificador para a instância subjacente do Android.

(Herdado de Object)
JniIdentityHashCode

Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade.

(Herdado de Object)
JniManagedPeerState

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

(Herdado de JavaObject)
JniPeerMembers

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

PeerReference

Obtém a referência de objeto JNI para este par Java.

(Herdado de Object)
ThresholdClass

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

ThresholdType

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

Zone

Obtém o fuso horário que está sendo usado para criar datas e horas.

Métodos

Nome Description
Clone()

Cria e retorna uma cópia desse objeto.

(Herdado de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

(Herdado de JavaObject)
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()

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

(Herdado de JavaObject)
Equals(Object)

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

(Herdado de JavaObject)
Equals(Object)

Indica se algum outro objeto é "igual a" este.

(Herdado de Object)
Fixed(Instant, ZoneId)

Obtém um relógio que sempre retorna o mesmo instante.

GetHashCode()

Retorna um valor de código hash para o objeto.

(Herdado de Object)
Instant()

Obtém o instante atual do relógio.

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)
Millis()

Obtém o instante de milissegundo atual do relógio.

Notify()

Ativa um único thread que está aguardando no monitor desse objeto.

(Herdado de Object)
NotifyAll()

Ativa todos os threads que estão aguardando no monitor deste objeto.

(Herdado de Object)
Offset(Clock, Duration)

Obtém um relógio que retorna instantâneos do relógio especificado com a duração especificada adicionada.

SetHandle(IntPtr, JniHandleOwnership)

Define a propriedade Handle

(Herdado de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

(Herdado de JavaObject)
System(ZoneId)

Obtém um relógio que retorna o instantâneo atual usando o melhor relógio do sistema disponível.

SystemDefaultZone()

Obtém um relógio que retorna o instantâneo atual usando o melhor relógio do sistema disponível, convertendo em data e hora usando o fuso horário padrão.

SystemUTC()

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

Tick(Clock, Duration)

Obtém um relógio que retorna instantâneos do relógio especificado truncado para a ocorrência mais próxima da duração especificada.

TickMillis(ZoneId)

Obtém um relógio que retorna o tique instantâneo atual em milissegundos inteiros usando o melhor relógio do sistema disponível.

TickMinutes(ZoneId)

Obtém um relógio que retorna o tique instantâneo atual em minutos inteiros usando o melhor relógio do sistema disponível.

TickSeconds(ZoneId)

Obtém um relógio que retorna o tique instantâneo atual em segundos inteiros usando o melhor relógio do sistema disponível.

ToArray<T>()

Cria uma matriz gerenciada com base nesse wrapper de matriz Java.

(Herdado de Object)
ToString()

Retorna uma representação de cadeia de caracteres do objeto.

(Herdado de Object)
UnregisterFromRuntime()

Cancela o registro desse par Java do runtime de interoperabilidade.

(Herdado de Object)
Wait()

Faz com que o thread atual aguarde até que seja despertado, normalmente sendo <notificado></em> ou <em>interrompido</em>.

(Herdado de Object)
Wait(Int64, Int32)

Faz com que o thread atual aguarde até que seja ativado, normalmente sendo <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 seja ativado, normalmente sendo <notificado></em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido.

(Herdado de Object)
WithZone(ZoneId)

Retorna uma cópia deste relógio com um fuso horário diferente.

Implantações explícitas de interface

Nome Description
IJavaPeerable.Disposed()

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

(Herdado de JavaObject)
IJavaPeerable.Finalized()

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

(Herdado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

(Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

(Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

(Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

(Herdado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

Métodos de Extensão

Nome Description
GetJniTypeName(IJavaPeerable)

Obtém o nome JNI do tipo da instância self.

JavaAs<TResult>(IJavaPeerable)

Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.

JavaCast<TResult>(IJavaObject)

Executa uma conversão de tipo marcada por runtime do Android.

JavaCast<TResult>(IJavaObject)

Um relógio que fornece acesso ao instantâneo, à data e à hora atuais usando um fuso horário.

TryJavaCast<TResult>(IJavaPeerable, TResult)

Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.

Aplica-se a