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

المراجعة الحالية بتاريخ 12:03، 6 ديسمبر 2018

ينشئ التابع utc توقيتًا جديدًا استنادًا إلى القيم المعطاة، ويتم تفسيره وفق التوقيت العالمي الموحد UTC‏ (GMT).

يجب تحديد السنة عند استعمال هذا التابع. أما القيم الأخرى، فتساوي افتراضيًّا الحد الأدنى لقيمها (وقد تكون nil، أو قد تُحذف).

سيُطلق الاستثناء ArgumentError إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر وسائط لأجل استخدامها في مخرجات التابع to_a.

البنية العامة

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‎`

عدد بين 1 و 12 يمثِّل الشهر، أو ثلاثة أحرف أجنبية تمثل اسم الشهر.

`day‎`

عدد يمثِّل اليوم.

`hour‎`

عدد بين 0 و 23 يمثِّل الساعة.

`min‎`

عدد يمثِّل الدقيقة.

`sec‎`

عدد يمثِّل الثانية.

`sec_with_frac‎`

عدد يمثِّل الثانية مع أجزائها. أي يمكن أن يحتوي هذا المعامل على فواصل عشرية.

`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‎

انظر أيضًا

التابع at: ينشئ توقيتًا جديدًا.
التابع now: يُنشئ توقيتًا جديدًا للوقت الحالي.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>utc‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>Time.utc‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: 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>sec_with_frac</code> و <code>usec_with_frac</code> على جزء كسري.
+يجب تحديد السنة عند استعمال هذا التابع. أما القيم الأخرى، فتساوي افتراضيًّا الحد الأدنى لقيمها (وقد تكون <code>nil</code>، أو قد تُحذف).
+سيُطلق الاستثناء <code>[[Ruby/ArgumentError|ArgumentError]]</code> إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر  وسائط لأجل استخدامها في مخرجات التابع <code>[[Ruby/Time/to a|to_a]]</code>.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">utc(year) → time
@@ سطر 18: / سطر 19: @@
 ==المعاملات==
 ===<code>year‎</code>===
-السنة
+عدد يمثِّل السنة.
 ===<code>month‎</code>===
-الشهر
+عدد بين 1 و 12 يمثِّل الشهر، أو ثلاثة أحرف أجنبية تمثل اسم الشهر.
 ===<code>day‎</code>===
-اليوم
+عدد يمثِّل اليوم.
 ===<code>hour‎</code>===
-الساعة
+عدد بين 0 و 23 يمثِّل الساعة.
 ===<code>min‎</code>===
-الدقيقة
+عدد يمثِّل الدقيقة.
+===<code>sec‎</code>===
+عدد يمثِّل الثانية.
 ===<code>sec_with_frac‎</code>===
-الثانية مع كسورها
+عدد يمثِّل الثانية مع أجزائها. أي يمكن أن يحتوي هذا المعامل على فواصل عشرية.
-===<code>sec‎</code>===
-الثانية
+=== <code>usec_with_frac</code> ===
-===<code>usec_with_frac‎</code>===
+أجزاء الثانية برتبة مايكرو ثانية مع أجزاء المايكرو ثانية (أي التي من رتبة نانو ثانية). أي يمكن أن يحتوي هذا المعامل على فواصل عشرية.
-===<code>dummy‎</code>===
-==القيمة المُعادة==
+=== <code>dummy</code> ===
+قيمة فارغة معدومة.
+==القيمة المعادة==
+يعاد [[Ruby/Time|توقيتٌ]] جديدٌ استنادًا إلى القيم المعطاة.
 ==أمثلة==
 مثال على استخدام التابع <code>utc‎</code>:
 <syntaxhighlight lang="ruby">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‎</syntaxhighlight>
-==انظر أيضا==
+==انظر أيضًا==
-* التابع <code>[[Ruby/Time/usec|usec]]</code>: يُعيد التابع <code>usec</code> عدد الميكروثواني المقابل لل[[Ruby/Time|توقيت]] <code>time</code>.
+* التابع <code>[[Ruby/Time/at|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/now|now]]</code>: يُنشئ [[Ruby/Time|توقيتً]]ا جديدًا للوقت الحالي.
 ==مصادر==
-*[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‎ في توثيق روبي الرسمي.]