os

Devuelve el tiempo transcurrido en segundos desde una base de línea arbitraria con precisión de submicrossegundos.Esta función es útil para comparar duraciones entre dos eventos que ocurren en la misma computadora, y es la mejor opción para la medición de rendimiento.

A diferencia de las funciones como os.time() o DateTime.now(), los ajustes al reloj del sistema (como por el usuario o NTP) no causan que el tiempo salte hacia adelante o hacia atrás.

-- Registra el tiempo inicial:
local startTime = os.clock()
-- Haz algo que quieras medir el rendimiento de:
local a, b = 0, 1
for _ = 1, 5000000 do
    a, b = b, a
end
-- Mida la cantidad de tiempo que tomó:
local deltaTime = os.clock() - startTime
print("Elapsed time: " .. deltaTime)
-->  Elapsed time: 0.044425600033719 (actual number may vary)

Formata el dado formatString con información de fecha/hora basada en el tiempo dado, o si no se proporciona, el valor devuelto por os.time() .

Esta función debe evitarse en el nuevo trabajo. En cambio, utilice la API DateTime, que admite la formación localizada.

Los siguientes especificadores (basados en la función strftime de C) se admiten:

<th>Significado</th>

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

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

    <td>Nombre abreviado de día laboral*</td>

    <td>Lun</td>
  </tr>

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

    <td>Nombre de día completo *</td>

    <td>Martes</td>
  </tr>

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

    <td>Nombre de mes abreviado*</td>

    <td>ene Feb</td>
  </tr>

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

    <td>Nombre de mes completo *</td>

    <td>februero</td>
  </tr>

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

    <td>Fecha y hora *</td>

    <td>Lun Feb 12 14:14:35 2024</td>
  </tr>

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

    <td>Día del mes</td>

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

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

    <td>Hora, usando reloj de 24 horas</td>

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

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

    <td>Hora, usando reloj de 12 horas</td>

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

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

    <td>Día del año</td>

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

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

    <td>Mensual</td>

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

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

    <td>Minuto</td>

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

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

    <td>O "AM" o "PM"</td>

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

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

    <td>Segundo</td>

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

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

    <td>Número de semana (primer domingo como primer día de la semana uno)</td>

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

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

    <td>Día laboral</td>

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

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

    <td>Número de semana (el primer lunes como el primer día de la semana uno)</td>

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

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

    <td>Fecha *</td>

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

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

    <td>Tiempo *</td>

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

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

    <td>Año de dos dígitos</td>

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

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

    <td>Todo el año</td>

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

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

    <td>Desplazamiento de ISO 8601 desde UTC en la zona horaria (1 minuto = 1, 1 hora = 100)</td>

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

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

    <td>Nombre o abreviación de la zona horaria *</td>

    <td>Tiempo del día</td>
  </tr>

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

    <td>El carácter %</td>

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

:* Este valor puede variar dependiendo del idioma actual.

† El ejemplo proporcionado es para el 12 de febrero de 2024 (lunes) a las 2:14:35 PM (14:14:35), ejecutar usando el idioma "en-us" en el tiempo estándar del Pacífico (PST).

Si el proporcionado formatString es exactamente "*t" (hora local) o "!*t" (hora UTC), esta función devuelve en cambio un diccionario que contiene los siguientes componentes, que normalmente están disponibles en los especificadores anteriores.

<th>Tipo</th>

    <th>Descripción</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>año</td>

    <td>intento</td>

    <td>Un entero que describe el año actual de la Era actual (por ejemplo, 2017)</td>
  </tr>

  <tr>
    <td>mensual</td>

    <td>intento</td>

    <td>Un entero entre 1 y 12 (comenzando en enero) que describe el mes actual.</td>
  </tr>

  <tr>
    <td>día wday</td>

    <td>intento</td>

    <td>Un entero entre 1 y 7 (comenzando el domingo) que describe el día de la semana actual.</td>
  </tr>

  <tr>
    <td>día</td>

    <td>intento</td>

    <td>Un entero entre 1 y 366 que describe cuántos días estamos en el año. Puede haber 366 días si es un año bisagra.</td>
  </tr>

  <tr>
    <td>día</td>

    <td>intento</td>

    <td>Un entero entre 1 y 31 que describe el día actual del mes.</td>
  </tr>

  <tr>
    <td>hora</td>

    <td>intento</td>

    <td>Un entero entre 1 y 24 que describe la hora actual del día.</td>
  </tr>

  <tr>
    <td>mínimo</td>

    <td>intento</td>

    <td>Un entero entre 0 y 59 que describe el minuto actual de la hora.</td>
  </tr>

  <tr>
    <td>segundo</td>

    <td>intento</td>

    <td>Un entero entre 0 y 60 que describe el segundo actual de la hora.(60 porque la función se describe para indicar segundos de salto, pero en la práctica probablemente no lo hace).</td>
  </tr>

  <tr>
    <td>isdst</td>

    <td>bool</td>

    <td>Un booleano que describe si el tiempo de ahorro de día está actualmente activo.</td>
  </tr>
</tbody>

Devuelve el número de segundos desde t1 a t2 .La diferencia se calcula asumiendo que t1 y t2 se escriben correctamente en el formato time_t.

Devuelve cuántos segundos han pasado desde la era de Unix (1 de enero de 1970, 00:00:00), bajo el tiempo UTC actual.Si se proporciona una tabla que se formateó de manera similar a la devuelta por os.date(), devolverá el número de segundos desde ese momento en lugar de eso.

Tenga en cuenta que el tiempo devuelto utiliza el reloj local del dispositivo.La mayoría de los sistemas operativos sincronizan automáticamente su tiempo local contra servidores de tiempo en línea, por lo que esto debería estar dentro de unos pocos cientos de milisegundos.Sin embargo, los usuarios pueden deshabilitar fácilmente el comportamiento de sincronización y establecer el tiempo del sistema en lo que quieran; para el tiempo sincronizado entre el cliente y el servidor, use Workspace:GetServerTimeNow() en lugar.

Esta función debe evitarse en el nuevo trabajo. En cambio, utilice la API DateTime, que admite la formación localizada.

Cuando necesite medir con precisión el tiempo transcurrido entre dos puntos en el tiempo, como cuando se prueba el ejecución, utilice os.clock() en su lugar.