نظرة عامة
يمكن استخدام الدوال أدناه لمعرفة وقت الساعة الحالي ووقت ضبط النظام الحالي. لا يُنصح باستدعاء هذه الدوال داخل النواة (kernel).
ملخّص
| الأنواع | |
|---|---|
| rs_time_t | الثواني منذ 1 كانون الثاني (يناير) 1970 |
| rs_tm | هيكل التاريخ والوقت |
| الدوال | |
|---|---|
| rsGetDt | الوقت المنقضي منذ آخر مكالمة |
| rsLocaltime | التحويل إلى التوقيت المحلي |
| rsTime | الثواني منذ 1 كانون الثاني (يناير) 1970 |
| rsUptimeMillis | مدة تشغيل النظام بالمللي ثانية |
| rsUptimeNanos | مدة تشغيل النظام بالنانو ثانية |
الأنواع
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 : الوقت المنقضي منذ آخر مكالمة
| float rsGetDt(); |
الركلات المردودة
| الوقت بالثواني. |
لعرض الوقت بالثواني منذ آخر طلب لهذه الدالة في هذا النص البرمجي.
rsLocaltime : التحويل إلى التوقيت المحلي
المعلّمات
| محلي | مؤشر إلى بنية زمنية يتم فيها تخزين الوقت المحلي. |
|---|---|
| موقّت | إدخال الوقت كعدد من الثواني منذ 1 كانون الثاني (يناير) 1970. |
الركلات المردودة
| أشِر إلى التوقيت المحلي للناتج، أي قيمة مماثلة للمَعلمة المحلية. |
تحوِّل هذه الدالة الوقت الذي يحدِّده الموقّت إلى بنية rs_tm توفّر السنة والشهر والساعة وغير ذلك. ويتم تخزين هذه القيمة على *local.
تعرض هذه الدالة المؤشر نفسه الذي تم تمريره كوسيطة أولى. إذا كانت المعلمة المحلية فارغة، فلن تفعل هذه الدالة أي شيء وتعرض NULL.
rsTime : الثواني منذ 1 كانون الثاني (يناير) 1970
المعلّمات
| موقّت | موقع لتخزين وقت التقويم المعروض أيضًا. |
|---|
الركلات المردودة
| الثواني التي تلي الحقبة، والقيمة -1 في حال حدوث خطأ. |
لعرض عدد الثواني منذ الحقبة (00:00:00 بالتوقيت العالمي المنسق، 1 كانون الثاني (يناير) 1970).
إذا كان المؤقت غير فارغ، فسيتم تخزين النتيجة أيضًا في الذاكرة المشار إليها من خلال هذا المتغير.
rsUptimeMillis : مدة تشغيل النظام بالمللي ثانية
| int64_t rsUptimeMillis(); |
الركلات المردودة
| مدة التشغيل بالمللي ثانية |
لعرض ساعة النظام الحالية (وقت التشغيل) بالمللي ثانية.
rsUptimeNanos : مدة تشغيل النظام بالنانوثانية
| int64_t rsUptimeNanos()، |
الركلات المردودة
| مدة التشغيل بالثواني |
عرض ساعة النظام الحالية (مدة التشغيل) بالنانو ثانية.
قد تكون دقة القيم التي تعرضها هذه المكالمة أكبر بكثير من نانو ثانية.