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

مراجعة 19:38، 7 نوفمبر 2018

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

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

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

يمكن أن يحتوي الوسيطان sec_with_frac و usec_with_frac على جزء كسري.

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

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

المعاملات

`year‎`

السنة

`month‎`

الشهر

`day‎`

اليوم

`hour‎`

الساعة

`min‎`

الدقيقة

`sec_with_frac‎`

الثانية مع كسورها

`sec‎`

الثانية

`usec_with_frac‎`

فارق التوقيت مع التوقيت العالمي الموحد.

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

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

أمثلة

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

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 توقيتا جديدًا.

مصادر

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

@@ سطر 46: / سطر 46: @@
 ==انظر أيضا==
 * التابع <code>[[Ruby/Time/at|at]]</code>: ينشئ التابع <code>at</code> توقيتا جديدًا.
-* التابع <code>[[Ruby/Time/local|local]]</code>: التابع <code>local</code> مشابه لـ <code>[null gm]</code>، ولكنه يفسر القيم في إطار المنطقة الزمنية المحلية.
 ==مصادر==
 *[http://ruby-doc.org/core-2.5.1/Time.html#method-i-utc قسم  التابع utc‎ في الصنف Time‎ في توثيق روبي الرسمي.]