الفرق بين المراجعتين ل"Ruby/Time/gm"
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة وتدقيق.) |
|||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: التابع <code>gm | + | <noinclude>{{DISPLAYTITLE: التابع <code>Time.gm</code> في روبي}}</noinclude> |
[[تصنيف: Ruby]] | [[تصنيف: Ruby]] | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
| سطر 5: | سطر 5: | ||
ينشئ التابع <code>gm</code> [[Ruby/Time|توقيت]]ا جديدًا استنادًا إلى القيم المعطاة، ويتم تفسيرها وفق التوقيت العالمي الموحد UTC (GMT). | ينشئ التابع <code>gm</code> [[Ruby/Time|توقيت]]ا جديدًا استنادًا إلى القيم المعطاة، ويتم تفسيرها وفق التوقيت العالمي الموحد UTC (GMT). | ||
| − | يجب تحديد السنة. أما القيم | + | يجب تحديد السنة عند استعمال هذا التابع. أما القيم الأخرى، فتساوي افتراضيًّا الحد الأدنى لقيمها (وقد تكون <code>nil</code>، أو قد تُحذف). |
| − | سيُطلق | + | سيُطلق الاستثناء <code>[[Ruby/ArgumentError|ArgumentError]]</code> إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر وسائط لأجل استخدامها في مخرجات التابع <code>[[Ruby/Time/to_a|to_a]]</code>. |
| − | |||
| − | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">gm(year) → time | <syntaxhighlight lang="ruby">gm(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>dummy</code> === | ||
| + | قيمة فارغة معدومة. | ||
| − | ==القيمة | + | ==القيمة المعادة== |
| − | + | يعاد [[Ruby/Time|توقيتٌ]] جديدٌ استنادًا إلى القيم الوقت المعطاة والمعاملات المُمرَّرة. | |
==أمثلة== | ==أمثلة== | ||
| سطر 48: | سطر 52: | ||
<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>[[Ruby/Time/at|at]]</code>: ينشئ [[Ruby/Time|توقيت]]ا جديدًا انطلاقًا من معلومات الوقت المٌمرَّرة إليه. |
| − | * التابع <code>[[Ruby/Time/local|local]]</code>: | + | * التابع <code>[[Ruby/Time/local|local]]</code>: ينشئ توقيتًا جديدًا بشكل مشابه للتابع <code>gm</code> باستثناء أنَّه يفسر القيم في إطار المنطقة الزمنية المحلية. |
==مصادر== | ==مصادر== | ||
| − | *[http://ruby-doc.org/core-2.5.1/Time.html#method-c-gm قسم | + | *[http://ruby-doc.org/core-2.5.1/Time.html#method-c-gm قسم التابع gm في الصنف Time في توثيق روبي الرسمي.] |
المراجعة الحالية بتاريخ 12:04، 6 ديسمبر 2018
ينشئ التابع gm توقيتا جديدًا استنادًا إلى القيم المعطاة، ويتم تفسيرها وفق التوقيت العالمي الموحد UTC (GMT).
يجب تحديد السنة عند استعمال هذا التابع. أما القيم الأخرى، فتساوي افتراضيًّا الحد الأدنى لقيمها (وقد تكون nil، أو قد تُحذف).
سيُطلق الاستثناء ArgumentError إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر وسائط لأجل استخدامها في مخرجات التابع to_a.
البنية العامة
gm(year) → time
gm(year, month) → time
gm(year, month, day) → time
gm(year, month, day, hour) → time
gm(year, month, day, hour, min) → time
gm(year, month, day, hour, min, sec_with_frac) → time
gm(year, month, day, hour, min, sec, usec_with_frac) → time
gm(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
قيمة فارغة معدومة.
القيمة المعادة
يعاد توقيتٌ جديدٌ استنادًا إلى القيم الوقت المعطاة والمعاملات المُمرَّرة.
أمثلة
مثال على استخدام التابع gm:
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: ينشئ توقيتا جديدًا انطلاقًا من معلومات الوقت المٌمرَّرة إليه. - التابع
local: ينشئ توقيتًا جديدًا بشكل مشابه للتابعgmباستثناء أنَّه يفسر القيم في إطار المنطقة الزمنية المحلية.