الفرق بين المراجعتين ل"Ruby/Time/getlocal"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>getlocal</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude> تصنيف: Ruby تصني...') |
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة وتدقيق.) |
||
| (مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 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>، فسيتم استخدامه بدلًا من الوقت المحلي. | ||
| + | |||
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <code>getlocal</code>: | مثال على استخدام التابع <code>getlocal</code>: | ||
| سطر 26: | سطر 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