التابع Time.getlocal في روبي
يُعيد التابع getlocal توقيتًا جديدًا يمثل التوقيت الذي استُدعي معه بالتوقيت المحلي (باستخدام المنطقة الزمنية المحلية السارية لهذه العملية).
البنية العامة
getlocal → new_time
getlocal(utc_offset) → new_time
المعاملات
utc_offset
فارق التوقيت مع التوقيت العالمي الموحد. يمكن أن يكون هذا المعامل سلسلة نصية قابلة للقراءة كوقت (مثل "+09:00") أو كعدد من الثواني (مثل 32400).
القيمة المعادة
يعاد توقيتٌ جديدٌ يمثل التوقيت المعطى بالتوقيت المحلي. إن أعطي المعامل 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