SystemClock Classe

Définition

[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

Héritage

Object

JavaObject

Object

SystemClock

Attributs

RegisterAttribute

Remarques

Installations de gestion des temps de base.

Trois horloges différentes sont disponibles et elles ne doivent pas être confondues :

<ul><li>

System#currentTimeMillis System.currentTimeMillis() est l’horloge « wall » standard (heure et date) exprimant des millisecondes depuis l’époque. L’horloge murale peut être définie par l’utilisateur ou le réseau téléphonique (voir #setCurrentTimeMillis), de sorte que le temps peut sauter vers l’arrière ou l’avant de manière imprévisible. Cette horloge ne doit être utilisée que lorsque la correspondance avec des dates et des heures réelles est importante, comme dans une application de calendrier ou d’horloge d’alarme. Les mesures d’intervalle ou de temps écoulé doivent utiliser une horloge différente. Si vous utilisez System.currentTimeMillis(), envisagez d’écouter les android.content.Intent#ACTION_TIME_TICK ACTION_TIME_TICKémissions android.content.Intent#ACTION_TIME_CHANGED ACTION_TIME_CHANGED et android.content.Intent#ACTION_TIMEZONE_CHANGED ACTION_TIMEZONE_CHANGEDandroid.content.Intent Intent de déterminer quand le temps change.

<li>

#uptimeMillis est compté en millisecondes depuis le démarrage du système. Cette horloge s’arrête lorsque le système entre en veille profonde (processeur désactivé, affichage sombre, appareil en attente d’entrée externe), mais n’est pas affecté par la mise à l’échelle de l’horloge, l’inactivité ou d’autres mécanismes d’économie d’alimentation. Il s’agit de la base de la plupart des intervalles de minutage tels que Thread#sleep(long) Thread.sleep(millis), Object#wait(long) Object.wait(millis)et System#nanoTime System.nanoTime(). Cette horloge est garantie d’être monotonique et convient pour le minutage de l’intervalle lorsque l’intervalle ne couvre pas le sommeil de l’appareil. La plupart des méthodes qui acceptent une valeur d’horodatage attendent actuellement l’horloge #uptimeMillis .

<li>

#elapsedRealtime et #elapsedRealtimeNanos retourner l’heure depuis le démarrage du système, et inclure le sommeil profond. Cette horloge est garantie d’être monotonique et continue de se cocher même lorsque le processeur est en mode d’économie d’énergie, il est donc recommandé de base pour le minutage à usage général.

</ul>

Il existe plusieurs mécanismes pour contrôler le minutage des événements :

<ul><li>

Les fonctions standard comme Thread#sleep(long) Thread.sleep(millis) et Object#wait(long) Object.wait(millis) sont toujours disponibles. Ces fonctions utilisent l’horloge #uptimeMillis ; si l’appareil entre en veille, le reste du temps sera reporté jusqu’à ce que l’appareil se réveille. Ces fonctions synchrones peuvent être interrompues avec Thread#interrupt Thread.interrupt(), et vous devez gérer InterruptedException.

<li>

#sleep SystemClock.sleep(millis) est une fonction utilitaire très similaire à Thread#sleep(long) Thread.sleep(millis), mais elle ignore InterruptedException. Utilisez cette fonction pour les retards si vous n’utilisez Thread#interrupt Thread.interrupt()pas , car elle conserve l’état interrompu du thread.

<li>

La android.os.Handler classe peut planifier des rappels asynchrones à un moment absolu ou relatif. Les objets de gestionnaire utilisent également l’horloge #uptimeMillis et nécessitent une android.os.Looper event loop (normalement présente dans n’importe quelle application GUI).

<li>

Il android.app.AlarmManager peut déclencher des événements ponctuels ou récurrents qui se produisent même lorsque l’appareil est en veille profonde ou que votre application n’est pas en cours d’exécution. Les événements peuvent être planifiés avec votre choix ( java.lang.System#currentTimeMillis RTC) ou #elapsedRealtime (ELAPSED_REALTIME) et provoquer une android.content.Intent diffusion lorsqu’ils se produisent. </ul>

Java documentation pour android.os.SystemClock.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.