الفرق بين المراجعتين لصفحة: «Ruby/Time/getlocal»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع <code>getlocal | <noinclude>{{DISPLAYTITLE: التابع <code>Time.getlocal</code> في روبي}}</noinclude> | ||
[[تصنيف: Ruby]] | [[تصنيف: Ruby]] | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Time]] | [[تصنيف: Ruby Time]] | ||
يُعيد التابع <code>getlocal</code> [[Ruby/Time| | يُعيد التابع <code>getlocal</code> [[Ruby/Time|توقيتً]]ا جديدًا يمثل [[Ruby/Time|التوقيت]] الذي استُدعي معه بالتوقيت المحلي (باستخدام المنطقة الزمنية المحلية السارية لهذه العملية). | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">getlocal → new_time | <syntaxhighlight lang="ruby">getlocal → new_time | ||
| سطر 11: | سطر 9: | ||
==المعاملات== | ==المعاملات== | ||
===<code>utc_offset</code>=== | ===<code>utc_offset</code>=== | ||
فارق التوقيت مع التوقيت العالمي الموحد | فارق التوقيت مع التوقيت العالمي الموحد. يمكن أن يكون هذا المعامل [[Ruby/String|سلسلة نصية]] قابلة للقراءة كوقت (مثل <code>"+09:00"</code>) أو كعدد من الثواني (مثل <code>32400</code>). | ||
==القيمة | ==القيمة المعادة== | ||
يعاد [[Ruby/Time|توقيتٌ]] جديدٌ يمثل [[Ruby/Time|التوقيت]] المعطى بالتوقيت المحلي. إن أعطي المعامل <code>utc_offset</code>، فسيتم استخدامه بدلًا من الوقت المحلي. | |||
==أمثلة== | ==أمثلة== | ||
| سطر 28: | سطر 26: | ||
k.utc? #=> false | k.utc? #=> false | ||
t == k #=> true</syntaxhighlight> | t == k #=> true</syntaxhighlight> | ||
==انظر | ==انظر أيضًا== | ||
* التابع <code>[[Ruby/Time/getgm|getgm]]</code>: يُعيد | * التابع <code>[[Ruby/Time/getgm|getgm]]</code>: يُعيد [[Ruby/Time|توقيتً]]ا جديدًا يمثل [[Ruby/Time|التوقيت]] الذي استُدعي معه بالتوقيت العالمي الموحد (UTC). | ||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/Time.html#method-i-getlocal قسم | *[http://ruby-doc.org/core-2.5.1/Time.html#method-i-getlocal قسم التابع getlocal في الصنف 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