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

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

ينشئ التابع gm توقيتا جديدًا استنادًا إلى القيم المعطاة، ويتم تفسيرها وفق التوقيت العالمي الموحد UTC ‏(GMT).

يجب تحديد السنة عند استعمال هذا التابع. أما القيم الأخرى، فتساوي افتراضيًّا الحد الأدنى لقيمها (وقد تكون nil، أو قد تُحذف).

سيُطلق الاستثناء ArgumentError إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر وسائط لأجل استخدامها في مخرجات التابع to_a.

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

gm(year) → time
gm(year, month) → time
gm(year, month, day) → time
gm(year, month, day, hour) → time
gm(year, month, day, hour, min) → time
gm(year, month, day, hour, min, sec_with_frac) → time
gm(year, month, day, hour, min, sec, usec_with_frac) → time
gm(sec, min, hour, day, month, year, dummy, dummy, dummy, dummy) → time‎

المعاملات

`year‎`

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

`month‎`

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

`day‎`

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

`hour‎`

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

`min‎`

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

`sec‎`

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

`sec_with_frac‎`

عدد يمثِّل الثانية مع أجزائها. أي يمكن أن يحتوي هذا المعامل على فواصل عشرية.

`usec_with_frac`

أجزاء الثانية برتبة مايكرو ثانية مع أجزاء المايكرو ثانية (أي التي من رتبة نانو ثانية). أي يمكن أن يحتوي هذا المعامل على فواصل عشرية.

`dummy`

قيمة فارغة معدومة.

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

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

أمثلة

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

Time.utc(2000,"jan",1,20,15,1)  #=> 2000-01-01 20:15:01 UTC
Time.gm(2000,"jan",1,20,15,1)   #=> 2000-01-01 20:15:01 UTC‎

انظر أيضًا

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

مصادر

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

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