الفرق بين المراجعتين لصفحة: «Ruby/Time/utc»

مراجعة 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]، ولكنه يفسر القيم في إطار المنطقة الزمنية المحلية.

مصادر

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

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Time]]
-<a href="#method-i-utc-3F"> </a>
+ينشئ التابع <code>utc</code> [[Ruby/Time|توقيت]]ا جديدا استنادًا إلى القيم المعطاة، ويتم تفسيره وفق التوقيت العالمي الموحد UTC‏ (GMT).
-ينشئ التابع <code>utc</code> [[Ruby/Time|توقيت]]ا <code>[[Ruby/Time|Time]]</code> استنادًا إلى القيم المعطاة، ويتم تفسيره على أنه التوقيت العالمي الموحد UTC (GMT). يجب تحديد السنة. القيم الأخرى تُضبط افتراضيا عند الحد الأدنى لقيمة هذا الحقل (وقد تساوي <code>nil</code>، أو تُحذف). يمكن تحديد الأشهر بإعداد من 1 إلى 12، أو بثلاثة أحرف تمثل أسماء الشهور بالإنجليزية. يتم تحديد ساعات بعدد من (0..23). يطلق استثناء <code>[[Ruby/ArgumentError|ArgumentError]]</code> إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر وسائط في إخراج الطلب بواسطة <code>[[Ruby/Time/to_a|#to_a]]</code>.
+يجب تحديد السنة. أما القيم الأخرى فتُضبط افتراضيا عند الحد الأدنى لقيمة هذا الحقل (وقد تساوي <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> على جزء كسري.
@@ سطر 32: / سطر 35: @@
 الثانية
 ===<code>usec_with_frac‎</code>===
-===<code>dummy‎</code>===
+فارق التوقيت مع التوقيت العالمي الموحد.
 ==القيمة المُعادة==
+يعيد التابع <code>utc</code> [[Ruby/Time|توقيت]]ا جديدا استنادًا إلى القيم المعطاة.
 ==أمثلة==
 مثال على استخدام التابع <code>utc‎</code>:
@@ سطر 39: / سطر 45: @@
 Time.gm(2000,"jan",1,20,15,1)   #=> 2000-01-01 20:15:01 UTC‎</syntaxhighlight>
 ==انظر أيضا==
-* التابع <code>[[Ruby/Time/usec|usec]]</code>: يُعيد التابع <code>usec</code> عدد الميكروثواني المقابل لل[[Ruby/Time|توقيت]] <code>time</code>.
+* التابع <code>[[Ruby/Time/at|at]]</code>: ينشئ التابع <code>at</code> توقيتا جديدًا.
-* التابع <code>[[Ruby/Time/utc-3F|utc?‎]]</code>: يُعيد التابع <code>utc?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]] <code>time</code> يمثل يوم نظاق توقيت في التوقيت العالمي الموحد UTC (GMT).
+* التابع <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‎ في توثيق روبي الرسمي.]