סוגי פונקציות הזמן ופונקציות הזמן ב-RenderScript

סקירה כללית

אפשר להשתמש בפונקציות הבאות כדי לבדוק את השעה הנוכחית בשעון ואת זמן הפעילות הנוכחי של המערכת. לא מומלץ להפעיל את הפונקציות האלה בתוך ליבה.

סיכום

סוגים
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 : המרה לזמן המקומי

rs_tm* rsLocaltime(rs_tm* local, const rs_time_t* timer);
פרמטרים
מקומיהפניה למבנה זמן שבו הזמן המקומי יישמר.
טיימרמזינים את הזמן כמספר שניות מאז 1 בינואר 1970.
החזרות
הפניה לשעון המקומי של הפלט, כלומר אותו ערך כמו הפרמטר local.

הפונקציה ממירה את הזמן שצוין על ידי הטיימר למבנה rs_tm שמספק שנה, חודש, שעה וכו'. הערך הזה נשמר ב-*local.

הפונקציה הזו מחזירה את אותו מצביע שהוענק כארגומנט הראשון. אם הפרמטר המקומי הוא NULL, הפונקציה לא מבצעת שום פעולה ומחזירה את הערך NULL.

rsTime : שניות מ-1 בינואר 1970

rs_time_t rsTime(rs_time_t* timer);
פרמטרים
טיימרהמיקום שבו יישמר גם השעה שחוזרת מהיומן.
החזרות
שניות מאז תחילת הזמן (Epoch), -1 אם יש שגיאה.

הפונקציה מחזירה את מספר השניות מאז תחילת זמן המערכת (00:00:00 UTC, 1 בינואר 1970).

אם timer שונה מ-NULL, התוצאה נשמרת גם בזיכרון שאליו מפנה המשתנה הזה.

rsUptimeMillis : זמן פעולה תקינה של המערכת באלפיות שנייה

int64_t rsUptimeMillis();‎
החזרות
זמן פעולה תקינה באלפיות שנייה.

הפונקציה מחזירה את שעון המערכת הנוכחי (זמן פעולה תקינה) באלפיות השנייה.

rsUptimeNanos : זמן פעולה תקינה של המערכת בננו-שניות

int64_t rsUptimeNanos();
החזרות
זמן פעולה תקינה בננו-שניות.

הפונקציה מחזירה את שעון המערכת הנוכחי (זמן פעולה תקינה) בננו-שניות.

רמת הפירוט של הערכים שמוחזרים על ידי הקריאה הזו עשויה להיות גדולה בהרבה מננו-שנייה.