os

Visualizza obsoleti

*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.

  • date(formatString : string,time : number):Dictionary

    Formatta la stringa fornita con informazioni su data/ora in base all'ora fornita.

  • Restituisce il numero di secondi da un tempo all'altro.

  • time(time : table):number

    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, 1
for _ = 1, 5000000 do
a, b = b, a
end
-- Misura la quantità di tempo che ci vuole per fare questo:
local deltaTime = os.clock() - startTime
print("Elapsed time: " .. deltaTime)
--> Elapsed time: 0.044425600033719 (actual number may vary)

Restituzioni

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>
SpecificatoreSignificatoEsempio

* 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>
CampoTipoDescrizione

Parametri

formatString: string

Deve essere uno qualsiasi di "*t" o "!*t" .

time: number

Il valore di tempo per la formattazione.

Restituzioni

difftime

Ritorna il numero di secondi da t1 a t2 . La differenza viene calcolata supponendo che t1 e 1> t21> siano correttamente convertiti in 4>time_t4> format.

Parametri

t2: number
t1: number

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.

Parametri

time: table

Una tabella di dizionario che descrive un determinato momento, simile a quello restituito da os.date() . Se non fornito, usa il tempo UTC attuale.

Valore predefinito: UTC time

Restituzioni