التابع utc‎ الخاص بالصنف Time في روبي

<a href="#method-i-utc-3F"> </a> ينشئ التابع utc توقيتا Time استنادًا إلى القيم المعطاة، ويتم تفسيره على أنه التوقيت العالمي الموحد 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‎

الثانية

أمثلة

مثال على استخدام التابع 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‎

انظر أيضا

• التابع usec: يُعيد التابع usec عدد الميكروثواني المقابل للتوقيت time.
• التابع utc?‎: يُعيد التابع utc?‎ القيمة true إن كان التوقيت time يمثل يوم نظاق توقيت في التوقيت العالمي الموحد UTC (GMT).

مصادر

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