الفرق بين المراجعتين لصفحة: «Ruby/Time/localtime»

المراجعة الحالية بتاريخ 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: يتحقق إن وقع التوقيت الذي استُدعي معه أثناء التوقيت الصيفي في منطقته الزمنية.

مصادر

قسم التابع localtime‎ في الصنف Time‎ في توثيق روبي الرسمي.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>localtime‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>Time.localtime‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: 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
@@ سطر 11: / سطر 9: @@
 ==المعاملات==
 ===<code>utc_offset‎</code>===
-فارق التوقيت مع التوقيت العالمي الموحد
+فارق التوقيت مع التوقيت العالمي الموحد.
-==القيمة المُعادة==
+==القيمة المعادة==
+يعاد التوقيت نفسه المعطى بعد تحويله إلى التوقيت المحلي. في حال إعطاء المعامل <code>utc_offset</code>، سيتم استخدامه بدلًا من الوقت المحلي.
 ==أمثلة==
 مثال على استخدام التابع <code>localtime‎</code>:
@@ سطر 21: / سطر 21: @@
 t.localtime("+09:00")                   #=> 2000-01-02 05:15:01 +0900
 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‎ في توثيق روبي الرسمي.]