os
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
Esta biblioteca actualmente sirve el propósito de proporcionar información sobre el tiempo del sistema en el formato UTC. Ha sido altamente sandboxeada de la biblioteca Lua estándar os y no le permite realizar ningas operaciones de alteración del sistema.
Resumen
Funciones
Devuelve el tiempo transcurrido en segundos desde un tiempo base aleatorio con una precisión de sub-microsegundos.
Formata la cadena dada con información de fecha/tiempo según el tiempo dado.
Regresa el número de segundos de un tiempo a otro.
Devuelve cuántos segundos han pasado desde la época de Unix (1 de enero de 1970, 00:00:00) bajo el tiempo UTC actual.
Funciones
clock
Restablece el tiempo transcurrido en segundos desde un tiempo de referencia arbitrario con una precisión de sub-microsegundos. Esta función es útil para comparar duraciones entre dos eventos que ocurren en el mismo ordenador, y es la mejor opción para el benchmarking.
A diferencia con funciones como os.time() o DateTime.now(), los ajustes en el reloj del sistema (como por el usuario o NTP ) no hacen que el tiempo salte hacia delante o hacia atrás.
-- Registra el tiempo inicial:local startTime = os.clock()-- Haz algo que quieras medir el rendimiento de:local a, b = 0, 1for _ = 1, 5000000 doa, b = b, aend-- Medida la cantidad de tiempo que esto tomó:local deltaTime = os.clock() - startTimeprint("Elapsed time: " .. deltaTime)--> Elapsed time: 0.044425600033719 (actual number may vary)
Devuelve
date
Formata el dado formatString con información de fecha/tiempo según el tiempo dado, o si no se proporciona, el valor devuelto por os.time() .
Esta función debería evitarse en el nuevo trabajo. En cambio, use la API DateTime, que soporta la formación localizada.
Los siguientes especificadores (basados en la función strrtime de C) se admiten:
<tbody><tr><td>%a</td><td>Nombre de día de la semana abreviado \*</td><td>Lun</td></tr><tr><td>%A</td><td>Nombre de día completo \*</td><td>Lunes</td></tr><tr><td>%b</td><td>Nombre de mes abreviado \*</td><td>feb</td></tr><tr><td>%B</td><td>Nombre de mes completo \*</td><td>febrero</td></tr><tr><td>%cc</td><td>Fecha y hora \*</td><td>Lun 12 de Feb 14:14:35 2024</td></tr><tr><td>%d</td><td>Día del mes</td><td>12</td></tr><tr><td>%T</td><td>Hora, usando el reloj de 24 horas</td><td>14</td></tr><tr><td>%I</td><td>Hora, usando el 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>Mes</td><td>02</td></tr><tr><td>%M</td><td>Minuto</td><td>14</td></tr><tr><td>por ciento</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>Semana número (primer domingo como el primer día de la semana uno)</td><td>06</td></tr><tr><td>%w</td><td>Día hábil</td><td>1</td></tr><tr><td>%W</td><td>Semana número (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/2014</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 de tiempo (1 minuto = 1, 1 hora = 100)</td><td>0800</td></tr><tr><td>%Z</td><td>Nombre o abreviatura de la zona de tiempo \*</td><td>PST</td></tr><tr><td>%)</td><td>El carácter %</td><td>%)</td></tr></tbody>
Especialista | Significado | Ejemplo ^ |
---|
Este valor puede cambiar 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 del Pacífico (PST).
Si el proporcionado formatString es exactamente "*t" (tiempo local) o "!*t" (tiempo UTC), esta función en cambio devuelve un diccionario que contiene los siguientes componentes, que generalmente están disponibles en los especificadores de arriba.
<tbody><tr><td>año</td><td>int</td><td>Un número que describe el año actual de la Edad Actual (ej. 2017)</td></tr><tr><td>mes</td><td>int</td><td>Un número entre 1 y 12 (que comienza en enero) que describe el mes actual.</td></tr><tr><td>wjornada</td><td>int</td><td>Un número entre 1 y 7 (que comienza el domingo) que describe el día de la semana actual.</td></tr><tr><td>ld</td><td>int</td><td>Un número 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 de salto.</td></tr><tr><td>día</td><td>int</td><td>Un número entre 1 y 31 que describe el día actual del mes.</td></tr><tr><td>hora</td><td>int</td><td>Un número entre 1 y 24 que describe la hora actual del día.</td></tr><tr><td>min</td><td>int</td><td>Un número entre 0 y 59 que describe el minuto actual de la hora.</td></tr><tr><td>segundo</td><td>int</td><td>Un número 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>esdt</td><td>booleano</td><td>Un valor deBooleano que describe si el ahorro de luz del día está activo actualmente.</td></tr></tbody>
Campo | Tipo | Descripción |
---|
Parámetros
Devuelve
time
Devuelve cuántos segundos han pasado desde la época Unix (1 de enero de 1970, 00:00:00), bajo el tiempo UTC actual. Si se proporciona una tabla con formato de tabla similar al que se devuelve por os.date() , devolverá el número de segundos desde ese momento en lugar.
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 cientos de milisegundos. Sin embargo, los usuarios pueden desactivar fácilmente el comportamiento de sincronización y establecer el tiempo del sistema en cualquier momento que deseen; para el tiempo sincronizado entre el cliente y el servidor, usar Workspace:GetServerTimeNow()
Esta función debería evitarse en el nuevo trabajo. En cambio, use la API DateTime, que soporta la formación localizada.
Cuando necesite medir con precisión el tiempo transcurrido entre dos puntos en el tiempo, como al probar el ejecución, use os.clock() en su lugar.