os

顯示已棄用項目

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

此資料庫目前為提供資訊系統時間以 UTC 格式提供時間的目的。它已被重新沙盒自 standard Lua os 資料庫，並且不允許您執行任何系統變更操作。

概要

函式

clock():number
返回自由基準微秒精準度的秒鐘時間。
date(formatString : string,time : number):Dictionary
以給定時間資訊為基礎，將給定的字串格式化為時間。
difftime(t2 : number,t1 : number):number
返回從一次到另一次的秒數。
time(time : table):number
返回自從 Unix 時代 (1970 年 1 月 1 日, 00:00:00) 起至現時 UTC 時間的秒數。

函式

clock

number

返回自由基準時間 (以微秒計) 自從隨機準確度的基準時間。此功能對比兩個發生在同一電腦的事件，以及評估性能的最佳選擇。

與 os.time() 或 DateTime.now() 等功能不同，調整系統時間 (例如由使用者或 NTP 提供) 不會導致時間向前或向後跳轉。


-- 記錄初始時間：
local startTime = os.clock()
-- 您想要測試的內容：
local a, b = 0, 1
for _ = 1, 5000000 do
    a, b = b, a
end
-- 測量這個時間所需的時間：
local deltaTime = os.clock() - startTime
print("Elapsed time: " .. deltaTime)
-->  Elapsed time: 0.044425600033719 (actual number may vary)

number

date

Dictionary

使用指定的時間/時間信息來將 formatString 變成格式，或在指定的時間/時間信息不提供的情況下返回值 os.time() 。

這個功能應該在新工作中避免。相反，使用 DateTime API，這個支援本地化格式。

以下指定子可支持：


<tbody>
  <tr>
    <td>%a</td>
    <td>簡稱週一至週五名稱\*</td>
    <td>星期一</td>
  </tr>

  <tr>
    <td>%A</td>
    <td>完整的每日名稱\*</td>
    <td>星期一</td>
  </tr>

  <tr>
    <td>百分比</td>
    <td>簡化月名\*</td>
    <td>2月</td>
  </tr>

  <tr>
    <td>百分比</td>
    <td>全月名稱\*</td>
    <td>二月</td>
  </tr>

  <tr>
    <td>:%c</td>
    <td>日期和時間 \*</td>
    <td>2月12日 14:14:35 2024</td>
  </tr>

  <tr>
    <td>%d</td>
    <td>月的日子</td>
    <td>12</td>
  </tr>

  <tr>
    <td>%H</td>
    <td>使用 24 小時時鐘</td>
    <td>14</td>
  </tr>

  <tr>
    <td>%I</td>
    <td>使用 12 小時的時鐘</td>
    <td>02</td>
  </tr>

  <tr>
    <td>:%j</td>
    <td>年的日子</td>
    <td>043</td>
  </tr>

  <tr>
    <td>百萬</td>
    <td>月</td>
    <td>02</td>
  </tr>

  <tr>
    <td>百萬</td>
    <td>分鐘</td>
    <td>14</td>
  </tr>

  <tr>
    <td>百分比</td>
    <td>「AM」或「PM」</td>
    <td>下午</td>
  </tr>

  <tr>
    <td>:%S</td>
    <td>秒</td>
    <td>35</td>
  </tr>

  <tr>
    <td>%U</td>
    <td>星期號碼 (第一個星期一 的第一天)</td>
    <td>06</td>
  </tr>

  <tr>
    <td>:%w</td>
    <td>平日</td>
    <td>1</td>
  </tr>

  <tr>
    <td>:%W</td>
    <td>星期號碼 (第一個星期一 作為第一天的第一天)</td>
    <td>07</td>
  </tr>

  <tr>
    <td>%x</td>
    <td>日期 \*</td>
    <td>02/12/24</td>
  </tr>

  <tr>
    <td>%X</td>
    <td>時間 \*</td>
    <td>14:14:35</td>
  </tr>

  <tr>
    <td>:%y</td>
    <td>兩位數年</td>
    <td>24</td>
  </tr>

  <tr>
    <td>:%Y</td>
    <td>全年</td>
    <td>2024</td>
  </tr>

  <tr>
    <td>:%z</td>
    <td>ISO 8601 時區偏移 (1 分鐘 = 1, 1 小時 = 100)</td>
    <td>0800</td>
  </tr>

  <tr>
    <td>:%Z</td>
    <td>時區名稱或簡稱 \*</td>
    <td>PST</td>
  </tr>

  <tr>
    <td>百分比</td>
    <td>% 字元</td>
    <td>%</td>
  </tr>
</tbody>

指定器	意義	範例^†

值可能會因地區而變化。

※ 提供的範例為 2024 年 2 月 12 日 (星期一) 在 2:14:35 (14:14:35)，在太平洋標準時間 (PST) 執行。

如果提供的 formatString 正確是 "*t" (本地時間) 或 "!*t" (UTC 時間)，此功能將返回包含以下元素的字典，通常在上方的指定器可用。


<tbody>
  <tr>
    <td>年</td>
    <td>int</td>
    <td>一個描述當前時代的當前年度(例子 2017)</td>
  </tr>

  <tr>
    <td>月</td>
    <td>int</td>
    <td>一個介於 1 和 12 之間的整數，用於描述當前月。</td>
  </tr>

  <tr>
    <td>wday</td>
    <td>int</td>
    <td>一個數字，在 1 和 7 之間 (從星期日開始) 描述當前星期天。</td>
  </tr>

  <tr>
    <td>yday</td>
    <td>int</td>
    <td>一個介於 1 和 366 之間的整數，描述我們到年的天數。如果是跳年，則可能有 366 天。</td>
  </tr>

  <tr>
    <td>日</td>
    <td>int</td>
    <td>一個介於 1 和 31 之間的整數，描述當月當天的當天。</td>
  </tr>

  <tr>
    <td>小時</td>
    <td>int</td>
    <td>一個介於 1 和 24 之間的整數，代表當前時間的當日。</td>
  </tr>

  <tr>
    <td>分</td>
    <td>int</td>
    <td>一個介於 0 和 59 之間的整數，描述當前時間的當前分鐘。</td>
  </tr>

  <tr>
    <td>秒</td>
    <td>int</td>
    <td>一個介於 0 和 60 之間的整數，描述當前秒的時間。(60 因為函數是描述跳躍秒的，但在實際上可能不是)。</td>
  </tr>

  <tr>
    <td>isbst</td>
    <td>boolean</td>
    <td>描述當前是否啟用週末光照時間的按鈕。</td>
  </tr>
</tbody>