os

Renvoie le temps écoulé en secondes depuis une base arbitraire avec une précision de sous-microseconde.Cette fonction est utile pour comparer les durées entre deux événements qui se produisent sur le même ordinateur, et est la meilleure option pour le benchmarking.

Contrairement aux fonctions telles que os.time() ou DateTime.now(), les ajustements de l'horloge du système (tels que par l'utilisateur ou NTP) ne font pas sauter le temps vers l'avant ou vers l'arrière.

-- Enregistrez le temps initial :
local startTime = os.clock()
-- Faites quelque chose que vous voulez mesurer les performances de :
local a, b = 0, 1
for _ = 1, 5000000 do
    a, b = b, a
end
-- Mesurez la quantité de temps que cela a pris :
local deltaTime = os.clock() - startTime
print("Elapsed time: " .. deltaTime)
-->  Elapsed time: 0.044425600033719 (actual number may vary)

Formate le formatString donné avec des informations sur la date/l'heure en fonction du temps donné, ou si ce n'est pas fourni, la valeur renvoyée par os.time().

Cette fonction doit être évitée dans le nouveau travail. Au lieu de cela, utilisez l'API DateTime, qui prend en charge la mise en forme localisée.

Les spécificateurs suivants (basés sur la fonction strftime C) sont pris en charge :

<th>Signification</th>

    <th>Exemple <sup>†</sup></th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>%a</td>

    <td>Nom de jour de la semaine abrégé *</td>

    <td>Mon</td>
  </tr>

  <tr>
    <td>%A</td>

    <td>Nom complet du jour de la semaine *</td>

    <td>Mercredi</td>
  </tr>

  <tr>
    <td>%b</td>

    <td>Nom du mois abrégé *</td>

    <td>Fév</td>
  </tr>

  <tr>
    <td>%B</td>

    <td>Nom du mois complet *</td>

    <td>février</td>
  </tr>

  <tr>
    <td>%c</td>

    <td>Date et heure *</td>

    <td>Lun 12 février 14:14:35 2024</td>
  </tr>

  <tr>
    <td>%d</td>

    <td>Jour du mois</td>

    <td>12</td>
  </tr>

  <tr>
    <td>%H</td>

    <td>Heure, en utilisant une horloge de 24 heures</td>

    <td>14</td>
  </tr>

  <tr>
    <td>%I</td>

    <td>Heure, en utilisant une horloge de 12 heures</td>

    <td>02</td>
  </tr>

  <tr>
    <td>%j</td>

    <td>Jour de l'année</td>

    <td>043</td>
  </tr>

  <tr>
    <td>%m</td>

    <td>Mois</td>

    <td>02</td>
  </tr>

  <tr>
    <td>%M</td>

    <td>Minute</td>

    <td>14</td>
  </tr>

  <tr>
    <td>%p</td>

    <td>Soit « AM » ou « PM »</td>

    <td>PM</td>
  </tr>

  <tr>
    <td>%S</td>

    <td>Seconde</td>

    <td>35</td>
  </tr>

  <tr>
    <td>%U</td>

    <td>Numéro de semaine (premier dimanche comme premier jour de la semaine un)</td>

    <td>06</td>
  </tr>

  <tr>
    <td>%w</td>

    <td>Jour de la semaine</td>

    <td>1</td>
  </tr>

  <tr>
    <td>%W</td>

    <td>Numéro de semaine (premier lundi comme premier jour de la semaine un)</td>

    <td>07</td>
  </tr>

  <tr>
    <td>%x</td>

    <td>Date *</td>

    <td>02/12/24</td>
  </tr>

  <tr>
    <td>%X</td>

    <td>Temps *</td>

    <td>14:14:35</td>
  </tr>

  <tr>
    <td>%y</td>

    <td>Année à deux chiffres</td>

    <td>24</td>
  </tr>

  <tr>
    <td>%Y</td>

    <td>Année complète</td>

    <td>2024</td>
  </tr>

  <tr>
    <td>%z</td>

    <td>Décalage ISO 8601 par rapport à l'UTC dans la zone de temps (1 minute = 1, 1 heure = 100)</td>

    <td>-0800</td>
  </tr>

  <tr>
    <td>%Z</td>

    <td>Nom ou abréviation de la zone de temps *</td>

    <td>Temps du jour</td>
  </tr>

  <tr>
    <td>%%</td>

    <td>Le caractère %</td>

    <td>%</td>
  </tr>
