SystemClock Classe

Definição

[Android.Runtime.Register("android/os/SystemClock", DoNotGenerateAcw=true)]
public sealed class SystemClock : Java.Lang.Object

[<Android.Runtime.Register("android/os/SystemClock", DoNotGenerateAcw=true)>]
type SystemClock = class
    inherit Object

Herança

Object

Object

SystemClock

Atributos

RegisterAttribute

Comentários

Instalações centrais de cronometragem.

Três relógios diferentes estão disponíveis, e eles não devem ser confundidos:

<><Ul li>

System#currentTimeMillis System.currentTimeMillis() é o relógio de "parede" padrão (hora e data) que expressa milissegundos desde a época. O relógio de parede pode ser ajustado pelo usuário ou pela rede telefônica (veja #setCurrentTimeMillis), de modo que o tempo pode saltar para trás ou para frente de forma imprevisível. Esse relógio só deve ser usado quando a correspondência com datas e horas do mundo real for importante, como em um aplicativo de calendário ou despertador. As medições de intervalo ou tempo decorrido devem usar um relógio diferente. Se você estiver usando System.currentTimeMillis(), considere ouvir o android.content.Intent#ACTION_TIME_TICK ACTION_TIME_TICK, android.content.Intent#ACTION_TIME_CHANGED ACTION_TIME_CHANGED e android.content.Intent#ACTION_TIMEZONE_CHANGED ACTION_TIMEZONE_CHANGEDandroid.content.Intent Intent transmissões para descobrir quando a hora muda.

<li>

#uptimeMillis é contado em milissegundos desde que o sistema foi inicializado. Esse relógio pára quando o sistema entra em suspensão profunda (CPU desligada, tela escura, dispositivo aguardando entrada externa), mas não é afetado pelo dimensionamento do relógio, ociosidade ou outros mecanismos de economia de energia. Essa é a base para a maioria dos intervalos de tempo, como Thread#sleep(long) Thread.sleep(millls), Object#wait(long) Object.wait(millis)e System#nanoTime System.nanoTime(). Este relógio é garantido para ser monotônico, e é adequado para o tempo de intervalo quando o intervalo não abrange o sono do dispositivo. A maioria dos métodos que aceitam um valor de carimbo de data/hora atualmente esperam o #uptimeMillis relógio.

<li>

#elapsedRealtime e #elapsedRealtimeNanos retornar o tempo desde que o sistema foi inicializado, e incluir o sono profundo. Este relógio é garantido para ser monotônico, e continua a marcar mesmo quando a CPU está em modos de economia de energia, por isso é a base recomendada para o tempo de intervalo de uso geral.

</ul>

Existem vários mecanismos para controlar o tempo dos eventos:

<><Ul li>

Funções padrão como Thread#sleep(long) Thread.sleep(millis) e Object#wait(long) Object.wait(millis) estão sempre disponíveis. Essas funções usam o #uptimeMillis relógio, se o dispositivo entrar em suspensão, o restante do tempo será adiado até que o dispositivo acorde. Essas funções síncronas podem ser interrompidas com Thread#interrupt Thread.interrupt()o , e você deve manipular InterruptedExceptiono .

<li>

#sleep SystemClock.sleep(millis) é uma função de utilidade muito semelhante ao Thread#sleep(long) Thread.sleep(millis), mas ignora InterruptedException. Use essa função para atrasos se você não usar Thread#interrupt Thread.interrupt(), pois ela preservará o estado interrompido do thread.

<li>

A android.os.Handler classe pode agendar retornos de chamada assíncronos em um tempo absoluto ou relativo. Os objetos manipuladores também usam o #uptimeMillis relógio e exigem um android.os.Looper event loop (normalmente presente em qualquer aplicativo GUI).

<li>

O android.app.AlarmManager pode disparar eventos únicos ou recorrentes que ocorrem mesmo quando o dispositivo está em suspensão profunda ou seu aplicativo não está em execução. Os eventos podem ser agendados com sua escolha de java.lang.System#currentTimeMillis (RTC) ou #elapsedRealtime (ELAPSED_REALTIME) e causar uma android.content.Intent transmissão quando ocorrem. </ul>

Documentação Java para android.os.SystemClock.

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

Métodos

Implantações explícitas de interface

Métodos de Extensão

Aplica-se a