التابع 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
الثانية
usec_with_frac
dummy
القيمة المُعادة
أمثلة
مثال على استخدام التابع 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).