os.time et os.date

Les programmes ont souvent besoin de connaître le time actuel. Un jeu enregistre le moment où vous avez marqué des points, un fichier de journalisation horodate chaque événement et une application de rappels compte le temps restant avant une échéance.

Lua regroupe ses outils de time dans la bibliothèque intégrée os. Les deux fonctions principales sont os.time et os.date. Vous découvrirez les deux dans cette leçon.

os.time() sans argument renvoie le moment actuel sous la forme d'un seul nombre.

Ce nombre correspond au nombre de secondes écoulées depuis un point fixe du passé, appelé l'époque. C'est simplement un entier : vous pouvez donc le stocker, le comparer ou effectuer des calculs avec lui.

Sur la plupart des systèmes, l'époque correspond à minuit le 1er janvier 1970, en UTC. Ainsi, os.time() vous indique combien de secondes se sont écoulées depuis cette date.

Un grand nombre comme 1700000000 est tout à fait normal. Il augmente d'une unité chaque seconde, ce qui le rend idéal pour comparer deux moments.

Un simple nombre de secondes est difficile à lire. os.date() transforme le time en texte facile à comprendre.

Appelée sans argument, cette fonction renvoie une chaîne lisible décrivant la date et le time actuels, selon les paramètres locaux de votre système.

En général, vous transmettez à os.date une chaîne de format. Les codes spéciaux commençant par % sont remplacés par des éléments de la date.

%Y représente l'année à quatre chiffres, %m le mois et %d le jour. Tout autre texte reste inchangé.

os.date peut recevoir un deuxième argument : un nombre représentant le time. Transmettez-lui le résultat de os.time pour formater ce moment précis.

Sans deuxième argument, la fonction utilise le time actuel ; ces deux appels décrivent donc le même instant.

Par défaut, os.date utilise votre fuseau horaire local. Pour obtenir l'UTC à la place, commencez la chaîne de format par un point d'exclamation !.

C'est important pour les serveurs et les applications utilisés partout dans le monde, car chacun doit se référer à la même horloge.

Si vous passez "*t" comme format, os.date renvoie une table plutôt qu'une chaîne.

Cette table contient des champs nommés comme year, month, day, hour, min et sec. C'est pratique lorsque vous n'avez besoin que d'une seule valeur.

Comme la forme table fournit des champs nommés, récupérer uniquement le mois ou l'heure actuels est très simple.

Utilisez !*t pour obtenir la version UTC de la table. Chaque champ est un simple nombre que vous pouvez utiliser dans des conditions.

os.time fonctionne également dans l'autre sens. Donnez-lui une table contenant year, month et day, et il renverra le nombre de secondes correspondant à cette date.

Vous pouvez ainsi construire une valeur de time pour n'importe quelle date précise de votre choix.

Vous pouvez passer librement d'une forme à l'autre : os.time transforme une table en nombre et os.date("*t", n) transforme un nombre en table.

Cette conversion aller-retour constitue la base des calculs de date, que vous découvrirez dans les leçons suivantes.

Vérifiez votre compréhension des deux fonctions principales.

os.time() fournit le moment actuel sous la forme d'un nombre de secondes écoulées depuis l'époque. os.date() transforme le time en texte à l'aide des codes de format %, ou en table avec "*t".

Ajoutez ! pour utiliser UTC et transmettez un nombre représentant le time comme deuxième argument afin de formater un instant précis. Ensemble, ces fonctions couvrent presque tous les besoins liés aux dates en Lua.