التابع Time.getlocal‎ في روبي

من موسوعة حسوب
< Ruby‏ | Time
مراجعة 13:37، 6 ديسمبر 2018 بواسطة جميل-بيلوني (نقاش | مساهمات) (مراجعة وتدقيق.)
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)
اذهب إلى التنقل اذهب إلى البحث

يُعيد التابع 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‎

انظر أيضًا

  • التابع getgm: يُعيد توقيتًا جديدًا يمثل التوقيت الذي استُدعي معه بالتوقيت العالمي الموحد (UTC).

مصادر