عرض مصدر Ruby/Time/getlocal

<noinclude>{{DISPLAYTITLE: التابع <code>getlocal‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Time]]
يُعيد التابع <code>getlocal</code> [[Ruby/Time|توقيت]]ا جديدا يمثل [[Ruby/Time|التوقيت]] الذي استُدعي معه بالتوقيت المحلي (باستخدام المنطقة الزمنية المحلية السارية لهذه العملية).

قي حال إعطاء الوسيط <code>utc_offset</code>، يتم استخدامه بدلاً من الوقت المحلي. يمكن إعطاء <code>utc_offset</code> ك[[Ruby/String|سلسلة نصية]] قابلة لقراءة (على سبيل المثال <code>"+09:00"</code>) أو كعدد من الثواني (على سبيل المثال <code>32400</code>).
==البنية العامة==
<syntaxhighlight lang="ruby">getlocal → new_time
getlocal(utc_offset) → new_time‎</syntaxhighlight>
==المعاملات==
===<code>utc_offset‎</code>===
فارق التوقيت مع التوقيت العالمي الموحد
==القيمة المُعادة==
يُعيد التابع <code>getlocal</code> [[Ruby/Time|توقيت]]ا جديدا يمثل [[Ruby/Time|التوقيت]] الذي استُدعي معه بالتوقيت المحلي.

==أمثلة==
مثال على استخدام التابع <code>getlocal‎</code>:
<syntaxhighlight lang="ruby">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‎</syntaxhighlight>
==انظر أيضا==
* التابع <code>[[Ruby/Time/getgm|getgm]]</code>: يُعيد التابع <code>getgm</code> [[Ruby/Time|توقيت]]ا <code>[[Ruby/Time|Time]]</code> جديدا يمثل [[Ruby/Time|التوقيت]] الذي استُدعي معه <code>time</code> بالتوقيت العالمي الموحد (UTC).
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Time.html#method-i-getlocal قسم  التابع getlocal‎ في الصنف Time‎ في توثيق روبي الرسمي.]