التابع 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