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

من موسوعة حسوب
→ التعديل السابقالتعديل اللاحق ←
مرئينص الويكي
لا ملخص تعديل
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: صفحة الصنف <code>Time</code> في روبي}}</noinclude>
<noinclude>{{DISPLAYTITLE: الصنف <code>Time</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Class]]
[[تصنيف: Ruby Time]]
[[تصنيف: Ruby Time]]
الصنف <code>Time</code> هو تجريد لمفهومي التاريخ والوقت. يتم تخزين <code>Time</code> داخليا كعدد الثواني (مع كسورها) منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس] (1 يناير 1970 00:00 بالتوقيت العالمي). انظر أيضا الوحدة <code>[[Ruby/Date|Date]]</code> لمزيد من المعلومات.
الصنف <code>Time</code> هو تجريد لمفهومي التاريخ والوقت. يتم تخزين <code>Time</code> داخليا كعدد الثواني (مع كسورها) منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 توقيت يونيكس] (1 يناير 1970 00:00 بالتوقيت العالمي). انظر أيضًا الوحدة <code>[[Ruby/Date|Date]]</code> لمزيد من المعلومات.


يعامِل الصنف<code>Time</code> توقيت جرينتش (GMT)  و التوقيت العالمي الموحد (UTC) على أنهما متكافئان. توقيت جرينتش هو الطريقة الأقدم للإشارة إلى هذه الأوقات المرجعية، ولا تزال موجودة في أسماء الاستدعاءات على أنظمة POSIX.
يعامِل الصنف <code>Time</code> توقيت جرينتش (GMT، اختصار للعبارة Greenwich Mean Time)  والتوقيت العالمي الموحد (UTC، اختصار للعبارة Universal Time Coordinated) على أنهما متكافئان. توقيت جرينتش هو الطريقة الأقدم للإشارة إلى هذه الأوقات المرجعية، ولا تزال موجودة في أسماء الاستدعاءات على أنظمة POSIX.


يمكن أن يكون لجميع الأوقات كسور. انتبه لهذا الأمر عند مقارنة الأوقات مع بعضها البعض - فالأوقات التي تبدو متساوية عند عرضها، قد تكون مختلفة عند المقارنة.
يمكن أن يكون لجميع الأوقات كسور. انتبه لهذا الأمر عند مقارنة الأوقات مع بعضها البعض؛ فالأوقات التي تبدو متساوية عند عرضها، قد تكون مختلفة عند المقارنة.


منذ روبي 1.9.2، يستخدم <code>Time</code> عددا صحيحا من النوع signed 63 bit أو <code>Bignum</code> أو <code>[[Ruby/Rational|Rational]]</code>. العدد الصحيح يمثل عدد النانوثواني منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس]، والتي يمكن أن تمثل 1823-11-12 كـ 2116-02-20. عند استخدام <code>Bignum</code> أو <code>[[Ruby/Rational|Rational]]</code> (قبل 1823، وبعد 2116، بالنانوثانية) ، يعمل الصنف <code>Time</code> بشكل أبطأ مقارنة بالوضع عند استخدام الأعداد الصحيحة.
منذ روبي 1.9.2، يستخدم الصنف <code>Time</code> عددًا صحيحًا ذا إشارة بحجم 63 بت أو عددًا من النوع <code>Bignum</code> أو <code>[[Ruby/Rational|Rational]]</code>. العدد الصحيح يمثل عدد النانوثواني منذ بدء [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 توقيت يونيكس]، والتي يمكن أن تمثل ‎1823-11-12 بالقيمة ‎2116-02-20. عند استخدام <code>Bignum</code> أو <code>[[Ruby/Rational|Rational]]</code> (قبل 1823، وبعد 2116، بالنانوثانية) ، يعمل الصنف <code>Time</code> بشكل أبطأ مقارنة باستخدام الأعداد الصحيحة.


== الأمثلة ==
== الأمثلة ==
كل الأمثلة الموجودة في صفحات التوابع تعمل باستخدام المنطقة الزمنية EST بتوقيت جرينتش -5.
كل الأمثلة الموجودة في صفحات التوابع تعمل باستخدام المنطقة الزمنية EST (التوقيت الشرقي القياسي [Eastern Standard Time]) والتي تساوي GMT-5 بتوقيت غرينتش.


== إنشاء توقيت جديد ==
== إنشاء توقيت جديد ==
يمكنك إنشاء توقيت جديد (نسخة من <code>Time</code>) عبر التابع <code>[[Ruby/Time/new|new]]</code>. حيث سيستخدم الوقت الحالي في النظام. <code>[[Ruby/Time/now|now]]</code> هو مرادف للمتغير <code>this</code>. يمكنك أيضًا تمرير أجزاء من الوقت إلى <code>[[Ruby/Time/new|new]]</code>، مثل السنة والشهر والدقيقة وما إلى ذلك. عندما تريد إنشاء توقيت بهذا التابع، فيجب أن تمرر السنة على الأقل. إذا مررت السنة وحدها، فسيتم تعيين الوقت الافتراضي لبقية القيم عند فاتح يناير/كانون الثاني من ذلك العام على الساعة 00:00:00 بتوقيت المنطقة الزمنية الحالية للنظام.
يمكنك إنشاء توقيت جديد (نسخة من الصنف <code>Time</code>) عبر التابع <code>[[Ruby/Time/new|new]]</code>، إذ سيستخدم الوقت الحالي في النظام. التابع <code>[[Ruby/Time/now|now]]</code> هو اسم بديل للمتغير <code>this</code>. يمكنك أيضًا تمرير أجزاء من الوقت إلى <code>[[Ruby/Time/new|new]]</code>، مثل السنة والشهر والدقيقة وما إلى ذلك. عندما تريد إنشاء توقيت بهذا التابع، فيجب أن تمرر السنة على الأقل. إذا مررت السنة وحدها، فسيتم تعيين الوقت الافتراضي لبقية القيم عند الشهر يناير/كانون الثاني من بداية ذلك العام على الساعة 00:00:00 بتوقيت المنطقة الزمنية الحالية للنظام.


