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

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>local‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>Time.local‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: 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
@@ سطر 15: / سطر 15: @@
 ==المعاملات==
 ===<code>year‎</code>===
+عدد يمثِّل السنة.
 ===<code>month‎</code>===
+عدد بين 1 و 12 يمثِّل الشهر، أو ثلاثة أحرف أجنبية تمثل اسم الشهر.
 ===<code>day‎</code>===
+عدد يمثِّل اليوم.
 ===<code>hour‎</code>===
+عدد بين 0 و 23 يمثِّل الساعة.
 ===<code>min‎</code>===
+عدد يمثِّل الدقيقة.
+===<code>sec‎</code>===
+عدد يمثِّل الثانية.
 ===<code>sec_with_frac‎</code>===
-===<code>sec‎</code>===
+عدد يمثِّل الثانية مع أجزائها.
-===<code>usec_with_frac‎</code>===
-===<code>dummy‎</code>===
+=== <code>usec_with_frac</code> ===
-===<code>isdst‎</code>===
+أجزاء الثانية برتبة مايكرو ثانية مع أجزاء المايكرو ثانية (أي التي من رتبة نانو ثانية).
-==القيمة المُعادة==
+==القيمة المعادة==
+يعاد <nowiki/>[[Ruby/Time|توقيتٌ]] جديدٌ استنادًا إلى القيم المعطاة.
 ==أمثلة==
 مثال على استخدام التابع <code>local‎</code>:
 <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‎ في توثيق روبي الرسمي.]