التابع getlocal الخاص بالصنف Time في روبي
يُعيد التابع getlocal توقيتا جديدا يمثل التوقيت الذي استُدعي معه بالتوقيت المحلي (باستخدام المنطقة الزمنية المحلية السارية لهذه العملية).
قي حال إعطاء الوسيط utc_offset، يتم استخدامه بدلاً من الوقت المحلي. يمكن إعطاء utc_offset كسلسلة نصية قابلة لقراءة (على سبيل المثال "+09:00") أو كعدد من الثواني (على سبيل المثال 32400).
البنية العامة
getlocal → new_time
getlocal(utc_offset) → new_time
المعاملات
utc_offset
فارق التوقيت مع التوقيت العالمي الموحد
القيمة المُعادة
يُعيد التابع getlocal توقيتا جديدا يمثل التوقيت الذي استُدعي معه بالتوقيت المحلي.
أمثلة
مثال على استخدام التابع getlocal:
t = Time.utc(2000,1,1,20,15,1) #=> 2000-01-01 20:15:01 UTC
t.utc? #=> true
l = t.getlocal #=> 2000-01-01 14:15:01 -0600
l.utc? #=> false
t == l #=> true
j = t.getlocal("+09:00") #=> 2000-01-02 05:15:01 +0900
j.utc? #=> false
t == j #=> true
k = t.getlocal(9*60*60) #=> 2000-01-02 05:15:01 +0900
k.utc? #=> false
t == k #=> true
انظر أيضا
- التابع
getgm: يُعيد التابعgetgmتوقيتاTimeجديدا يمثل التوقيت الذي استُدعي معهtimeبالتوقيت العالمي الموحد (UTC).