إليك بعض الأمثلة:<syntaxhighlight lang="ruby">Time.new(2002)        #=> 2002-01-01 00:00:00 -0500
إليك بعض الأمثلة:<syntaxhighlight lang="ruby">Time.new(2002)        #=> 2002-01-01 00:00:00 -0500
Time.new(2002, 10)    #=> 2002-10-01 00:00:00 -0500
Time.new(2002, 10)    #=> 2002-10-01 00:00:00 -0500
Time.new(2002, 10, 31) #=> 2002-10-31 00:00:00 -0500
Time.new(2002, 10, 31) #=> 2002-10-31 00:00:00 -0500
Time.new(2002, 10, 31, 2, 2, 2, "+02:00") #=> 2002-10-31 02:02:02 +0200‎</syntaxhighlight>يمكنك أيضًا استخدام التوابع <code>[[Ruby/Time/gm|gm]]</code> و <code>[[Ruby/Time/local|local]]</code> و <code>[[Ruby/Time/utc|utc]]</code> لاعتماد المناطق الزمنية لغرينتش أو التوقيت المحلي أو التوقيت العالمي بدلاً من استخدام إعدادات النظام الحالي.
Time.new(2002, 10, 31, 2, 2, 2, "+02:00") #=> 2002-10-31 02:02:02 +0200‎</syntaxhighlight>يمكنك أيضًا استخدام التوابع <code>[[Ruby/Time/gm|gm]]</code> و <code>[[Ruby/Time/local|local]]</code> و <code>[[Ruby/Time/utc|utc]]</code> لاعتماد المناطق الزمنية لغرينتش أو التوقيت المحلي أو التوقيت العالمي بدلًا من استخدام إعدادات النظام الحالي.


يمكنك أيضًا إنشاء توقيت جديد باستخدام <code>[[Ruby/Time/at|at]]</code>، والذي يأخذ عدد الثواني (أو أعشار الثواني) منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].<syntaxhighlight lang="ruby">Time.at(628232400) #=> 1989-11-28 00:00:00 -0500‎</syntaxhighlight>
يمكنك أيضًا إنشاء توقيت جديد باستخدام <code>[[Ruby/Time/at|at]]</code>، والذي يأخذ عدد الثواني (أو أعشار الثواني) منذ بدء [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 توقيت يونيكس].<syntaxhighlight lang="ruby">Time.at(628232400) #=> 1989-11-28 00:00:00 -0500‎</syntaxhighlight>


== العمل مع التوقيتات ==
== العمل مع التوقيتات ==
بمجرد أن تُنشئ توقيتًا (نسخة من <code>Time</code>)، فهناك العديد من الأشياء التي يمكنك القيام بها. فيما يلي بعض الأمثلة.
بمجرد أن تُنشئ توقيتًا (نسخة من الصنف <code>Time</code>)، فهناك العديد من الأشياء التي يمكنك القيام بها. فيما يلي بعض الأمثلة.


في جميع الأمثلة التالية، سنفترض أنك قمت بما يلي:<syntaxhighlight lang="ruby">t = Time.new(1993, 02, 24, 12, 0, 0, "+09:00")‎</syntaxhighlight>هل <code>t</code> يتوافق مع يوم الاثنين؟<syntaxhighlight lang="ruby">t.monday? #=> false‎</syntaxhighlight>أي عام هو هذا؟<syntaxhighlight lang="ruby">t.year #=> 1993‎</syntaxhighlight>هل <code>t</code> توقيت صيفي؟<syntaxhighlight lang="ruby">t.dst? #=> false‎</syntaxhighlight>ما هو اليوم الذي يوافق عاما بعد  <code>t</code>؟<syntaxhighlight lang="ruby">t + (60*60*24*365) #=> 1994-02-24 12:00:00 +0900‎</syntaxhighlight>كم عدد الثواني منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس] وحتى <code>t</code>؟<syntaxhighlight lang="ruby">t.to_i #=> 730522800‎</syntaxhighlight>يمكنك أيضا القيام بالعمليات والوظائف العادية، مثل مقارنة توقيتين.<syntaxhighlight lang="ruby">t1 = Time.new(2010)
في جميع الأمثلة التالية، سنفترض أنك قمت بما يلي:<syntaxhighlight lang="ruby">t = Time.new(1993, 02, 24, 12, 0, 0, "+09:00")‎</syntaxhighlight>هل <code>t</code> يتوافق مع يوم الاثنين؟<syntaxhighlight lang="ruby">t.monday? #=> false‎</syntaxhighlight>أي عام هو هذا؟<syntaxhighlight lang="ruby">t.year #=> 1993‎</syntaxhighlight>هل <code>t</code> توقيت صيفي؟<syntaxhighlight lang="ruby">t.dst? #=> false‎</syntaxhighlight>ما هو اليوم الذي يوافق عامًا بعد  <code>t</code>؟<syntaxhighlight lang="ruby">t + (60*60*24*365) #=> 1994-02-24 12:00:00 +0900‎</syntaxhighlight>كم عدد الثواني منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 توقيت يونيكس] وحتى <code>t</code>؟<syntaxhighlight lang="ruby">t.to_i #=> 730522800‎</syntaxhighlight>يمكنك أيضًا القيام بالعمليات والوظائف العادية، مثل مقارنة توقيتين:<syntaxhighlight lang="ruby">t1 = Time.new(2010)
t2 = Time.new(2011)
t2 = Time.new(2011)
t1 == t2 #=> false
t1 == t2 #=> false
سطر 33: سطر 34:
t1 >  t2 #=> false
t1 >  t2 #=> false
Time.new(2010,10,31).between?(t1, t2) #=> true‎</syntaxhighlight>
Time.new(2010,10,31).between?(t1, t2) #=> true‎</syntaxhighlight>
==توابع الصنف العامة (Public Class Methods)==
==توابع الصنف العامة==
===[[Ruby/Time/at| التابع at]]===
===[[Ruby/Time/at|<code>at</code>]]===
ينشئ التابع <code>at</code> [[Ruby/Time|توقيت]]ا جديدًا.
ينشئ توقيتًا جديدًا انطلاقًا من معلومات الوقت المٌمرَّرة إليه.
===[[Ruby/Time/gm| التابع gm]]===
===[[Ruby/Time/gm|<code>gm</code>]]===
ينشئ التابع <code>gm</code> [[Ruby/Time|توقيت]]ا استنادًا إلى القيم المعطاة،
ينشئ توقيتًا جديدًا استنادًا إلى القيم المعطاة، ويتم تفسيرها وفق التوقيت العالمي الموحد UTC ‏(GMT).
===[[Ruby/Time/local| التابع local]]===
===[[Ruby/Time/local|<code>local</code>]]===
التابع <code>local</code> مشابه لـ <code>[[Ruby/Time/gm|gm]]</code>، ولكنه يفسر القيم في إطار المنطقة الزمنية المحلية.
ينشئ توقيتًا جديدًا بشكل مشابه للتابع <code>[[Ruby/Time/gm|gm]]</code> باستثناء أنَّه يفسر القيم في إطار المنطقة الزمنية المحلية.
===[[Ruby/Time/mktime| التابع mktime]]===
===[[Ruby/Time/mktime|<code>mktime</code>]]===
التابع <code>mktime</code> مشابه لـ <code>[[Ruby/Time/gm|gm]]</code>، ولكنه يفسر القيم في إطار المنطقة الزمنية المحلية.
ينشئ توقيتًا جديدًا بشكل مشابه للتابع <code>[[Ruby/Time/gm|gm]]</code> باستثناء أنَّه يفسر القيم في إطار المنطقة الزمنية المحلية.
===[[Ruby/Time/new| التابع new]]===
===[[Ruby/Time/new|<code>new</code>]]===
يعيد التابع <code>new</code> [[Ruby/Time|توقيت]]ا جديدا.
ينشئ توقيتًا جديدًا. يتم ضبطه عند وقت النظام الحالي إذا لم يُمرر أي وسيط.
===[[Ruby/Time/now| التابع now]]===
===[[Ruby/Time/now|<code>now</code>]]===
يُنشئ التابع <code>now</code> [[Ruby/Time|توقيت]]ا جديدا للوقت الحالي.
يُنشئ توقيتًا جديدًا من الوقت الحالي
===[[Ruby/Time/utc| التابع utc]]===
===[[Ruby/Time/utc|<code>utc</code>]]===
ينشئ التابع <code>utc</code> [[Ruby/Time|توقيت]]ا استنادًا إلى القيم المعطاة،  
ينشئ توقيتًا جديدًا استنادًا إلى القيم المعطاة، ويتم تفسيره وفق التوقيت العالمي الموحد UTC‏ (GMT).


