الفرق بين المراجعتين لصفحة: «Ruby/Time/utc»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع <code>utc | <noinclude>{{DISPLAYTITLE: التابع <code>Time.utc</code> في روبي}}</noinclude> | ||
[[تصنيف: Ruby]] | [[تصنيف: Ruby]] | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Time]] | [[تصنيف: Ruby Time]] | ||
ينشئ التابع <code>utc</code> [[Ruby/Time| | ينشئ التابع <code>utc</code> [[Ruby/Time|توقيتً]]ا جديدًا استنادًا إلى القيم المعطاة، ويتم تفسيره وفق التوقيت العالمي الموحد UTC (GMT). | ||
يجب تحديد السنة. أما القيم | يجب تحديد السنة عند استعمال هذا التابع. أما القيم الأخرى، فتساوي افتراضيًّا الحد الأدنى لقيمها (وقد تكون <code>nil</code>، أو قد تُحذف). | ||
سيُطلق الاستثناء <code>[[Ruby/ArgumentError|ArgumentError]]</code> إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر وسائط لأجل استخدامها في مخرجات التابع <code>[[Ruby/Time/to a|to_a]]</code>. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">utc(year) → time | <syntaxhighlight lang="ruby">utc(year) → time | ||
| سطر 21: | سطر 19: | ||
==المعاملات== | ==المعاملات== | ||
===<code>year</code>=== | ===<code>year</code>=== | ||
السنة | عدد يمثِّل السنة. | ||
===<code>month</code>=== | ===<code>month</code>=== | ||
الشهر | عدد بين 1 و 12 يمثِّل الشهر، أو ثلاثة أحرف أجنبية تمثل اسم الشهر. | ||
===<code>day</code>=== | ===<code>day</code>=== | ||
اليوم | عدد يمثِّل اليوم. | ||
===<code>hour</code>=== | ===<code>hour</code>=== | ||
الساعة | عدد بين 0 و 23 يمثِّل الساعة. | ||
===<code>min</code>=== | ===<code>min</code>=== | ||
الدقيقة | عدد يمثِّل الدقيقة. | ||
===<code>sec</code>=== | |||
عدد يمثِّل الثانية. | |||
===<code>sec_with_frac</code>=== | ===<code>sec_with_frac</code>=== | ||
الثانية مع | عدد يمثِّل الثانية مع أجزائها. أي يمكن أن يحتوي هذا المعامل على فواصل عشرية. | ||
===<code> | |||
الثانية | === <code>usec_with_frac</code> === | ||
===<code> | أجزاء الثانية برتبة مايكرو ثانية مع أجزاء المايكرو ثانية (أي التي من رتبة نانو ثانية). أي يمكن أن يحتوي هذا المعامل على فواصل عشرية. | ||
=== <code>dummy</code> === | |||
قيمة فارغة معدومة. | |||
==القيمة | ==القيمة المعادة== | ||
يعاد [[Ruby/Time|توقيتٌ]] جديدٌ استنادًا إلى القيم المعطاة. | |||
==أمثلة== | ==أمثلة== | ||
| سطر 44: | سطر 46: | ||
<syntaxhighlight lang="ruby">Time.utc(2000,"jan",1,20,15,1) #=> 2000-01-01 20:15:01 UTC | <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> | Time.gm(2000,"jan",1,20,15,1) #=> 2000-01-01 20:15:01 UTC</syntaxhighlight> | ||
==انظر | ==انظر أيضًا== | ||
* التابع <code>[[Ruby/Time/at|at]]</code>: ينشئ التابع <code> | * التابع <code>[[Ruby/Time/at|at]]</code>: ينشئ توقيتًا جديدًا. | ||
* التابع <code>[[Ruby/Time/now|now]]</code>: يُنشئ [[Ruby/Time|توقيتً]]ا جديدًا للوقت الحالي. | |||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/Time.html#method-i-utc قسم | *[http://ruby-doc.org/core-2.5.1/Time.html#method-i-utc قسم التابع utc في الصنف Time في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 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