تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

الدوال الزمنية وأنواعها في RenderScript

نظرة عامة

يمكن استخدام الدوال أدناه لمعرفة وقت الساعة الحالي ووقت ضبط النظام الحالي. لا يُنصح باستدعاء هذه الدوال داخل النواة (kernel).

الأنواع
rs_time_t	الثواني منذ 1 كانون الثاني (يناير) 1970
rs_tm	هيكل التاريخ والوقت

الدوال
rsGetDt	الوقت المنقضي منذ آخر مكالمة
rsLocaltime	التحويل إلى التوقيت المحلي
rsTime	الثواني منذ 1 كانون الثاني (يناير) 1970
rsUptimeMillis	مدة تشغيل النظام بالمللي ثانية
rsUptimeNanos	مدة تشغيل النظام بالنانو ثانية

تعريف نوعي: int عند التحويل إلى 32 بت.

تعريف طباعيّ لـ: long عند التجميع لـ 64 بت.

وقت التقويم مفسَّر على أنّه الثواني المنقضية منذ الحقبة (00:00:00 في 1 كانون الثاني (يناير) 1970، التوقيت العالمي المنسَّق (UTC)).

بنية تتضمّن الحقول التالية:

عدد صحيح 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	وضع علامة للإشارة إلى ما إذا كان نظام التوقيت الصيفي ساري المفعول. وتكون القيمة موجبة في حالة تطبيقها، وتكون صفر في حالة عدم وجودها، وسالبة في حالة عدم توفر المعلومات.

هيكل بيانات لمكونات الوقت المُقسَّمة.

float rsGetDt();

الوقت بالثواني.

لعرض الوقت بالثواني منذ آخر طلب لهذه الدالة في هذا النص البرمجي.

rs_tm* rsLocaltime(rs_tm* local, Const rs_time_t* أنواع الموقتات)،

محلي	مؤشر إلى بنية زمنية يتم فيها تخزين الوقت المحلي.
موقّت	إدخال الوقت كعدد من الثواني منذ 1 كانون الثاني (يناير) 1970.

أشِر إلى التوقيت المحلي للناتج، أي قيمة مماثلة للمَعلمة المحلية.

تحوِّل هذه الدالة الوقت الذي يحدِّده الموقّت إلى بنية rs_tm توفّر السنة والشهر والساعة وغير ذلك. ويتم تخزين هذه القيمة على *local.

تعرض هذه الدالة المؤشر نفسه الذي تم تمريره كوسيطة أولى. إذا كانت المعلمة المحلية فارغة، فلن تفعل هذه الدالة أي شيء وتعرض NULL.

rs_time_t rsTime(rs_time_t* أنواع الموقت

موقّت	موقع لتخزين وقت التقويم المعروض أيضًا.

الثواني التي تلي الحقبة، والقيمة -1 في حال حدوث خطأ.

لعرض عدد الثواني منذ الحقبة (00:00:00 بالتوقيت العالمي المنسق، 1 كانون الثاني (يناير) 1970).

إذا كان المؤقت غير فارغ، فسيتم تخزين النتيجة أيضًا في الذاكرة المشار إليها من خلال هذا المتغير.

int64_t rsUptimeMillis();

مدة التشغيل بالمللي ثانية

لعرض ساعة النظام الحالية (وقت التشغيل) بالمللي ثانية.

int64_t rsUptimeNanos()،

مدة التشغيل بالثواني

عرض ساعة النظام الحالية (مدة التشغيل) بالنانو ثانية.

قد تكون دقة القيم التي تعرضها هذه المكالمة أكبر بكثير من نانو ثانية.