الدوال الزمنية وأنواعها في RenderScript
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
نظرة عامة
يمكن استخدام الدوال أدناه لمعرفة وقت الساعة الحالي ووقت ضبط النظام الحالي. لا يُنصح باستدعاء هذه الدوال داخل النواة (kernel).
ملخّص
الأنواع |
rs_time_t
|
الثواني منذ 1 كانون الثاني (يناير) 1970
|
rs_tm
|
هيكل التاريخ والوقت
|
الأنواع
rs_time_t
: الثواني منذ 1 كانون الثاني (يناير) 1970
تعريف نوعي: int عند التحويل إلى 32 بت.
تعريف طباعيّ لـ: long عند التجميع لـ 64 بت.
وقت التقويم مفسَّر على أنّه الثواني المنقضية منذ الحقبة (00:00:00 في 1 كانون الثاني (يناير) 1970، التوقيت العالمي المنسَّق (UTC)).
rs_tm
: بنية التاريخ والوقت
بنية تتضمّن الحقول التالية:
عدد صحيح 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. |
تدخُّل دفاعي tm_year | أعوام منذ عام 1900. |
tm_wday | الأيام التي مرّت منذ الأحد. وتتراوح هذه النسبة بين 0 و6. |
عدد صحيح لليوم | عدد الأيام منذ 1 كانون الثاني (يناير). ويتراوح هذا النطاق بين 0 و365. |
int tm_isdst | وضع علامة للإشارة إلى ما إذا كان نظام التوقيت الصيفي ساري المفعول. وتكون القيمة موجبة في حالة تطبيقها، وتكون صفر في حالة عدم وجودها، وسالبة في حالة عدم توفر المعلومات. |
هيكل بيانات لمكونات الوقت المُقسَّمة.
الدوال
rsGetDt
: الوقت المنقضي منذ آخر مكالمة
لعرض الوقت بالثواني منذ آخر طلب لهذه الدالة في هذا النص البرمجي.
rsLocaltime
: التحويل إلى التوقيت المحلي
المعلّمات
محلي | مؤشر إلى بنية زمنية يتم فيها تخزين الوقت المحلي. |
موقّت | إدخال الوقت كعدد من الثواني منذ 1 كانون الثاني (يناير) 1970. |
الركلات المردودة
أشِر إلى التوقيت المحلي للناتج، أي قيمة مماثلة للمَعلمة المحلية. |
تحوِّل هذه الدالة الوقت الذي يحدِّده الموقّت إلى بنية rs_tm توفّر السنة والشهر
والساعة وغير ذلك. ويتم تخزين هذه القيمة على *local.
تعرض هذه الدالة المؤشر نفسه الذي تم تمريره كوسيطة أولى. إذا كانت المعلمة المحلية فارغة، فلن تفعل هذه الدالة أي شيء وتعرض NULL.
rsTime
: الثواني منذ 1 كانون الثاني (يناير) 1970
المعلّمات
موقّت | موقع لتخزين وقت التقويم المعروض أيضًا. |
الركلات المردودة
الثواني التي تلي الحقبة، والقيمة -1 في حال حدوث خطأ. |
لعرض عدد الثواني منذ الحقبة (00:00:00 بالتوقيت العالمي المنسق، 1 كانون الثاني (يناير) 1970).
إذا كان المؤقت غير فارغ، فسيتم تخزين النتيجة أيضًا في الذاكرة المشار إليها من خلال هذا المتغير.
rsUptimeMillis
: مدة تشغيل النظام بالمللي ثانية
الركلات المردودة
مدة التشغيل بالمللي ثانية |
لعرض ساعة النظام الحالية (وقت التشغيل) بالمللي ثانية.
rsUptimeNanos
: مدة تشغيل النظام بالنانوثانية
عرض ساعة النظام الحالية (مدة التشغيل) بالنانو ثانية.
قد تكون دقة القيم التي تعرضها هذه المكالمة أكبر بكثير من نانو ثانية.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# RenderScript Time Functions and Types\n\nOverview\n--------\n\nThe functions below can be used to tell the current clock time and the current\nsystem up time. It is not recommended to call these functions inside of a kernel.\n\nSummary\n-------\n\n| Types ||\n|--------------------------------------------------------------------------------|-------------------------------|\n| [rs_time_t](/guide/topics/renderscript/reference/rs_time#android_rs:rs_time_t) | Seconds since January 1, 1970 |\n| [rs_tm](/guide/topics/renderscript/reference/rs_time#android_rs:rs_tm) | Date and time structure |\n\n| Functions ||\n|------------------------------------------------------------------------------------------|-------------------------------|\n| [rsGetDt](/guide/topics/renderscript/reference/rs_time#android_rs:rsGetDt) | Elapsed time since last call |\n| [rsLocaltime](/guide/topics/renderscript/reference/rs_time#android_rs:rsLocaltime) | Convert to local time |\n| [rsTime](/guide/topics/renderscript/reference/rs_time#android_rs:rsTime) | Seconds since January 1, 1970 |\n| [rsUptimeMillis](/guide/topics/renderscript/reference/rs_time#android_rs:rsUptimeMillis) | System uptime in milliseconds |\n| [rsUptimeNanos](/guide/topics/renderscript/reference/rs_time#android_rs:rsUptimeNanos) | System uptime in nanoseconds |\n\nTypes\n-----\n\n#### rs_time_t\n: Seconds since January 1, 1970\n\nA typedef of: int When compiling for 32 bits.\n\nA typedef of: long When compiling for 64 bits.\n\nCalendar time interpreted as seconds elapsed since the Epoch (00:00:00 on\nJanuary 1, 1970, Coordinated Universal Time (UTC)). \n\n#### rs_tm\n: Date and time structure\n\nA structure with the following fields:\n\n| int tm_sec | Seconds after the minute. This ranges from 0 to 59, but possibly up to 60 for leap seconds. |\n| int tm_min | Minutes after the hour. This ranges from 0 to 59. |\n| int tm_hour | Hours past midnight. This ranges from 0 to 23. |\n| int tm_mday | Day of the month. This ranges from 1 to 31. |\n| int tm_mon | Months since January. This ranges from 0 to 11. |\n| int tm_year | Years since 1900. |\n| int tm_wday | Days since Sunday. This ranges from 0 to 6. |\n| int tm_yday | Days since January 1. This ranges from 0 to 365. |\n| int tm_isdst | Flag to indicate whether daylight saving time is in effect. The value is positive if it is in effect, zero if it is not, and negative if the information is not available. |\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n\n\u003cbr /\u003e\n\nData structure for broken-down time components.\n\nFunctions\n---------\n\n#### rsGetDt\n: Elapsed time since last call\n\n|------------------|---|\n| float rsGetDt(); | |\n\n##### Returns\n\n|------------------|\n| Time in seconds. |\n\nReturns the time in seconds since this function was last called in this script. \n\n#### rsLocaltime\n: Convert to local time\n\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| [rs_tm](/guide/topics/renderscript/reference/rs_time#android_rs:rs_tm)\\* rsLocaltime([rs_tm](/guide/topics/renderscript/reference/rs_time#android_rs:rs_tm)\\* local, const [rs_time_t](/guide/topics/renderscript/reference/rs_time#android_rs:rs_time_t)\\* timer); | |\n\n##### Parameters\n\n| local | Pointer to time structure where the local time will be stored. |\n| timer | Input time as a number of seconds since January 1, 1970. |\n|-------|----------------------------------------------------------------|\n\n##### Returns\n\n|-------------------------------------------------------------------------------|\n| Pointer to the output local time, i.e. the same value as the parameter local. |\n\nConverts the time specified by timer into a [rs_tm](/guide/topics/renderscript/reference/rs_time#android_rs:rs_tm) structure that provides year, month,\nhour, etc. This value is stored at \\*local.\n\nThis functions returns the same pointer that is passed as first argument. If the\nlocal parameter is NULL, this function does nothing and returns NULL. \n\n#### rsTime\n: Seconds since January 1, 1970\n\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| [rs_time_t](/guide/topics/renderscript/reference/rs_time#android_rs:rs_time_t) rsTime([rs_time_t](/guide/topics/renderscript/reference/rs_time#android_rs:rs_time_t)\\* timer); | |\n\n##### Parameters\n\n| timer | Location to also store the returned calendar time. |\n|-------|----------------------------------------------------|\n\n##### Returns\n\n|--------------------------------------------------|\n| Seconds since the Epoch, -1 if there's an error. |\n\nReturns the number of seconds since the Epoch (00:00:00 UTC, January 1, 1970).\n\nIf timer is non-NULL, the result is also stored in the memory pointed to by\nthis variable. \n\n#### rsUptimeMillis\n: System uptime in milliseconds\n\n|-----------------------------------------------------------------------------------------------------|---|\n| [int64_t](/guide/topics/renderscript/reference/rs_value_types#android_rs:int64_t) rsUptimeMillis(); | |\n\n##### Returns\n\n|-------------------------|\n| Uptime in milliseconds. |\n\nReturns the current system clock (uptime) in milliseconds. \n\n#### rsUptimeNanos\n: System uptime in nanoseconds\n\n|----------------------------------------------------------------------------------------------------|---|\n| [int64_t](/guide/topics/renderscript/reference/rs_value_types#android_rs:int64_t) rsUptimeNanos(); | |\n\n##### Returns\n\n|------------------------|\n| Uptime in nanoseconds. |\n\nReturns the current system clock (uptime) in nanoseconds.\n\nThe granularity of the values return by this call may be much larger than a nanosecond."]]