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

من موسوعة حسوب
< Ruby‏ | Time
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>localtime‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude> تصنيف: Ruby تصن...')
 
ط (مراجعة وتدقيق.)
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 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|التوقيت]] <code>time</code> إلى التوقيت المحلي (باستخدام المنطقة الزمنية المحلية السارية لهذه العملية) مع تعديل المستقبِل (receiver).
+
يحول التابع <code>localtime</code> [[Ruby/Time|التوقيت]] الذي استُدعي معه إلى التوقيت المحلي (باستخدام المنطقة الزمنية المحلية السارية لهذه العملية). انتبه إلى أنَّ هذا التابع يعدل على التوقيت المعطى نفسه.
 
 
قي حال إعطاء الوسيط <code>[[Ruby/Time/utc_offset|utc_offset]]</code>، يتم استخدامه بدلاً من الوقت المحلي.
 
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="ruby">localtime → time
 
<syntaxhighlight lang="ruby">localtime → time
سطر 11: سطر 9:
 
==المعاملات==
 
==المعاملات==
 
===<code>utc_offset‎</code>===
 
===<code>utc_offset‎</code>===
فارق التوقيت مع التوقيت العالمي الموحد
+
فارق التوقيت مع التوقيت العالمي الموحد.
==القيمة المُعادة==
+
==القيمة المعادة==
 +
يعاد التوقيت نفسه المعطى بعد تحويله إلى التوقيت المحلي. في حال إعطاء المعامل <code>utc_offset</code>، سيتم استخدامه بدلًا من الوقت المحلي.
 +
 
 
==أمثلة==
 
==أمثلة==
 
مثال على استخدام التابع <code>localtime‎</code>:
 
مثال على استخدام التابع <code>localtime‎</code>:
سطر 21: سطر 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|Time]]</code> في المنطقة الزمنية الخاصة به.
+
* التابع <code>[[Ruby/Time/isdst|isdst]]</code>: يتحقق إن وقع [[Ruby/Time|التوقيت]] الذي استُدعي معه أثناء التوقيت الصيفي في منطقته الزمنية.
* التابع <code>[[Ruby/Time/mday|mday]]</code>: يستخلص التابع <code>mday</code> من [[Ruby/Time|التوقيت]] رقم اليوم من الشهر (1..n) لـ <code>time</code>.
 
 
==مصادر==
 
==مصادر==
*[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: يتحقق إن وقع التوقيت الذي استُدعي معه أثناء التوقيت الصيفي في منطقته الزمنية.

مصادر