總覽
以下函式可用來告知目前的時鐘時間和目前的系統運作時間。我們不建議在核心內呼叫這些函式。
摘要
類型 | |
---|---|
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(); |
傳回
以奈秒表示運作時間。 |
傳回目前的系統時鐘 (運作時間),以奈秒為單位。
此呼叫傳回的值精細程度可能大於奈秒。