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

مراجعة 10:09، 7 نوفمبر 2018

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

يجب تحديد السنة. أما القيم الأخرى فتساوي افتراضيا الحد الأدنى لقيمة هذا الحقل (وقد تكون nil، أو قد تُحذف). يمكن تحديد الشهر بعدد بين 1 و 12، أو بثلاثة أحرف إنجليزية تمثل أسماء الشهور. يتم تحديد الساعات من المجال (0..23).

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

يمكن أن يكون للوسيطين sec_with_frac و usec_with_frac جزء كسري.

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

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‎`

الشهر

`day‎`

اليوم

`hour‎`

الساعة

`min‎`

الدقيقة

`sec_with_frac‎`

ثانية بكسورها

`sec‎`

الثانية

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

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

أمثلة

مثال على استخدام التابع 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: ينشئ التابع at توقيتا جديدًا.
التابع local: التابع local مشابه لـ gm، ولكنه يفسر القيم في إطار المنطقة الزمنية المحلية.

مصادر

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

@@ سطر 3: / سطر 3: @@
 [[تصنيف: 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>nil</code>، أو قد تُحذف). يمكن تحديد الشهر بعدد بين <code>1</code> و <code>12</code>،  أو بثلاثة أحرف إنجليزية تمثل  أسماء الشهور. يتم تحديد الساعات من المجال (0..23).
+سيُطلق استثناء <code>[[Ruby/ArgumentError|ArgumentError]]</code> إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر  وسائط لأجل استخدامها في مخرجات التابع <code>[[Ruby/Time/to_a|#to_a]]</code>.
 يمكن أن يكون للوسيطين <code>sec_with_frac</code> و <code>usec_with_frac</code> جزء كسري.
@@ سطر 17: / سطر 21: @@
 ==المعاملات==
 ===<code>year‎</code>===
+السنة
 ===<code>month‎</code>===
+الشهر
 ===<code>day‎</code>===
+اليوم
 ===<code>hour‎</code>===
+الساعة
 ===<code>min‎</code>===
+الدقيقة
 ===<code>sec_with_frac‎</code>===
+ثانية بكسورها
 ===<code>sec‎</code>===
-===<code>usec_with_frac‎</code>===
+الثانية
-===<code>dummy‎</code>===
 ==القيمة المُعادة==
+يعيد التابع <code>gm</code> [[Ruby/Time|توقيت]]ا جديدًا استنادًا إلى القيم المعطاة.
 ==أمثلة==
 مثال على استخدام التابع <code>gm‎</code>:
@@ سطر 31: / سطر 49: @@
 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>: ينشئ التابع <code>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>local</code> مشابه لـ <code>[[Ruby/Time/gm|gm]]</code>، ولكنه يفسر القيم في إطار المنطقة الزمنية المحلية.
 ==مصادر==
 *[http://ruby-doc.org/core-2.5.1/Time.html#method-c-gm قسم  التابع gm‎ في الصنف Time‎ في توثيق روبي الرسمي.]