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

مراجعة 19:38، 7 نوفمبر 2018

يحول التابع utc التوقيت إلى التوقيت العالمي الموحد UTC‏. مع تعديل الكائن المستقبٍل (receiver)

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

gmtime → time 
utc → time

القيمة المُعادة

يعيد التابع utc توقيتا جديدا.

أمثلة

مثال على استخدام التابع utc‎:

t = Time.now   #=> 2007-11-19 08:18:31 -0600
t.gmt?         #=> false
t.gmtime       #=> 2007-11-19 14:18:31 UTC
t.gmt?         #=> true

t = Time.now   #=> 2007-11-19 08:18:51 -0600
t.utc?         #=> false
t.utc          #=> 2007-11-19 14:18:51 UTC
t.utc?         #=> true

انظر أيضا

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

مصادر

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

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Time]]
-ينشئ التابع <code>utc</code> [[Ruby/Time|توقيت]]ا جديدا استنادًا إلى القيم المعطاة، ويتم تفسيره وفق التوقيت العالمي الموحد UTC‏ (GMT).
+يحول التابع <code>utc</code> [[Ruby/Time|التوقيت]] إلى التوقيت العالمي الموحد UTC‏. مع تعديل الكائن المستقبٍل (receiver)
-يجب تحديد السنة. أما القيم الأخرى فتُضبط افتراضيا عند الحد الأدنى لقيمة هذا الحقل (وقد تساوي <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> على جزء كسري.
 ==البنية العامة==
-<syntaxhighlight lang="ruby">utc(year) → time
+<syntaxhighlight lang="ruby">gmtime → time
-utc(year, month) → time
+utc → time</syntaxhighlight>
-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‎</syntaxhighlight>
-==المعاملات==
-===<code>year‎</code>===
-السنة
-===<code>month‎</code>===
-الشهر
-===<code>day‎</code>===
-اليوم
-===<code>hour‎</code>===
-الساعة
-===<code>min‎</code>===
-الدقيقة
-===<code>sec_with_frac‎</code>===
-الثانية مع كسورها
-===<code>sec‎</code>===
-الثانية
-===<code>usec_with_frac‎</code>===
-فارق التوقيت مع التوقيت العالمي الموحد.
 ==القيمة المُعادة==
-يعيد التابع <code>utc</code> [[Ruby/Time|توقيت]]ا جديدا استنادًا إلى القيم المعطاة.
+يعيد التابع <code>utc</code> [[Ruby/Time|توقيت]]ا جديدا.
 ==أمثلة==
 مثال على استخدام التابع <code>utc‎</code>:
-<syntaxhighlight lang="ruby">Time.utc(2000,"jan",1,20,15,1)  #=> 2000-01-01 20:15:01 UTC
+<syntaxhighlight lang="ruby">t = Time.now   #=> 2007-11-19 08:18:31 -0600
-Time.gm(2000,"jan",1,20,15,1)   #=> 2000-01-01 20:15:01 UTC‎</syntaxhighlight>
+t.gmt?         #=> false
+t.gmtime       #=> 2007-11-19 14:18:31 UTC
+t.gmt?         #=> true
+t = Time.now   #=> 2007-11-19 08:18:51 -0600
+t.utc?         #=> false
+t.utc          #=> 2007-11-19 14:18:51 UTC
+t.utc?         #=> true</syntaxhighlight>
 ==انظر أيضا==
 * التابع <code>[[Ruby/Time/at|at]]</code>: ينشئ التابع <code>at</code> توقيتا جديدًا.
-* التابع <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-c-utc قسم  تابع النسخة utc‎ في الصنف Time‎ في توثيق روبي الرسمي.]