== توابع النسخة العامة (Public Instance Methods) ==
== توابع النسخة العامة ==


===[[Ruby/Time/plus operator| التابع +]]===
===[[Ruby/Time/plus operator|<code>+</code>]]===
معامل الإضافة - يضيف بعض الثواني (ربما كسرية) إلى [[Ruby/Time|التوقيت]]
يضيف عددًا من الثواني (ربما يكون عدد كسري) إلى <nowiki/>[[Ruby/Time|التوقيت]] المعطى، ثم يُعيد تلك القيمة<nowiki/>[[Ruby/Time|كتوقيت]] جديد.
===[[Ruby/Time/minus operator| التابع -]]===
===[[Ruby/Time/minus operator|<code>-</code>]]===
معامل الفرق - يُعيد فرق الثواني على شكل عدد عشري <code>[[Ruby/Float|Float]]</code>
يُعيد الفرق بالثانية بين وقتين، أو يطرح عددًا يمثِّل الثواني من التوقيت المعطى.
===[[Ruby/Time/compar operator| التابع <=>]]===
===[[Ruby/Time/compar operator|<code><=></code>]]===
معامل الموازنة - يقارن توقيتين  
يوازن بين توقيتين.
===[[Ruby/Time/asctime| التابع asctime]]===
===[[Ruby/Time/asctime|<code>asctime</code>]]===
يُعيد التابع <code>asctime</code> تمثيلا نصيا قانونيا لل[[Ruby/Time|توقيت]].
يُعيد<code>asctime</code> تمثيلا نصيا قانونيا لل[[Ruby/Time|توقيت]].
===[[Ruby/Time/ctime| التابع ctime]]===
===[[Ruby/Time/ctime|<code>ctime</code>]]===
يُعيد التابع <code>ctime</code> تمثيلا نصيا قانونيا لل[[Ruby/Time|توقيت]].
يُعيد<code>ctime</code> تمثيلا نصيا قانونيا لل[[Ruby/Time|توقيت]].
===[[Ruby/Time/day| التابع day]]===
===[[Ruby/Time/day|<code>day</code>]]===
يستخلص التابع <code>day</code>  رقم اليوم من الشهر.
يستخلص<code>day</code>  رقم اليوم من الشهر.
===[[Ruby/Time/dst-3F| التابع dst?‎]]===
===[[Ruby/Time/dst-3F|<code>dst?‎</code>]]===
يُعيد التابع <code>dst?‎</code> القيمة <code>true</code> إن وقع <code>time</code> أثناء التوقيت الصيفي
يُعيد<code>dst?‎</code> القيمة <code>true</code> إن وقع <code>time</code> أثناء التوقيت الصيفي
===[[Ruby/Time/eql-3F| التابع eql?‎]]===
===[[Ruby/Time/eql-3F|<code>eql?‎</code>]]===
يتحقق من تساوي توقيتين.
يتحقق من تساوي توقيتين.
===[[Ruby/Time/friday-3F| التابع friday?‎]]===
===[[Ruby/Time/friday-3F|<code>friday?‎</code>]]===
يُعيد التابع <code>friday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]] يمثل يوم الجمعة.
يُعيد<code>friday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]] يمثل يوم الجمعة.
===[[Ruby/Time/getgm| التابع getgm]]===
===[[Ruby/Time/getgm|<code>getgm</code>]]===
يُعيد التابع <code>getgm</code> [[Ruby/Time|توقيت]]ا <code>[[Ruby/Time|Time]]</code> جديدا يمثل [[Ruby/Time|التوقيت]] الذي استُدعي معه  بالتوقيت العالمي الموحد (UTC).
يُعيد<code>getgm</code> [[Ruby/Time|توقيت]]ا <code>[[Ruby/Time|Time]]</code> جديدا يمثل [[Ruby/Time|التوقيت]] الذي استُدعي معه  بالتوقيت العالمي الموحد (UTC).
===[[Ruby/Time/getlocal| التابع getlocal]]===
===[[Ruby/Time/getlocal|<code>getlocal</code>]]===
يُعيد التابع <code>getlocal</code> [[Ruby/Time|توقيت]]ا  جديدا يمثل [[Ruby/Time|التوقيت]] الذي استُدعي معه  بالتوقيت المحلي  
يُعيد<code>getlocal</code> [[Ruby/Time|توقيت]]ا  جديدا يمثل [[Ruby/Time|التوقيت]] الذي استُدعي معه  بالتوقيت المحلي  
===[[Ruby/Time/getutc| التابع getutc]]===
===[[Ruby/Time/getutc|<code>getutc</code>]]===
يُعيد التابع <code>getutc</code> [[Ruby/Time|توقيت]]ا  جديدا يمثل [[Ruby/Time|التوقيت]] الذي استُدعي معه  بالتوقيت العالمي الموحد (UTC).
يُعيد<code>getutc</code> [[Ruby/Time|توقيت]]ا  جديدا يمثل [[Ruby/Time|التوقيت]] الذي استُدعي معه  بالتوقيت العالمي الموحد (UTC).
===[[Ruby/Time/gmt-3F| التابع gmt?‎]]===
===[[Ruby/Time/gmt-3F|<code>gmt?‎</code>]]===
يُعيد التابع <code>gmt?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]] ضمن نطاق التوقيت العالمي الموحد (UTC).
يُعيد<code>gmt?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]] ضمن نطاق التوقيت العالمي الموحد (UTC).
===[[Ruby/Time/gmt offset| التابع gmt_offset]]===
===[[Ruby/Time/gmt offset|<code>gmt_offset</code>]]===
يُعيد التابع <code>gmt_offset</code> فرق الثواني بين المنطقة الزمنية لل[[Ruby/Time|توقيت]] والتوقيت العالمي الموحد UTC.
يُعيد<code>gmt_offset</code> فرق الثواني بين المنطقة الزمنية لل[[Ruby/Time|توقيت]] والتوقيت العالمي الموحد UTC.
===[[Ruby/Time/gmtime| التابع gmtime]]===
===[[Ruby/Time/gmtime|<code>gmtime</code>]]===
يحول التابع <code>gmtime</code> [[Ruby/Time|التوقيت]]  إلى التوقيت العالمي الموحد
يحول<code>gmtime</code> [[Ruby/Time|التوقيت]]  إلى التوقيت العالمي الموحد
===[[Ruby/Time/gmtoff| التابع gmtoff]]===
===[[Ruby/Time/gmtoff|<code>gmtoff</code>]]===
يُعيد التابع <code>gmtoff</code> فرق الثواني بين المنطقة الزمنية لل[[Ruby/Time|توقيت]]  و التوقيت العالمي الموحد (UTC).
يُعيد<code>gmtoff</code> فرق الثواني بين المنطقة الزمنية لل[[Ruby/Time|توقيت]]  و التوقيت العالمي الموحد (UTC).
===[[Ruby/Time/hash| التابع hash]]===
===[[Ruby/Time/hash|<code>hash</code>]]===
يُعيدرمز تجزئة (hash code) لل[[Ruby/Time|توقيت]].
يُعيدرمز تجزئة (hash code) لل[[Ruby/Time|توقيت]].
===[[Ruby/Time/hour| التابع hour]]===
===[[Ruby/Time/hour|<code>hour</code>]]===
يُستخلص التابع <code>hour</code> من [[Ruby/Time|التوقيت]] رقم الساعة من اليوم
يُستخلص<code>hour</code> من [[Ruby/Time|التوقيت]] رقم الساعة من اليوم
===[[Ruby/Time/inspect| التابع inspect]]===
===[[Ruby/Time/inspect|<code>inspect</code>]]===
يُعيد التابع <code>inspect</code> [[Ruby/String|سلسلة نصية]] تمثل [[Ruby/Time|التوقيت]].
يُعيد<code>inspect</code> [[Ruby/String|سلسلة نصية]] تمثل [[Ruby/Time|التوقيت]].
===[[Ruby/Time/isdst| التابع isdst]]===
===[[Ruby/Time/isdst|<code>isdst</code>]]===
يُعيد التابع <code>isdst</code> القيمة <code>true</code> إن وقع [[Ruby/Time|التوقيت]]  أثناء التوقيت الصيفي
يُعيد<code>isdst</code> القيمة <code>true</code> إن وقع [[Ruby/Time|التوقيت]]  أثناء التوقيت الصيفي
===[[Ruby/Time/localtime| التابع localtime]]===
===[[Ruby/Time/localtime|<code>localtime</code>]]===
يحول التابع <code>localtime</code> [[Ruby/Time|التوقيت]]  إلى التوقيت المحلي
يحول<code>localtime</code> [[Ruby/Time|التوقيت]]  إلى التوقيت المحلي
===[[Ruby/Time/mday| التابع mday]]===
===[[Ruby/Time/mday|<code>mday</code>]]===
يستخلص التابع <code>mday</code> من [[Ruby/Time|التوقيت]] رقم اليوم من الشهر
يستخلص<code>mday</code> من [[Ruby/Time|التوقيت]] رقم اليوم من الشهر
===[[Ruby/Time/min| التابع min]]===
===[[Ruby/Time/min|<code>min</code>]]===
يستخلص التابع <code>min</code> من [[Ruby/Time|التوقيت]] رقم الدقيقة من الساعة
يستخلص<code>min</code> من [[Ruby/Time|التوقيت]] رقم الدقيقة من الساعة
===[[Ruby/Time/mon| التابع mon]]===
===[[Ruby/Time/mon|<code>mon</code>]]===
يستخلص التابع <code>mon</code> من [[Ruby/Time|التوقيت]] رقم الشهر من السنة
يستخلص<code>mon</code> من [[Ruby/Time|التوقيت]] رقم الشهر من السنة
===[[Ruby/Time/monday-3F| التابع monday?‎]]===
===[[Ruby/Time/monday-3F|<code>monday?‎</code>]]===
يُعيد التابع <code>monday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]] <code>time</code> يمثل يوم الاثنين.
يُعيد<code>monday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]] <code>time</code> يمثل يوم الاثنين.
===[[Ruby/Time/month| التابع month]]===
===[[Ruby/Time/month|<code>month</code>]]===
يستخلص التابع <code>month</code> من [[Ruby/Time|التوقيت]] رقم الشهر من السنة
يستخلص<code>month</code> من [[Ruby/Time|التوقيت]] رقم الشهر من السنة
===[[Ruby/Time/nsec| التابع nsec]]===
===[[Ruby/Time/nsec|<code>nsec</code>]]===
يُعيد التابع <code>nsec</code> عدد النانوثواني المقابل لل[[Ruby/Time|توقيت]].
يُعيد<code>nsec</code> عدد النانوثواني المقابل لل[[Ruby/Time|توقيت]].
===[[Ruby/Time/round| التابع round]]===
===[[Ruby/Time/round|<code>round</code>]]===
يُقرّب التابع <code>round</code> الثواني الكسرية وفق دقة معينة.
يُقرّب<code>round</code> الثواني الكسرية وفق دقة معينة.
===[[Ruby/Time/saturday-3F| التابع saturday?‎]]===
===[[Ruby/Time/saturday-3F|<code>saturday?‎</code>]]===
يُعيد التابع <code>saturday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]]  يمثل يوم السبت.
يُعيد<code>saturday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]]  يمثل يوم السبت.
===[[Ruby/Time/sec| التابع sec]]===
===[[Ruby/Time/sec|<code>sec</code>]]===
يستخلص التابع <code>sec</code> من [[Ruby/Time|التوقيت]] رقم الثانية في الدقيقة
يستخلص<code>sec</code> من [[Ruby/Time|التوقيت]] رقم الثانية في الدقيقة
===[[Ruby/Time/strftime| التابع strftime]]===
===[[Ruby/Time/strftime|<code>strftime</code>]]===
يُنسق التابع <code>strftime</code> [[Ruby/Time|التوقيت]]  وفقًا للموجّهات (directives) الموجودة في سلسلة التنسيق المعطاة.
يُنسق<code>strftime</code> [[Ruby/Time|التوقيت]]  وفقًا للموجّهات (directives) الموجودة في سلسلة التنسيق المعطاة.
===[[Ruby/Time/subsec| التابع subsec]]===
===[[Ruby/Time/subsec|<code>subsec</code>]]===
يُعيد التابع <code>subsec</code> الجزء العشري من [[Ruby/Time|التوقيت]].
يُعيد<code>subsec</code> الجزء العشري من [[Ruby/Time|التوقيت]].
===[[Ruby/Time/succ| التابع succ]]===
===[[Ruby/Time/succ|<code>succ</code>]]===
يُعيد التابع <code>succ</code> [[Ruby/Time|توقيت]]ا  جديدًا، مع إضافة ثانية واحدة على [[Ruby/Time|التوقيت]] الذي استُدعي معه  
يُعيد<code>succ</code> [[Ruby/Time|توقيت]]ا  جديدًا، مع إضافة ثانية واحدة على [[Ruby/Time|التوقيت]] الذي استُدعي معه  
===[[Ruby/Time/sunday-3F| التابع sunday?‎]]===
===[[Ruby/Time/sunday-3F|<code>sunday?‎</code>]]===
يُعيد التابع <code>sunday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]]  يمثل يوم الأحد.
يُعيد<code>sunday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]]  يمثل يوم الأحد.
===[[Ruby/Time/thursday-3F| التابع thursday?‎]]===
===[[Ruby/Time/thursday-3F|<code>thursday?‎</code>]]===
يُعيد التابع <code>thursday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]]  يمثل يوم الخميس.
يُعيد<code>thursday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]]  يمثل يوم الخميس.
===[[Ruby/Time/to a| التابع to_a]]===
===[[Ruby/Time/to a|<code>to_a</code>]]===
يُعيد التابع <code>to_a</code> [[Ruby/Array|مصفوفة]] عشارية تضم قيم [[Ruby/Time|التوقيت]]
يُعيد<code>to_a</code> [[Ruby/Array|مصفوفة]] عشارية تضم قيم [[Ruby/Time|التوقيت]]
===[[Ruby/Time/to f| التابع to_f]]===
===[[Ruby/Time/to f|<code>to_f</code>]]===
يُعيد التابع <code>to_f</code> قيمة <nowiki/>[[Ruby/Time|التوقيت]] كعدد عشري يمثل عدد الثواني التي مرت منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].
يُعيد<code>to_f</code> قيمة <nowiki/>[[Ruby/Time|التوقيت]] كعدد عشري يمثل عدد الثواني التي مرت منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].
===[[Ruby/Time/to i| التابع to_i]]===
===[[Ruby/Time/to i|<code>to_i</code>]]===
يُعيد التابع <code>to_i</code> قيمة <nowiki/>[[Ruby/Time|التوقيت]] كعدد صحيح يمثل عدد الثواني التي مرت منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].
يُعيد<code>to_i</code> قيمة <nowiki/>[[Ruby/Time|التوقيت]] كعدد صحيح يمثل عدد الثواني التي مرت منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].
===[[Ruby/Time/to r| التابع to_r]]===
===[[Ruby/Time/to r|<code>to_r</code>]]===
يُعيد التابع <code>to_r</code> قيمة <nowiki/>[[Ruby/Time|التوقيت]] <nowiki/>[[Ruby/Rational|كعدد جذري]] يمثل عدد الثواني التي مرت منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].
يُعيد<code>to_r</code> قيمة <nowiki/>[[Ruby/Time|التوقيت]] <nowiki/>[[Ruby/Rational|كعدد جذري]] يمثل عدد الثواني التي مرت منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].
===[[Ruby/Time/to s| التابع to_s]]===
===[[Ruby/Time/to s|<code>to_s</code>]]===
يُعيد التابع <code>to_s</code> [[Ruby/String|سلسلة نصية]] تمثل [[Ruby/Time|التوقيت]]
يُعيد<code>to_s</code> [[Ruby/String|سلسلة نصية]] تمثل [[Ruby/Time|التوقيت]]
===[[Ruby/Time/tuesday-3F| التابع tuesday?‎]]===
===[[Ruby/Time/tuesday-3F|<code>tuesday?‎</code>]]===
يُعيد التابع <code>tuesday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]] يمثل يوم الثلاثاء.
يُعيد<code>tuesday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]] يمثل يوم الثلاثاء.
===[[Ruby/Time/tv nsec| التابع tv_nsec]]===
===[[Ruby/Time/tv nsec|<code>tv_nsec</code>]]===
يُعيد التابع <code>tv_nsec</code> عدد النانوثواني المقابلة <nowiki/>[[Ruby/Time|للتوقيت]] التي مرت منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].
يُعيد<code>tv_nsec</code> عدد النانوثواني المقابلة <nowiki/>[[Ruby/Time|للتوقيت]] التي مرت منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].
===[[Ruby/Time/tv sec| التابع tv_sec]]===
===[[Ruby/Time/tv sec|<code>tv_sec</code>]]===
يُعيد التابع <code>tv_sec</code> القيمة المقابلة <nowiki/>[[Ruby/Time|للتوقيت]] التي تمثل عدد الثواني التي مرت منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].
يُعيد<code>tv_sec</code> القيمة المقابلة <nowiki/>[[Ruby/Time|للتوقيت]] التي تمثل عدد الثواني التي مرت منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].
===[[Ruby/Time/tv usec| التابع tv_usec]]===
===[[Ruby/Time/tv usec|<code>tv_usec</code>]]===
يُعيد التابع <code>tv_usec</code> المقابلة <nowiki/>[[Ruby/Time|للتوقيت]] التي تمثل عدد الميكروثواني التي مرت منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].
يُعيد<code>tv_usec</code> المقابلة <nowiki/>[[Ruby/Time|للتوقيت]] التي تمثل عدد الميكروثواني التي مرت منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].
===[[Ruby/Time/usec| التابع usec]]===
===[[Ruby/Time/usec|<code>usec</code>]]===
يُعيد التابع <code>usec</code> القيمة المقابلة <nowiki/>[[Ruby/Time|للتوقيت]] التي تمثل عدد الميكروثواني التي مرت منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].
يُعيد<code>usec</code> القيمة المقابلة <nowiki/>[[Ruby/Time|للتوقيت]] التي تمثل عدد الميكروثواني التي مرت منذ [https://ar.wikipedia.org/wiki/%D8%AA%D9%88%D9%82%D9%8A%D8%AA_%D9%8A%D9%88%D9%86%D9%83%D8%B3 حقبة يونيكس].
===[[Ruby/Time/utc| التابع utc]]===
===[[Ruby/Time/utc|<code>utc</code>]]===
ينشئ التابع <code>utc</code> <nowiki/>[[Ruby/Time|توقيتا]] جديدا استنادًا إلى القيم المعطاة، ويتم تفسيره وفق التوقيت العالمي الموحد UTC‏ (GMT).
ينشئ<code>utc</code> <nowiki/>[[Ruby/Time|توقيتا]] جديدا استنادًا إلى القيم المعطاة، ويتم تفسيره وفق التوقيت العالمي الموحد UTC‏ (GMT).
===[[Ruby/Time/utc-3F| التابع utc?‎]]===
===[[Ruby/Time/utc-3F|<code>utc?‎</code>]]===
يُعيد التابع <code>utc?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]]  ضمن نطاق  التوقيت العالمي الموحد
يُعيد<code>utc?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]]  ضمن نطاق  التوقيت العالمي الموحد
===[[Ruby/Time/utc offset| التابع utc_offset]]===
===[[Ruby/Time/utc offset|<code>utc_offset</code>]]===
يُعيد التابع <code>utc_offset</code> فرق الثواني بين المنطقة الزمنية لل[[Ruby/Time|توقيت]]  والتوقيت العالمي الموحد UTC.
يُعيد<code>utc_offset</code> فرق الثواني بين المنطقة الزمنية لل[[Ruby/Time|توقيت]]  والتوقيت العالمي الموحد UTC.
===[[Ruby/Time/wday| التابع wday]]===
===[[Ruby/Time/wday|<code>wday</code>]]===
يُعيد التابع <code>wday</code> عددا صحيحا يمثل رقم اليوم في الأسبوع  
يُعيد<code>wday</code> عددا صحيحا يمثل رقم اليوم في الأسبوع  
===[[Ruby/Time/wednesday-3F| التابع wednesday?‎]]===
===[[Ruby/Time/wednesday-3F|<code>wednesday?‎</code>]]===
يُعيد التابع <code>wednesday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]]  يمثل يوم الأربعاء.
يُعيد<code>wednesday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]]  يمثل يوم الأربعاء.
===[[Ruby/Time/yday| التابع yday]]===
===[[Ruby/Time/yday|<code>yday</code>]]===
يُعيد التابع <code>yday</code> عددا صحيحا يمثل رقم اليوم في  السنة ، 1..366.
يُعيد<code>yday</code> عددا صحيحا يمثل رقم اليوم في  السنة ، 1..366.
===[[Ruby/Time/year| التابع year]]===
===[[Ruby/Time/year|<code>year</code>]]===
يستخلص التابع <code>year</code> من [[Ruby/Time|التوقيت]] الذي استُدعي معه قيمة السنة (بما في ذلك القرن).
يستخلص<code>year</code> من [[Ruby/Time|التوقيت]] الذي استُدعي معه قيمة السنة (بما في ذلك القرن).
===[[Ruby/Time/zone| التابع zone]]===
===[[Ruby/Time/zone|<code>zone</code>]]===
يعيد التابع <code>zone</code> اسم المنطقة الزمنية المستخدمة في [[Ruby/Time|التوقيت]].
يعيد<code>zone</code> اسم المنطقة الزمنية المستخدمة في [[Ruby/Time|التوقيت]].
==مصادر==
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Time.html قسم  الصنف Time في توثيق روبي الرسمي.]
*[http://ruby-doc.org/core-2.5.1/Time.html صفحة الصنف Time في توثيق روبي الرسمي.]

مراجعة 12:09، 6 ديسمبر 2018

الصنف Time هو تجريد لمفهومي التاريخ والوقت. يتم تخزين Time داخليا كعدد الثواني (مع كسورها) منذ توقيت يونيكس (1 يناير 1970 00:00 بالتوقيت العالمي). انظر أيضًا الوحدة Date لمزيد من المعلومات.

يعامِل الصنف Time توقيت جرينتش (GMT، اختصار للعبارة Greenwich Mean Time) والتوقيت العالمي الموحد (UTC، اختصار للعبارة Universal Time Coordinated) على أنهما متكافئان. توقيت جرينتش هو الطريقة الأقدم للإشارة إلى هذه الأوقات المرجعية، ولا تزال موجودة في أسماء الاستدعاءات على أنظمة POSIX.

يمكن أن يكون لجميع الأوقات كسور. انتبه لهذا الأمر عند مقارنة الأوقات مع بعضها البعض؛ فالأوقات التي تبدو متساوية عند عرضها، قد تكون مختلفة عند المقارنة.

منذ روبي 1.9.2، يستخدم الصنف Time عددًا صحيحًا ذا إشارة بحجم 63 بت أو عددًا من النوع Bignum أو Rational. العدد الصحيح يمثل عدد النانوثواني منذ بدء توقيت يونيكس، والتي يمكن أن تمثل ‎1823-11-12 بالقيمة ‎2116-02-20. عند استخدام Bignum أو Rational (قبل 1823، وبعد 2116، بالنانوثانية) ، يعمل الصنف Time بشكل أبطأ مقارنة باستخدام الأعداد الصحيحة.

الأمثلة

كل الأمثلة الموجودة في صفحات التوابع تعمل باستخدام المنطقة الزمنية EST (التوقيت الشرقي القياسي [Eastern Standard Time]) والتي تساوي GMT-5 بتوقيت غرينتش.

إنشاء توقيت جديد

يمكنك إنشاء توقيت جديد (نسخة من الصنف Time) عبر التابع new، إذ سيستخدم الوقت الحالي في النظام. التابع now هو اسم بديل للمتغير this. يمكنك أيضًا تمرير أجزاء من الوقت إلى new، مثل السنة والشهر والدقيقة وما إلى ذلك. عندما تريد إنشاء توقيت بهذا التابع، فيجب أن تمرر السنة على الأقل. إذا مررت السنة وحدها، فسيتم تعيين الوقت الافتراضي لبقية القيم عند الشهر يناير/كانون الثاني من بداية ذلك العام على الساعة 00:00:00 بتوقيت المنطقة الزمنية الحالية للنظام.

إليك بعض الأمثلة:

Time.new(2002)         #=> 2002-01-01 00:00:00 -0500
Time.new(2002, 10)     #=> 2002-10-01 00:00:00 -0500
Time.new(2002, 10, 31) #=> 2002-10-31 00:00:00 -0500
Time.new(2002, 10, 31, 2, 2, 2, "+02:00") #=> 2002-10-31 02:02:02 +0200‎

يمكنك أيضًا استخدام التوابع gm و local و utc لاعتماد المناطق الزمنية لغرينتش أو التوقيت المحلي أو التوقيت العالمي بدلًا من استخدام إعدادات النظام الحالي. يمكنك أيضًا إنشاء توقيت جديد باستخدام at، والذي يأخذ عدد الثواني (أو أعشار الثواني) منذ بدء توقيت يونيكس.

Time.at(628232400) #=> 1989-11-28 00:00:00 -0500‎

العمل مع التوقيتات

بمجرد أن تُنشئ توقيتًا (نسخة من الصنف Time)، فهناك العديد من الأشياء التي يمكنك القيام بها. فيما يلي بعض الأمثلة.

في جميع الأمثلة التالية، سنفترض أنك قمت بما يلي:

t = Time.new(1993, 02, 24, 12, 0, 0, "+09:00")‎

هل t يتوافق مع يوم الاثنين؟

t.monday? #=> false‎

أي عام هو هذا؟

t.year #=> 1993‎

هل t توقيت صيفي؟

t.dst? #=> false‎

ما هو اليوم الذي يوافق عامًا بعد t؟

t + (60*60*24*365) #=> 1994-02-24 12:00:00 +0900‎

كم عدد الثواني منذ توقيت يونيكس وحتى t؟

t.to_i #=> 730522800‎

يمكنك أيضًا القيام بالعمليات والوظائف العادية، مثل مقارنة توقيتين:

t1 = Time.new(2010)
t2 = Time.new(2011)
t1 == t2 #=> false
t1 == t1 #=> true
t1 <  t2 #=> true
t1 >  t2 #=> false
Time.new(2010,10,31).between?(t1, t2) #=> true‎

توابع الصنف العامة

at

ينشئ توقيتًا جديدًا انطلاقًا من معلومات الوقت المٌمرَّرة إليه.

gm

ينشئ توقيتًا جديدًا استنادًا إلى القيم المعطاة، ويتم تفسيرها وفق التوقيت العالمي الموحد UTC ‏(GMT).

local

ينشئ توقيتًا جديدًا بشكل مشابه للتابع gm باستثناء أنَّه يفسر القيم في إطار المنطقة الزمنية المحلية.

mktime

ينشئ توقيتًا جديدًا بشكل مشابه للتابع gm باستثناء أنَّه يفسر القيم في إطار المنطقة الزمنية المحلية.

new

ينشئ توقيتًا جديدًا. يتم ضبطه عند وقت النظام الحالي إذا لم يُمرر أي وسيط.

now

يُنشئ توقيتًا جديدًا من الوقت الحالي

utc

ينشئ توقيتًا جديدًا استنادًا إلى القيم المعطاة، ويتم تفسيره وفق التوقيت العالمي الموحد UTC‏ (GMT).

توابع النسخة العامة

+

يضيف عددًا من الثواني (ربما يكون عدد كسري) إلى التوقيت المعطى، ثم يُعيد تلك القيمةكتوقيت جديد.

-

يُعيد الفرق بالثانية بين وقتين، أو يطرح عددًا يمثِّل الثواني من التوقيت المعطى.

<=>

يوازن بين توقيتين.

asctime

يُعيدasctime تمثيلا نصيا قانونيا للتوقيت.

ctime

يُعيدctime تمثيلا نصيا قانونيا للتوقيت.

day

يستخلصday رقم اليوم من الشهر.

dst?‎

يُعيدdst?‎ القيمة true إن وقع time أثناء التوقيت الصيفي

eql?‎

يتحقق من تساوي توقيتين.

friday?‎

يُعيدfriday?‎ القيمة true إن كان التوقيت يمثل يوم الجمعة.

getgm

يُعيدgetgm توقيتا Time جديدا يمثل التوقيت الذي استُدعي معه بالتوقيت العالمي الموحد (UTC).

getlocal

يُعيدgetlocal توقيتا جديدا يمثل التوقيت الذي استُدعي معه بالتوقيت المحلي

getutc

يُعيدgetutc توقيتا جديدا يمثل التوقيت الذي استُدعي معه بالتوقيت العالمي الموحد (UTC).

gmt?‎

يُعيدgmt?‎ القيمة true إن كان التوقيت ضمن نطاق التوقيت العالمي الموحد (UTC).

gmt_offset

يُعيدgmt_offset فرق الثواني بين المنطقة الزمنية للتوقيت والتوقيت العالمي الموحد UTC.

gmtime

يحولgmtime التوقيت إلى التوقيت العالمي الموحد

gmtoff

يُعيدgmtoff فرق الثواني بين المنطقة الزمنية للتوقيت و التوقيت العالمي الموحد (UTC).

hash

يُعيدرمز تجزئة (hash code) للتوقيت.

hour

يُستخلصhour من التوقيت رقم الساعة من اليوم

inspect

يُعيدinspect سلسلة نصية تمثل التوقيت.

isdst

يُعيدisdst القيمة true إن وقع التوقيت أثناء التوقيت الصيفي

localtime

يحولlocaltime التوقيت إلى التوقيت المحلي

mday

يستخلصmday من التوقيت رقم اليوم من الشهر

min

يستخلصmin من التوقيت رقم الدقيقة من الساعة

mon

يستخلصmon من التوقيت رقم الشهر من السنة

monday?‎

يُعيدmonday?‎ القيمة true إن كان التوقيت time يمثل يوم الاثنين.

month

يستخلصmonth من التوقيت رقم الشهر من السنة

nsec

يُعيدnsec عدد النانوثواني المقابل للتوقيت.

round

يُقرّبround الثواني الكسرية وفق دقة معينة.

saturday?‎

يُعيدsaturday?‎ القيمة true إن كان التوقيت يمثل يوم السبت.

sec

يستخلصsec من التوقيت رقم الثانية في الدقيقة

strftime

يُنسقstrftime التوقيت وفقًا للموجّهات (directives) الموجودة في سلسلة التنسيق المعطاة.

subsec

يُعيدsubsec الجزء العشري من التوقيت.

succ

يُعيدsucc توقيتا جديدًا، مع إضافة ثانية واحدة على التوقيت الذي استُدعي معه

sunday?‎

يُعيدsunday?‎ القيمة true إن كان التوقيت يمثل يوم الأحد.

thursday?‎

يُعيدthursday?‎ القيمة true إن كان التوقيت يمثل يوم الخميس.

to_a

يُعيدto_a مصفوفة عشارية تضم قيم التوقيت

to_f

يُعيدto_f قيمة التوقيت كعدد عشري يمثل عدد الثواني التي مرت منذ حقبة يونيكس.

to_i

يُعيدto_i قيمة التوقيت كعدد صحيح يمثل عدد الثواني التي مرت منذ حقبة يونيكس.

to_r

يُعيدto_r قيمة التوقيت كعدد جذري يمثل عدد الثواني التي مرت منذ حقبة يونيكس.

to_s

يُعيدto_s سلسلة نصية تمثل التوقيت

tuesday?‎

يُعيدtuesday?‎ القيمة true إن كان التوقيت يمثل يوم الثلاثاء.

tv_nsec

يُعيدtv_nsec عدد النانوثواني المقابلة للتوقيت التي مرت منذ حقبة يونيكس.

tv_sec

يُعيدtv_sec القيمة المقابلة للتوقيت التي تمثل عدد الثواني التي مرت منذ حقبة يونيكس.

tv_usec

يُعيدtv_usec المقابلة للتوقيت التي تمثل عدد الميكروثواني التي مرت منذ حقبة يونيكس.

usec

يُعيدusec القيمة المقابلة للتوقيت التي تمثل عدد الميكروثواني التي مرت منذ حقبة يونيكس.

utc

ينشئutc توقيتا جديدا استنادًا إلى القيم المعطاة، ويتم تفسيره وفق التوقيت العالمي الموحد UTC‏ (GMT).

utc?‎

يُعيدutc?‎ القيمة true إن كان التوقيت ضمن نطاق التوقيت العالمي الموحد

utc_offset

يُعيدutc_offset فرق الثواني بين المنطقة الزمنية للتوقيت والتوقيت العالمي الموحد UTC.

wday

يُعيدwday عددا صحيحا يمثل رقم اليوم في الأسبوع

wednesday?‎

يُعيدwednesday?‎ القيمة true إن كان التوقيت يمثل يوم الأربعاء.

yday

يُعيدyday عددا صحيحا يمثل رقم اليوم في السنة ، 1..366.

year

يستخلصyear من التوقيت الذي استُدعي معه قيمة السنة (بما في ذلك القرن).

zone

يعيدzone اسم المنطقة الزمنية المستخدمة في التوقيت.

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Ruby/Time&oldid=25950»