סקירה כללית
אפשר להשתמש בפונקציות הבאות כדי לבדוק את השעה הנוכחית בשעון ואת זמן הפעילות הנוכחי של המערכת. לא מומלץ להפעיל את הפונקציות האלה בתוך ליבה.
סיכום
| סוגים | |
|---|---|
| rs_time_t | שניות מ-1 בינואר 1970 |
| rs_tm | המבנה של תאריך ושעה |
| פונקציות | |
|---|---|
| rsGetDt | הזמן שחלף מאז השיחה האחרונה |
| rsLocaltime | המרה לזמן המקומי |
| rsTime | שניות מ-1 בינואר 1970 |
| rsUptimeMillis | זמן פעולה תקינה של המערכת באלפיות שנייה |
| rsUptimeNanos | זמן פעולה תקינה של המערכת בננו-שניות |
סוגים
rs_time_t : שניות מ-1 בינואר 1970
typedef של: int כשמפעילים הידור ל-32 ביט.
typedef של: long כשמפעילים הידור ל-64 ביט.
זמן קלנדרי שמתפרש כמספר השניות שחלפו מאז תחילת הזמן (00:00:00 ב-1 בינואר 1970, לפי זמן אוניברסלי מתואם (UTC)).
rs_tm : מבנה של תאריך ושעה
מבנה עם השדות הבאים:
| int tm_sec | שניות אחרי הדקה. הערך יכול לנוע בין 0 ל-59, אבל יכול להגיע גם ל-60 בשניות מעוברות. |
|---|---|
| int tm_min | דקות אחרי השעה. הערך יכול לנוע בין 0 ל-59. |
| int tm_hour | שעות אחרי חצות. הערך יכול להיות בין 0 ל-23. |
| int tm_mday | היום בחודש. הערך יכול להיות בין 1 ל-31. |
| int tm_mon | מספר החודשים שחלפו מאז ינואר. הערך יכול לנוע בין 0 ל-11. |
| int tm_year | שנים מאז 1900. |
| int tm_wday | מספר הימים מאז יום ראשון. הערך יכול להיות בין 0 ל-6. |
| int tm_yday | מספר הימים מאז 1 בינואר. הערך יכול להיות בין 0 ל-365. |
| int tm_isdst | סימון שמציין אם שעון הקיץ בתוקף. הערך הוא חיובי אם הוא בתוקף, אפס אם הוא לא בתוקף ושלילי אם המידע לא זמין. |
מבנה נתונים של רכיבי זמן מפורטים.
פונקציות
rsGetDt : הזמן שחלף מאז השיחה האחרונה
| float rsGetDt(); |
החזרות
| הזמן בשניות. |
הפונקציה מחזירה את הזמן בשניות מאז הפעם האחרונה שהפונקציה הזו נקראת בסקריפט הזה.
rsLocaltime : המרה לזמן המקומי
פרמטרים
| מקומי | הפניה למבנה זמן שבו הזמן המקומי יישמר. |
|---|---|
| טיימר | מזינים את הזמן כמספר שניות מאז 1 בינואר 1970. |
החזרות
| הפניה לשעון המקומי של הפלט, כלומר אותו ערך כמו הפרמטר local. |
הפונקציה ממירה את הזמן שצוין על ידי הטיימר למבנה rs_tm שמספק שנה, חודש, שעה וכו'. הערך הזה נשמר ב-*local.
הפונקציה הזו מחזירה את אותו מצביע שהוענק כארגומנט הראשון. אם הפרמטר המקומי הוא NULL, הפונקציה לא מבצעת שום פעולה ומחזירה את הערך NULL.
rsTime : שניות מ-1 בינואר 1970
פרמטרים
| טיימר | המיקום שבו יישמר גם השעה שחוזרת מהיומן. |
|---|
החזרות
| שניות מאז תחילת הזמן (Epoch), -1 אם יש שגיאה. |
הפונקציה מחזירה את מספר השניות מאז תחילת זמן המערכת (00:00:00 UTC, 1 בינואר 1970).
אם timer שונה מ-NULL, התוצאה נשמרת גם בזיכרון שאליו מפנה המשתנה הזה.
rsUptimeMillis : זמן פעולה תקינה של המערכת באלפיות שנייה
| int64_t rsUptimeMillis(); |
החזרות
| זמן פעולה תקינה באלפיות שנייה. |
הפונקציה מחזירה את שעון המערכת הנוכחי (זמן פעולה תקינה) באלפיות השנייה.
rsUptimeNanos : זמן פעולה תקינה של המערכת בננו-שניות
| int64_t rsUptimeNanos(); |
החזרות
| זמן פעולה תקינה בננו-שניות. |
הפונקציה מחזירה את שעון המערכת הנוכחי (זמן פעולה תקינה) בננו-שניות.
רמת הפירוט של הערכים שמוחזרים על ידי הקריאה הזו עשויה להיות גדולה בהרבה מננו-שנייה.