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

مصادر