os

Veraltete anzeigen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Diese Bibliothek dient derzeit dem Zweck, Informationen über die Systemzeit im UTC-Format zu liefern. Sie wurde stark sandboxed aus der Standard-Lua-Bibliothek os und erlaubt Ihnen keine Systemänderungen durchzuführen.

Zusammenfassung

Funktionen

  • Gibt die Zeit in Sekunden zurück, seit einem zufälligen Basis mit einer Unter-Mikrosekunden-Präzision.

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

    Formate den angegebenen Strings mit Zeit/Datum-Informationen basierend auf der angegebenen Zeit.

  • Zurückgibt die Anzahl der Sekunden von einer Zeit zu der anderen.

  • time(time : table):number

    Gibt an, wie viele Sekunden seit der Unix-Zeitalter (1. Januar 1970, 00:00:00) vergangen sind.

Funktionen

clock

Gibt die Verstrichene Zeit in Sekunden seit einer beliebigen Basis mit einer Unter微秒-Präzision zurück. Diese Funktion ist nützlich für den Vergleich von Dauerungen zwischen zwei Ereignissen, die auf demselben Computer auftreten, und ist die beste Option für das Benchmarking.

Unterschiede zu Funktionen wie os.time() oder DateTime.now() , Anpassungen an die Systemuhr (z. B. durch den Benutzer oder NTP ) verursachen keine Zeitverschiebung nach vorne oder hinten.


-- Zeit aufzeichnen:
local startTime = os.clock()
-- Tun Sie etwas, das Sie möchten die Leistung von:
local a, b = 0, 1
for _ = 1, 5000000 do
a, b = b, a
end
-- Messen Sie die Menge der Zeit, die dies benötigt hat:
local deltaTime = os.clock() - startTime
print("Elapsed time: " .. deltaTime)
--> Elapsed time: 0.044425600033719 (actual number may vary)

Rückgaben

Formate the given formatString with date/time information based on the given time, or if not provided, the value returned by os.time() .

Diese Funktion sollte in neuer Arbeit vermieden werden. Stattdessen verwenden Sie die DateTime API, die lokalisierte Formulierung unterstützt.

Die folgenden Spezialisatoren (basierend auf der C-Funktion strftime) werden unterstützt:


<tbody>
<tr>
<td>%a</td>
<td>Kurzer Wochenname \*</td>
<td>Mont</td>
</tr>
<tr>
<td>%A</td>
<td>Vollständiger Name des Tages \*</td>
<td>Montag</td>
</tr>
<tr>
<td>%b</td>
<td>Abgekürzter Monatname \*</td>
<td>Feb</td>
</tr>
<tr>
<td>%B</td>
<td>Name des vollständigen Monats \*</td>
<td>Februar</td>
</tr>
<tr>
<td>% c</td>
<td>Datum und Zeit \*</td>
<td>Mo, 12. Feb. 2024, 14:14:35</td>
</tr>
<tr>
<td>%d</td>
<td>Tag des Monats</td>
<td>12</td>
</tr>
<tr>
<td>%H</td>
<td>Stunde, mit 24-Stunden-Uhr</td>
<td>14</td>
</tr>
<tr>
<td>%I</td>
<td>Stunde, mit 12-Stunden-Uhr</td>
<td>02</td>
</tr>
<tr>
<td>%j</td>
<td>Tag des Jahres</td>
<td>043</td>
</tr>
<tr>
<td>%m</td>
<td>Monat</td>
<td>02</td>
</tr>
<tr>
<td>%M</td>
<td>Minute</td>
<td>14</td>
</tr>
<tr>
<td>%p</td>
<td>Entweder "AM" oder "PM"</td>
<td>PM</td>
</tr>
<tr>
<td>%S</td>
<td>Sekunde</td>
<td>35</td>
</tr>
<tr>
<td>%U</td>
<td>Woche number (erster Sonntag als erster Tag der ersten Woche)</td>
<td>06</td>
</tr>
<tr>
<td>%w</td>
<td>Wochentag</td>
<td>1</td>
</tr>
<tr>
<td>%W</td>
<td>Woche number (erster Montag als erster Tag der Woche eins)</td>
<td>07</td>
</tr>
<tr>
<td>%x</td>
<td>Datum \*</td>
<td>02.12.24</td>
</tr>
<tr>
<td>%X</td>
<td>Zeit \*</td>
<td>14:14:35</td>
</tr>
<tr>
<td>%y</td>
<td>Zweistelliges Jahr</td>
<td>24</td>
</tr>
<tr>
<td>%Y</td>
<td>Ganzjahr</td>
<td>2024</td>
</tr>
<tr>
<td>%z</td>
<td>ISO 8601 Offset von UTC in der Zeitzone (1 Minute = 1, 1 Stunde = 100)</td>
<td>0800</td>
</tr>
<tr>
<td>%Z</td>
<td>Name oder Abkürzung der Zeitzone \*</td>
<td>PST</td>
</tr>
<tr>
<td>%</td>
<td>Der %-Charakter</td>
<td>%</td>
</tr>
</tbody>
SpezifikatorBedeutungBeispiel

