التابع getlocal‎ الخاص بالصنف Time في روبي

يُعيد التابع getlocal توقيتا Time جديدا يمثل التوقيت الذي استُدعي معه time بالتوقيت المحلي (باستخدام المنطقة الزمنية المحلية السارية لهذه العملية).

قي حال إعطاء الوسيط utc_offset، يتم استخدامه بدلاً من الوقت المحلي. يمكن إعطاء utc_offset كسلسلة نصية قابلة لقراءة (على سبيل المثال "+09:00") أو كعدد من الثواني (على سبيل المثال 32400

البنية العامة

getlocal → new_time
getlocal(utc_offset) → new_time‎

المعاملات

utc_offset‎

فارق التوقيت مع التوقيت العالمي الموحد

أمثلة

مثال على استخدام التابع 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).
• التابع getutc: يُعيد التابع getutc توقيتا Time جديدا يمثل التوقيت الذي استُدعي معه time بالتوقيت العالمي الموحد (UTC).

مصادر

• قسم التابع getlocal‎ في الصنف Time‎ في توثيق روبي الرسمي.