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

JavaObject

Object

SystemClock

Atributos

RegisterAttribute

Comentários

Principais instalações de manutenção de tempo.

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

<ul><li>

System#currentTimeMillis System.currentTimeMillis() é o relógio "wall" padrão (hora e data) expressando milissegundos desde a época. O relógio de parede pode ser definido pelo usuário ou pela rede telefônica (veja #setCurrentTimeMillis), portanto, 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 horários reais é importante, como em um aplicativo de calendário ou de alarme. As medidas de tempo decorrido ou intervalo devem usar um relógio diferente. Se você estiver usando System.currentTimeMillis(), considere a escuta e android.content.Intent#ACTION_TIME_TICK ACTION_TIME_TICKandroid.content.Intent#ACTION_TIME_CHANGED ACTION_TIME_CHANGEDandroid.content.Intent#ACTION_TIMEZONE_CHANGED ACTION_TIMEZONE_CHANGEDandroid.content.Intent Intent as transmissões para descobrir quando o tempo é alterado.

<li>

#uptimeMillis é contado em milissegundos desde que o sistema foi inicializado. Esse relógio para quando o sistema entra em suspensão profunda (CPU desativada, exibe escuro, dispositivo aguardando entrada externa), mas não é afetado pelo dimensionamento do relógio, ocioso ou outros mecanismos de economia de energia. Essa é a base para a maioria dos intervalos de tempo, como Thread#sleep(long) Thread.sleep(millis), Object#wait(long) Object.wait(millis)e System#nanoTime System.nanoTime(). Esse relógio tem a garantia de ser monotônica e é adequado para o intervalo de tempo quando o intervalo não abrange o suspensão 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 retorne o tempo desde que o sistema foi inicializado e inclua o sono profundo. Esse relógio tem a garantia de ser monotônica e continua a funcionar mesmo quando a CPU está em modos de economia de energia, portanto, é a base recomendada para o intervalo de finalidade geral.

</ul>

Há vários mecanismos para controlar o tempo de eventos:

<ul><li>

As funções padrão gostam 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 seja ativado. Essas funções síncronas podem ser interrompidas com Thread#interrupt Thread.interrupt(), e você deve manipular InterruptedException.

<li>

#sleep SystemClock.sleep(millis) é uma função de utilitário muito semelhante a 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 momento absoluto ou relativo. Os objetos do manipulador também usam o #uptimeMillis relógio e exigem um android.os.Looper event loop (normalmente presente em qualquer aplicativo de GUI).

<li>

É android.app.AlarmManager possível 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 transmissão android.content.Intent quando ocorrerem. </ul>

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

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.