</tbody>

:* Cette valeur peut varier en fonction de la localisation actuelle.

† L'exemple fourni est pour le 12 février 2024 (lundi) à 2:14:35 PM (14:14:35), exécuté en utilisant le local « en-us » dans le temps standard du Pacifique (PST).

Si le formatString est exactement "*t" (temps local) ou "!*t" (temps UTC), cette fonction renvoie plutôt un dictionnaire contenant les composants suivants, qui sont normalement disponibles dans les spécificateurs ci-dessus.

<th>Type</th>

    <th>Avertissement</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>année</td>

    <td>instant</td>

    <td>Un entier qui décrit l'année actuelle de l'ère actuelle (ex. 2017)</td>
  </tr>

  <tr>
    <td>mois</td>

    <td>instant</td>

    <td>Un entier entre 1 et 12 (à partir de janvier) qui décrit le mois actuel.</td>
  </tr>

  <tr>
    <td>jour wday</td>

    <td>instant</td>

    <td>Un entier entre 1 et 7 (à partir de dimanche) qui décrit la journée de la semaine actuelle.</td>
  </tr>

  <tr>
    <td>jour de yday</td>

    <td>instant</td>

    <td>Un entier entre 1 et 366 décrivant le nombre de jours dans l'année. Il peut y avoir 366 jours si c'est une année bissextile.</td>
  </tr>

  <tr>
    <td>jour</td>

    <td>instant</td>

    <td>Un entier entre 1 et 31 décrivant la journée actuelle du mois.</td>
  </tr>

  <tr>
    <td>heure</td>

    <td>instant</td>

    <td>Un entier entre 1 et 24 décrivant l'heure actuelle de la journée.</td>
  </tr>

  <tr>
    <td>min</td>

    <td>instant</td>

    <td>Un entier entre 0 et 59 décrivant la minute actuelle de l'heure.</td>
  </tr>

  <tr>
    <td>seconde</td>

    <td>instant</td>

    <td>Un entier entre 0 et 60 décrivant la seconde actuelle de l'heure.(60 parce que la fonction est décrite pour indiquer les secondes de saut, mais en pratique, cela ne se produit probablement pas).</td>
  </tr>

  <tr>
    <td>est dst</td>

    <td>bool</td>

    <td>Un booléen décrivant si le temps d'économie de l'éclairage du jour est actuellement actif.</td>
  </tr>
</tbody>

Retourne le nombre de secondes de t1 à t2 .La différence est calculée en supposant que t1 et t2 sont correctement convertis au format time_t.

Renvoie le nombre de secondes écoulées depuis l'époque Unix (1er janvier 1970, 00:00:00), sous le temps UTC actuel.Si une table est fournie sous une forme similaire à celle renvoyée par os.date(), elle retournera le nombre de secondes écoulées depuis ce temps au lieu de cela.

Notez que le temps retourné utilise l'horloge locale de l'appareil.La plupart des systèmes d'exploitation synchronisent automatiquement leur heure locale contre des serveurs d'heure en ligne, donc cela devrait être dans quelques centaines de millisecondes.Cependant, les utilisateurs peuvent facilement désactiver le comportement de synchronisation et définir l'heure du système à ce qu'ils veulent ; pour le temps synchronisé entre le client et le serveur, utilisez Workspace:GetServerTimeNow() à la place.

Cette fonction doit être évitée dans le nouveau travail. Au lieu de cela, utilisez l'API DateTime, qui prend en charge la mise en forme localisée.

Lorsque vous devez mesurer avec précision le temps écoulé entre deux points dans le temps, comme lors du test des performances, utilisez os.clock() à la place.