التابع gm الخاص بالصنف Time في روبي
ينشئ التابع 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، ولكنه يفسر القيم في إطار المنطقة الزمنية المحلية.