Dieser Wert kann je nach aktuellen Sprache variieren.

Das Beispiel, das gezeigt wird, ist für den 12. Februar 2024 (Montag) um 2:14:35 PM (14:14:35) laufend, verwenden Sie lokale "en-us" in der Pazifikischen Standardzeit (PST).

Wenn der angegebene formatString genau "*t" (lokale Zeit) oder "!*t" (UTC-Zeit) ist, kehrt diese Funktion stattdessen ein Wörterbuch zurück, das die folgenden Komponenten enthält, die normalerweise in den Spezifikationen oben verfügbar sind.


<tbody>
<tr>
<td>jahr</td>
<td>int</td>
<td>Eine Zahl, die das aktuelle Jahr der Aktuellen Ära (z. B. 2017) beschreibt</td>
</tr>
<tr>
<td>monat</td>
<td>int</td>
<td>Eine Zahl zwischen 1 und 12 (ab Januar), die den aktuellen Monat beschreibt.</td>
</tr>
<tr>
<td>wtag</td>
<td>int</td>
<td>Ein ganzer Zahl zwischen 1 und 7 (ab Sonntag), der den aktuellen Wochentag beschreibt.</td>
</tr>
<tr>
<td>yday</td>
<td>int</td>
<td>Ein ganzer Zahl zwischen 1 und 366, der beschreibt, wie viele Tage in dem Jahr sind. Es kann 366 Tage geben, wenn es ein Leap-Jahr ist.</td>
</tr>
<tr>
<td>tag</td>
<td>int</td>
<td>Ein ganzer Zahl zwischen 1 und 31, der den aktuellen Tag des Monats beschreibt.</td>
</tr>
<tr>
<td>stunde</td>
<td>int</td>
<td>Ein ganzer Zahl zwischen 1 und 24, der die aktuelle Stunde des Tages beschreibt.</td>
</tr>
<tr>
<td>min</td>
<td>int</td>
<td>Ein ganzer Zahl zwischen 0 und 59, der die aktuelle Minute des Tages beschreibt.</td>
</tr>
<tr>
<td>sekunde</td>
<td>int</td>
<td>Eine Zahl zwischen 0 und 60, die die aktuelle Sekunde des Tages beschreibt. (60, da die Funktion zur Anzeige von Sprung秒 beschrieben ist, aber in der Praxis wahrscheinlich nicht).</td>
</tr>
<tr>
<td>istbst</td>
<td>boolean</td>
<td>EinBoolean, der angibt, ob die Tageslichtsparzeitzeit derzeit aktiv ist.</td>
</tr>
</tbody>
FeldTypBeschreibung

Parameter

formatString: string

Muss entweder "*t" oder "!*t" sein.

time: number

Der Zeitwert zum Formatieren.

Rückgaben

difftime

Gibt die Anzahl der Sekunden von t1 zu t2 zurück. Der Unterschied wird berechnet, unter der Annahme, dass t1 und 1> t21> richtig auf die 4> Zeit_t4>-Form geschrieben sind.

Parameter

t2: number
t1: number

Rückgaben

time

Gibt an, wie viele Sekunden seit der Unix-Zeitalter (1 January 1970, 00:00:00) seitdem vergangen sind, unter der aktuellen UTC-Zeit. Wenn eine Tabelle in der gleichen Form wie die zurückgegebene von os.date() angezeigt wird, wird die Anzahl der Sekunden seitdem zurückgegeben.

Beachten Sie, dass die zurückgegebene Zeit die lokale Uhr des Geräts verwendet. Die meisten Betriebssysteme synchronisieren automatisch ihre lokale Zeit gegen Online-Zeit-Server, so dass dies innerhalb von einigen Hundertmillisekunden sein sollte. Benutzer können jedoch das Synchronisierungsverhalten leicht deaktivieren und die Systemzeit auf alles einstellen, was sie wollen; für die synchronisierte Zeit zwischen Client und Server verwenden Sie Workspace:GetServerTimeNow() anstelle.

Diese Funktion sollte in neuer Arbeit vermieden werden. Stattdessen verwenden Sie die DateTime API, die lokalisierte Formulierung unterstützt.

Wenn Sie die Zeit zwischen zwei Punkten genau messen müssen, wie bei der Erfüllung, verwenden Sie stattdessen os.clock().

Parameter

time: table

Eine Diktionstabelle, die eine bestimmte Zeit beschreibt, ähnlich derjenigen, die von os.date() zurückgegeben werden. Wenn nicht angegeben, verwendet die aktuelle UTC-Zeit.

Standardwert: UTC time

Rückgaben