os
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Questa libreria attualmente serve il scopo di fornire informazioni sull'ora del sistema in formato UTC. È stata fortemente sandboxed dalla libreria Lua standard os e non ti consente di eseguire alcune operazioni di modifica del sistema.
Sommario
Funzioni
Restituisce il tempo trascorso in secondi dal momento che un arbitrario baseline con precisione sub-microsecondo.
Formatta la stringa fornita con informazioni su data/ora in base all'ora fornita.
Restituisce il numero di secondi da un tempo all'altro.
Restituisce il numero di secondi trascorsi dall'epoca Unix (1 gennaio 1970, 00:00:00) al momento UTC attuale.
Funzioni
clock
Restituisce il tempo trascorso in secondi dal momento che un arbitrario baseline con precisione sub-microsecondo. Questa funzione è utile per confrontare le durate tra due eventi che avvengono sullo stesso computer e è la migliore opzione per il benchmarking.
A differenza di funzioni come os.time() o DateTime.now() , gli aggiustamenti all'orologio del sistema (come l'utente o NTP ) non fanno salire il tempo in avanti o indietro.
-- Registra il tempo iniziale:local startTime = os.clock()-- Fai qualcosa che vuoi misurare le prestazioni di:local a, b = 0, 1for _ = 1, 5000000 doa, b = b, aend-- Misura la quantità di tempo che ci vuole per fare questo:local deltaTime = os.clock() - startTimeprint("Elapsed time: " .. deltaTime)--> Elapsed time: 0.044425600033719 (actual number may vary)
Restituzioni
date
Formatta il formatString con informazioni di data/ora in base all'ora/tempo specificata, o se non fornito, il valore restituito da os.time() .
Questa funzione dovrebbe essere evitata in nuovo lavoro. Invece, usa l'API DateTime, che supporta la formattazione locale.
I seguenti specificatori (basati sulla funzione strtrtime della C) sono supportati:
<tbody><tr><td>%a</td><td>Nome della settimana abbreviato \*</td><td>Lun</td></tr><tr><td>%A</td><td>Nome completo del giorno \*</td><td>Lunedì</td></tr><tr><td>%b</td><td>Nome del mese abbreviato \*</td><td>Feb</td></tr><tr><td>%B</td><td>Nome completo del mese \*</td><td>Febbraio</td></tr><tr><td>%c</td><td>Data e orario \*</td><td>Gio 12 Gen 14:14:35 2024</td></tr><tr><td>%d</td><td>Giorno del mese</td><td>12</td></tr><tr><td>%H</td><td>Ora, utilizzando l'orologio da 24 ore</td><td>14</td></tr><tr><td>% io</td><td>Ora, utilizzando l'orologio da 12 ore</td><td>02</td></tr><tr><td>%j</td><td>Giorno dell'anno</td><td>043</td></tr><tr><td>%m</td><td>Mese</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>Secondo</td><td>35</td></tr><tr><td>%U</td><td>Numero di settimana (primo domenica come primo giorno di settimana uno)</td><td>06</td></tr><tr><td>%w</td><td>Giornata</td><td>1</td></tr><tr><td>%W</td><td>Numero di settimana (primo lunedì come primo giorno della settimana uno)</td><td>07</td></tr><tr><td>%x</td><td>Data \*</td><td>02/12/24</td></tr><tr><td>%X</td><td>Tempo \*</td><td>14:14:35</td></tr><tr><td>%y</td><td>Anno a due cifre</td><td>24</td></tr><tr><td>%Y</td><td>Anno intero</td><td>2024</td></tr><tr><td>%z</td><td>ISO 8601 offset dall'UTC in zona del tempo (1 min = 1, 1 ora = 100)</td><td>0800</td></tr><tr><td>%Z</td><td>Nome o abbreviazione della TimeZone \*</td><td>PST</td></tr><tr><td>%%</td><td>Il carattere %</td><td>%</td></tr></tbody>
Specificatore | Significato | Esempio † |
---|
* Questo valore può variare a seconda della lingua attuale.
^ L'esempio fornito è per il 12 febbraio 2024 (lunedì) alle 2:14:35 PM (14:14:35), eseguito usando la località "it" in orario PST.
Se il formatString fornito è esattamente "*t" (ora locale) o "!*t" (ora UTC), questa funzione invece restituisce un dizionario che contiene i seguenti componenti, che sono normalmente disponibili nei specifier sopra.
<tbody><tr><td>anno</td><td>int</td><td>Un numero che descrive l'anno corrente dell'Era attuale (es. 2017)</td></tr><tr><td>mese</td><td>int</td><td>Un numero intero tra 1 e 12 (a partire da gennaio) che descrive il mese corrente.</td></tr><tr><td>wgiorno</td><td>int</td><td>Un numero intero tra 1 e 7 (a partire da domenica) che descrive il giorno attuale della settimana.</td></tr><tr><td>ygiorno</td><td>int</td><td>Un numero intero tra 1 e 366 che descrive il numero di giorni che abbiamo nel year. Ci possono essere 366 giorni se è un year di salto.</td></tr><tr><td>giorno</td><td>int</td><td>Un numero intero tra 1 e 31 che descrive il giorno corrente del mese.</td></tr><tr><td>ora</td><td>int</td><td>Un numero intero tra 1 e 24 che descrive l'ora attuale del giorno.</td></tr><tr><td>min</td><td>int</td><td>Un numero intero tra 0 e 59 che descrive il minuto corrente dell'ora.</td></tr><tr><td>secondo</td><td>int</td><td>Un numero intero tra 0 e 60 che descrive il secondo attuale dell'ora. (60 perché la funzione è descritta per indicare secondi di salto, ma in pratica probabilmente non lo fa).</td></tr><tr><td>isd</td><td>booleano</td><td>Un bool che indica se il salvataggio del giorno è attivo.</td></tr></tbody>
Campo | Tipo | Descrizione |
---|
Parametri
Restituzioni
time
Restituisce il numero di secondi trascorsi dall'epoca Unix (1 gennaio 1970, 00:00:00), calcolato all'ora corrente UTC. Se viene fornito un formato di tabella simile a quello restituito da os.date(), restituirà il numero di secondi dal momento in cui è stato fornito invece.
Nota che il tempo restituito utilizza l'orologio locale del Dispositivo. La maggior parte dei sistemi operativi sincronizza automaticamente il loro orario locale contro i server di tempo online, quindi questo dovrebbe essere entro pochi centesimi di mill secondo. Tuttavia, gli utenti possono facilmente disabilitare il comportamento di sincronizzazione e impostare l'ora del sistema su qualsiasi orario desiderato; per il sincronizzazione del tempo tra il client e il Server, usa Workspace:GetServerTimeNow() in
Questa funzione dovrebbe essere evitata in nuovo lavoro. Invece, usa l'API DateTime, che supporta la formattazione locale.
Quando è necessario misurare esattamente il tempo trascorso tra due punti nel tempo, come quando si testa le Prestazione, usa os.clock() invece.