الفرق بين المراجعتين ل"Ruby/Time/utc"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>utc</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: R...') |
|||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Time]] | [[تصنيف: Ruby Time]] | ||
| − | + | ينشئ التابع <code>utc</code> [[Ruby/Time|توقيت]]ا جديدا استنادًا إلى القيم المعطاة، ويتم تفسيره وفق التوقيت العالمي الموحد UTC (GMT). | |
| − | ينشئ التابع <code>utc</code> [[Ruby/Time|توقيت]]ا | + | |
| + | يجب تحديد السنة. أما القيم الأخرى فتُضبط افتراضيا عند الحد الأدنى لقيمة هذا الحقل (وقد تساوي <code>nil</code>، أو قد تُحذف). يمكن تحديد الأشهر بإعداد من <code>1</code> إلى <code>12</code>، أو بثلاثة أحرف تمثل أسماء الشهور بالإنجليزية. يتم تحديد ساعات بعدد من (0..23). | ||
| + | |||
| + | يطلق استثناء <code>[[Ruby/ArgumentError|ArgumentError]]</code> إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر وسائط لاستخدامها في مخرجات التابع <code>[[Ruby/Time/to_a|to_a]]</code>. | ||
يمكن أن يحتوي الوسيطان <code>sec_with_frac</code> و <code>usec_with_frac</code> على جزء كسري. | يمكن أن يحتوي الوسيطان <code>sec_with_frac</code> و <code>usec_with_frac</code> على جزء كسري. | ||
| سطر 32: | سطر 35: | ||
الثانية | الثانية | ||
===<code>usec_with_frac</code>=== | ===<code>usec_with_frac</code>=== | ||
| − | + | فارق التوقيت مع التوقيت العالمي الموحد. | |
| + | |||
==القيمة المُعادة== | ==القيمة المُعادة== | ||
| + | يعيد التابع <code>utc</code> [[Ruby/Time|توقيت]]ا جديدا استنادًا إلى القيم المعطاة. | ||
| + | |||
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <code>utc</code>: | مثال على استخدام التابع <code>utc</code>: | ||
| سطر 39: | سطر 45: | ||
Time.gm(2000,"jan",1,20,15,1) #=> 2000-01-01 20:15:01 UTC</syntaxhighlight> | Time.gm(2000,"jan",1,20,15,1) #=> 2000-01-01 20:15:01 UTC</syntaxhighlight> | ||
==انظر أيضا== | ==انظر أيضا== | ||
| − | * التابع <code>[[Ruby/Time/ | + | * التابع <code>[[Ruby/Time/at|at]]</code>: ينشئ التابع <code>at</code> توقيتا جديدًا. |
| − | * التابع <code>[[Ruby/Time/ | + | * التابع <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 في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/Time.html#method-i-utc قسم التابع utc في الصنف Time في توثيق روبي الرسمي.] | ||
مراجعة 10:47، 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توقيتا جديدًا. - التابع
local: التابعlocalمشابه لـ[null gm]، ولكنه يفسر القيم في إطار المنطقة الزمنية المحلية.