الفرق بين المراجعتين ل"Ruby/Time/localtime"

من موسوعة حسوب
< Ruby‏ | Time
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق.)
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>localtime‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: التابع <code>Time.localtime‎</code> في روبي}}</noinclude>
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Time]]
 
[[تصنيف: Ruby Time]]
يحول التابع <code>localtime</code> [[Ruby/Time|التوقيت]] الذي استُدعي معه إلى التوقيت المحلي (باستخدام المنطقة الزمنية المحلية السارية لهذه العملية) مع تعديل المستقبِل (receiver).
+
يحول التابع <code>localtime</code> [[Ruby/Time|التوقيت]] الذي استُدعي معه إلى التوقيت المحلي (باستخدام المنطقة الزمنية المحلية السارية لهذه العملية). انتبه إلى أنَّ هذا التابع يعدل على التوقيت المعطى نفسه.
 
 
قي حال إعطاء الوسيط <code>utc_offset</code>، سيتم استخدامه بدلاً من الوقت المحلي.
 
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="ruby">localtime → time
 
<syntaxhighlight lang="ruby">localtime → time
سطر 11: سطر 9:
 
==المعاملات==
 
==المعاملات==
 
===<code>utc_offset‎</code>===
 
===<code>utc_offset‎</code>===
فارق التوقيت مع التوقيت العالمي الموحد
+
فارق التوقيت مع التوقيت العالمي الموحد.
==القيمة المُعادة==
+
==القيمة المعادة==
يعيد التابع <code>localtime</code> [[Ruby/Time|توقيتا]].
+
يعاد التوقيت نفسه المعطى بعد تحويله إلى التوقيت المحلي. في حال إعطاء المعامل <code>utc_offset</code>، سيتم استخدامه بدلًا من الوقت المحلي.
  
 
==أمثلة==
 
==أمثلة==
سطر 23: سطر 21:
 
t.localtime("+09:00")                  #=> 2000-01-02 05:15:01 +0900
 
t.localtime("+09:00")                  #=> 2000-01-02 05:15:01 +0900
 
t.utc?                                  #=> false‎</syntaxhighlight>
 
t.utc?                                  #=> false‎</syntaxhighlight>
==انظر أيضا==
+
==انظر أيضًا==
* التابع <code>[[Ruby/Time/isdst|isdst]]</code>: يُعيد التابع <code>isdst</code> القيمة <code>true</code> إن وقع [[Ruby/Time|التوقيت]] <code>time</code> أثناء التوقيت الصيفي.
+
* التابع <code>[[Ruby/Time/isdst|isdst]]</code>: يتحقق إن وقع [[Ruby/Time|التوقيت]] الذي استُدعي معه أثناء التوقيت الصيفي في منطقته الزمنية.
 
==مصادر==
 
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Time.html#method-i-localtime قسم التابع localtime‎ في الصنف Time‎ في توثيق روبي الرسمي.]
+
*[http://ruby-doc.org/core-2.5.1/Time.html#method-i-localtime قسم التابع localtime‎ في الصنف Time‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 14:58، 7 ديسمبر 2018

يحول التابع localtime التوقيت الذي استُدعي معه إلى التوقيت المحلي (باستخدام المنطقة الزمنية المحلية السارية لهذه العملية). انتبه إلى أنَّ هذا التابع يعدل على التوقيت المعطى نفسه.

البنية العامة

localtime  time
localtime(utc_offset)  time

المعاملات

utc_offset‎

فارق التوقيت مع التوقيت العالمي الموحد.

القيمة المعادة

يعاد التوقيت نفسه المعطى بعد تحويله إلى التوقيت المحلي. في حال إعطاء المعامل utc_offset، سيتم استخدامه بدلًا من الوقت المحلي.

أمثلة

مثال على استخدام التابع localtime‎:

t = Time.utc(2000, "jan", 1, 20, 15, 1) #=> 2000-01-01 20:15:01 UTC
t.utc?                                  #=> true
t.localtime                             #=> 2000-01-01 14:15:01 -0600
t.utc?                                  #=> false
t.localtime("+09:00")                   #=> 2000-01-02 05:15:01 +0900
t.utc?                                  #=> false‎

انظر أيضًا

  • التابع isdst: يتحقق إن وقع التوقيت الذي استُدعي معه أثناء التوقيت الصيفي في منطقته الزمنية.

مصادر