總覽
以下函式可用來告知目前的時鐘時間和目前的系統運作時間。我們不建議在核心內呼叫這些函式。
摘要
| 類型 | |
|---|---|
| rs_time_t | 自 1970 年 1 月 1 日以來的秒數 |
| rs_tm | 日期和時間結構 |
| 函式 | |
|---|---|
| rsGetDt | 上次通話後經過的時間 |
| rsLocaltime | 轉換為當地時間 |
| rsTime | 自 1970 年 1 月 1 日以來的秒數 |
| rsUptimeMillis | 系統運作時間 (以毫秒為單位) |
| rsUptimeNanos | 系統運作時間 (以奈秒為單位) |
類型
rs_time_t ：自 1970 年 1 月 1 日以來的秒數
編譯 32 位元的 typedef 值：int
編譯 64 位元的 typedef 值。
日曆時間解讀為自 Epoch 紀元時間 (1970 年 1 月 1 日 00:00:00 起算，世界標準時間 (UTC)) 之後經過的秒數。
rs_tm ：日期和時間結構
具有以下欄位的結構：
| 距離 (tm_秒) | 分秒後秒。範圍介於 0 到 59 之間，但最長 60 的小時值。 |
|---|---|
| int tm_min | 分鐘，範圍介於 0 到 59 之間。 |
| int tm_hour | 超過午夜的小時。範圍從 0 到 23。 |
| int tm_day | 日期。範圍從 1 到 31。 |
| int tm_mon | 自 1 月起累計的月份。範圍從 0 到 11。 |
| Int tm_year | 自 1900 年以來的年份。 |
| int tm_wday | 自星期日起的天數。範圍介於 0 到 6。 |
| int tm_yday | 自 1 月 1 日至今的天數。範圍介於 0 到 365 之間。 |
| int tm_isdst | 標示日光節約時間是否生效的標記。值為有效值，如果沒有有效，則值為零；如果沒有資訊，則為負數。 |
細分時間元件的資料結構。
函式
rsGetDt ：上次呼叫後經過的時間
| float rsGetDt(); |
傳回
| 時間 (以秒為單位)。 |
傳回自此指令碼上次呼叫此函式後所經過的時間 (以秒為單位)。
rsLocaltime ：轉換為當地時間
參數
| 在地 | 儲存當地時間的時間結構。 |
|---|---|
| 計時器 | 輸入時間，以自 1970 年 1 月 1 日起算起的秒數表示。 |
傳回
| 指向輸出當地時間的指標，即與本機參數相同的值。 |
將計時器指定的時間轉換為 rs_tm 結構，可提供年、月、小時等。這個值會以 *local 儲存。
這個函式會傳回做為第一個引數傳遞的指標。如果本機參數為 NULL，這個函式不會執行任何動作，且會傳回 NULL。
rsTime ：自 1970 年 1 月 1 日以來的秒數
參數
| 計時器 | 要一併儲存傳回的日曆時間的位置。 |
|---|
傳回
| 自 Epoch 紀元時間起算的秒數，如果發生錯誤，則為 -1。 |
傳回自 Epoch 紀元時間 (世界標準時間 1970 年 1 月 1 日 00:00:00 UTC) 後的秒數。
如果計時器不是 NULL，系統也會將結果儲存在此變數指向的記憶體中。
rsUptimeMillis ：系統運作時間 (以毫秒為單位)
| int64_t rsUptimeMillis(); |
傳回
| 運作時間 (以毫秒為單位)。 |
傳回目前的系統時鐘 (運作時間)，以毫秒為單位。
rsUptimeNanos ：系統運作時間 (以奈秒為單位)
| int64_t rsUptimeNanos(); |
傳回
| 以奈秒表示運作時間。 |
傳回目前的系統時鐘 (運作時間)，以奈秒為單位。
此呼叫傳回的值精細程度可能大於奈秒。