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