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

المراجعة الحالية بتاريخ 17:10، 7 ديسمبر 2018

يحول التابع utc التوقيت إلى التوقيت العالمي الموحد (UTC)‏. انتبه إلى أنَّ هذا التابع يعدِّل على التوقيت المعطى نفسه.

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

gmtime → time 
utc → time

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

يعاد التوقيت المعطى نفسه بعد تحويله إلى التوقيت العالمي الموحد.

أمثلة

مثال على استخدام التابع 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: ينشئ توقيتا جديدًا.
التابع utc_offset: يُعيد الفارق بين المنطقة الزمنية للتوقيت والتوقيت العالمي الموحد UTC بالثانية.
التابع utc?‎: يتحقق إن كان التوقيت في نطاق التوقيت العالمي الموحد.

مصادر

قسم تابع النسخة 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]]
-ينشئ التابع <code>utc</code> [[Ruby/Time|توقيت]]ا جديدا استنادًا إلى القيم المعطاة، ويتم تفسيره وفق التوقيت العالمي الموحد UTC‏ (GMT).
+يحول التابع <code>utc</code> [[Ruby/Time|التوقيت]] إلى التوقيت العالمي الموحد (UTC)‏. انتبه إلى أنَّ هذا التابع يعدِّل على التوقيت المعطى نفسه.
-يجب تحديد السنة. أما القيم الأخرى فتُضبط افتراضيا عند الحد الأدنى لقيمة هذا الحقل (وقد تساوي <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>:
-<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
-* التابع <code>[[Ruby/Time/at|at]]</code>: ينشئ التابع <code>at</code> توقيتا جديدًا.
+t.gmt?         #=> true
-* التابع <code>[[Ruby/Time/local|local]]</code>: التابع <code>local</code> مشابه لـ <code>[null gm]</code>، ولكنه يفسر القيم في إطار المنطقة الزمنية المحلية.
+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>[[Ruby/Time/utc offset|utc_offset]]</code>: يُعيد الفارق بين المنطقة الزمنية لل[[Ruby/Time|توقيت]] والتوقيت العالمي الموحد UTC بالثانية.
+* التابع <code>[[Ruby/Time/utc-3F|utc?‎]]</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-c-utc قسم تابع النسخة utc‎ في الصنف Time‎ في توثيق روبي الرسمي.]