الفرق بين المراجعتين لصفحة: «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]]
 [[تصنيف: Ruby Time]]
-ينشئ التابع <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>gm</code> [[Ruby/Time|توقيت]]ا جديدًا استنادًا إلى القيم المعطاة، ويتم تفسيرها وفق التوقيت العالمي الموحد UTC ‏(GMT).
-يمكن أن يكون للوسيطين <code>sec_with_frac</code> و <code>usec_with_frac</code> جزء كسري.
+يجب تحديد السنة عند استعمال هذا التابع. أما القيم الأخرى، فتساوي افتراضيًّا الحد الأدنى لقيمها (وقد تكون <code>nil</code>، أو قد تُحذف).
+سيُطلق الاستثناء <code>[[Ruby/ArgumentError|ArgumentError]]</code> إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر  وسائط لأجل استخدامها في مخرجات التابع <code>[[Ruby/Time/to_a|to_a]]</code>.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">gm(year) → time
@@ سطر 17: / سطر 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>usec_with_frac</code> ===
-==القيمة المُعادة==
+أجزاء الثانية برتبة مايكرو ثانية مع أجزاء المايكرو ثانية (أي التي من رتبة نانو ثانية). أي يمكن أن يحتوي هذا المعامل على فواصل عشرية.
+=== <code>dummy</code> ===
+قيمة فارغة معدومة.
+==القيمة المعادة==
+يعاد [[Ruby/Time|توقيتٌ]] جديدٌ استنادًا إلى القيم الوقت المعطاة والمعاملات المُمرَّرة.
 ==أمثلة==
 مثال على استخدام التابع <code>gm‎</code>:
 <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|Time]]</code> مع القيم المعطاة من قِبل <code>time</code> (انظر فقرة البنية العامة)، أو عدد الثواني <code>seconds_with_frac</code>، أو عدد الثواني <code>seconds</code> والكسور <code>microseconds_with_frac</code> منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس]. يمكن أن يكون الوسيطان <code>seconds_with_frac</code> و <code>microseconds_with_frac</code> من النوع <code>[[Ruby/Integer|Integer]]</code> أو <code>[[Ruby/Float|Float]]</code> أو <code>[[Ruby/Rational|Rational]]</code> أو غيرها من الأصناف العددية (<code>[[Ruby/Numeric|Numeric]]</code>). تتيح الميزة غير المحمولة أن يكون الموضع (offset) سالبًا في بعض الأنظمة.
+* التابع <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‎ في توثيق روبي الرسمي.]