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

من موسوعة حسوب
< Ruby‏ | Time
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق.)
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>local‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: التابع <code>Time.local‎</code> في روبي}}</noinclude>
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Time]]
 
[[تصنيف: Ruby Time]]
التابع <code>local</code> مشابه لـ <code>[[Ruby/Time/gm|::gm]]</code>، ولكنه يفسر القيم في إطار المنطقة الزمنية المحلية.
+
ينشئ التابع <code>local</code> توقيتًا جديدًا بشكل مشابه للتابع <code>[[Ruby/Time/gm|gm]]</code> باستثناء أنَّه يفسر القيم في إطار المنطقة الزمنية المحلية.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="ruby">local(year) → time
 
<syntaxhighlight lang="ruby">local(year) → time
سطر 15: سطر 15:
 
==المعاملات==
 
==المعاملات==
 
===<code>year‎</code>===
 
===<code>year‎</code>===
السنة
+
عدد يمثِّل السنة.
 
===<code>month‎</code>===
 
===<code>month‎</code>===
الشهر
+
عدد بين 1 و 12 يمثِّل الشهر، أو ثلاثة أحرف أجنبية تمثل اسم الشهر.
 
===<code>day‎</code>===
 
===<code>day‎</code>===
اليوم
+
عدد يمثِّل اليوم.
 
===<code>hour‎</code>===
 
===<code>hour‎</code>===
الساعة
+
عدد بين 0 و 23 يمثِّل الساعة.
 
===<code>min‎</code>===
 
===<code>min‎</code>===
الدقيقة
+
عدد يمثِّل الدقيقة.
 +
===<code>sec‎</code>===
 +
عدد يمثِّل الثانية.
 
===<code>sec_with_frac‎</code>===
 
===<code>sec_with_frac‎</code>===
الثانية مع كسورها
+
عدد يمثِّل الثانية مع أجزائها.
===<code>sec‎</code>===
+
 
الثانية
+
=== <code>usec_with_frac</code> ===
===<code>usec_with_frac‎</code>===
+
أجزاء الثانية برتبة مايكرو ثانية مع أجزاء المايكرو ثانية (أي التي من رتبة نانو ثانية).
===<code>dummy‎</code>===
+
 
===<code>isdst‎</code>===
+
==القيمة المعادة==
==القيمة المُعادة==
+
يعاد <nowiki/>[[Ruby/Time|توقيتٌ]] جديدٌ استنادًا إلى القيم المعطاة.
 +
 
 
==أمثلة==
 
==أمثلة==
 
مثال على استخدام التابع <code>local‎</code>:
 
مثال على استخدام التابع <code>local‎</code>:
 
<syntaxhighlight lang="ruby">Time.local(2000,"jan",1,20,15,1)  #=> 2000-01-01 20:15:01 -0600‎</syntaxhighlight>
 
<syntaxhighlight lang="ruby">Time.local(2000,"jan",1,20,15,1)  #=> 2000-01-01 20:15:01 -0600‎</syntaxhighlight>
==انظر أيضا==
+
==انظر أيضًا==
* التابع <code>[[Ruby/Time/gm|gm]]</code>: ينشئ التابع <code>gm</code> [[Ruby/Time|توقيت]]ا <code>[[Ruby/Time|Time]]</code> استنادًا إلى القيم المعطاة، ويتم تفسيرها على أنها UTC (GMT). يجب تحديد السنة. القيم الأخرى تساوي افتراضيا الحد الأدنى لقيمة هذا الحقل (وقد تكون <code>nil</code> أو قد تُحذف). يمكن تحديد الشهر بعدد من 1 إلى 12، أو بأسماء الشهور الإنجليزية المكونة من ثلاثة أحرف. يتم تحديد الساعات من المجال (0..23). سيُطلق استثناء <code>[[Ruby/ArgumentError|ArgumentError]]</code> إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر وسائط في الطلب المُخرج من <code>[[Ruby/Time/to_a|#to_a]]</code>.
+
* التابع <code>[[Ruby/Time/at|at]]</code>: ينشئ [[Ruby/Time|توقيت]]ا جديدًا انطلاقًا من معلومات الوقت المٌمرَّرة إليه.
* التابع <code>[[Ruby/Time/mktime|mktime]]</code>: التابع <code>mktime</code> مشابه لـ <code>[[Ruby/Time/gm|::gm]]</code>، ولكنه يفسر القيم في إطار المنطقة الزمنية المحلية. المنطقة الزمنية المحلية.
+
* التابع <code>[[Ruby/Time/gm|gm]]</code>: ينشئ [[Ruby/Time|توقيتً]]ا  استنادًا إلى القيم المعطاة.  
 +
* التابع <code>[[Ruby/Time/mktime|mktime]]</code>: ينشئ توقيتًا جديدًا بشكل مشابه للتابع <code>[[Ruby/Time/gm|gm]]</code> باستثناء أنَّه يفسر القيم في إطار المنطقة الزمنية المحلية.  
 
==مصادر==
 
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Time.html#method-c-local قسم التابع local‎ في الصنف Time‎ في توثيق روبي الرسمي.]
+
*[http://ruby-doc.org/core-2.5.1/Time.html#method-c-local قسم التابع local‎ في الصنف Time‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 12:04، 6 ديسمبر 2018

ينشئ التابع local توقيتًا جديدًا بشكل مشابه للتابع gm باستثناء أنَّه يفسر القيم في إطار المنطقة الزمنية المحلية.

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

local(year)  time
local(year, month)  time
local(year, month, day)  time
local(year, month, day, hour)  time
local(year, month, day, hour, min)  time
local(year, month, day, hour, min, sec_with_frac)  time
local(year, month, day, hour, min, sec, usec_with_frac)  time
local(sec, min, hour, day, month, year, dummy, dummy, isdst, dummy)  time

المعاملات

year‎

عدد يمثِّل السنة.

month‎

عدد بين 1 و 12 يمثِّل الشهر، أو ثلاثة أحرف أجنبية تمثل اسم الشهر.

day‎

عدد يمثِّل اليوم.

hour‎

عدد بين 0 و 23 يمثِّل الساعة.

min‎

عدد يمثِّل الدقيقة.

sec‎

عدد يمثِّل الثانية.

sec_with_frac‎

عدد يمثِّل الثانية مع أجزائها.

usec_with_frac

أجزاء الثانية برتبة مايكرو ثانية مع أجزاء المايكرو ثانية (أي التي من رتبة نانو ثانية).

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

يعاد توقيتٌ جديدٌ استنادًا إلى القيم المعطاة.

أمثلة

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

Time.local(2000,"jan",1,20,15,1)   #=> 2000-01-01 20:15:01 -0600‎

انظر أيضًا

  • التابع at: ينشئ توقيتا جديدًا انطلاقًا من معلومات الوقت المٌمرَّرة إليه.
  • التابع gm: ينشئ توقيتًا استنادًا إلى القيم المعطاة.
  • التابع mktime: ينشئ توقيتًا جديدًا بشكل مشابه للتابع gm باستثناء أنَّه يفسر القيم في إطار المنطقة الزمنية المحلية.

مصادر