الفرق بين المراجعتين ل"Ruby/Time/utc-i"

من موسوعة حسوب
< Ruby‏ | Time
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: تابع النسخة <code>utc‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude> تصنيف: Ruby تص...')
 
سطر 3: سطر 3:
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Time]]
 
[[تصنيف: 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>:
 
مثال على استخدام التابع <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/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‎ في توثيق روبي الرسمي.]

مراجعة 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 توقيتا جديدًا.

مصادر