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

المراجعة الحالية بتاريخ 12:04، 6 ديسمبر 2018

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

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

at(time) → time
at(seconds_with_frac) → time
at(seconds, microseconds_with_frac) → time
at(seconds, milliseconds, :millisecond) → time
at(seconds, microseconds, :usec) → time
at(seconds, microseconds, :microsecond) → time
at(seconds, nanoseconds, :nsec) → time
at(seconds, nanoseconds, :nanosecond) → time‎

ينشئ التابع at توقيتًا جديدًا انطلاقًا من الوقت time المعطى، أو عدد الثواني مع الأجزاء seconds_with_frac، أو عدد الثواني seconds والأجزاء microseconds_with_frac التي مرت منذ بدء توقيت يونيكس. تتيح ميزة عدم قابلية النقل (non-portable) أن يكون الموضع (offset) سالبًا في بعض الأنظمة.

إذا تم إعطاء معامل عددي، فستعاد النتيجة وفق التوقيت المحلي.

المعاملات

`time‎`

يضم معلومات عن التوقيت المراد إنشاؤه.

`seconds_with_frac‎`

عدد كسري يمثل عدد الثواني مع الأجزاء. يمكن أن يكون المعامل seconds_with_frac من النوع Integer أو Float أو Rational أو غيرها من الأصناف العددية.

`seconds‎`

عدد صحيح يمثل عدد الثواني.

`microseconds_with_frac‎`

عدد كسري يمثل أجزاء الثانية. يمكن أن يكون المعامل microseconds_with_frac من النوع Integer أو Float أو Rational أو غيرها من الأصناف العددية.

`milliseconds‎`

عدد يمثِّل الميلي ثانية.

`microseconds‎`

عدد يمثِّل قيمة الميكرو ثانية (أجزاء الثانية).

`nanoseconds‎`

عدد يمثِّل قيمة النانو ثانية (أجزاء الثانية).

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

يعاد توقيتًا جديدًا (كائن من النوع Time).

أمثلة

مثال على استخدام التابع at‎:

Time.at(0)                                #=> 1969-12-31 18:00:00 -0600
Time.at(Time.at(0))                       #=> 1969-12-31 18:00:00 -0600
Time.at(946702800)                        #=> 1999-12-31 23:00:00 -0600
Time.at(-284061600)                       #=> 1960-12-31 00:00:00 -0600
Time.at(946684800.2).usec                 #=> 200000
Time.at(946684800, 123456.789).nsec       #=> 123456789
Time.at(946684800, 123456789, :nsec).nsec  #=> 123456789‎

انظر أيضًا

التابع gm: ينشئ توقيتًا جديدًا استنادًا إلى معلومات الوقت المعطاة.

مصادر

قسم التابع at‎ في الصنف Time‎ في توثيق روبي الرسمي.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>at‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>Time.at‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Time]]
-ينشئ التابع <code>at</code> [[Ruby/Time|توقيت]]ا جديدًا <code>[[Ruby/Time|Time]]</code> مع القيم المعطاة من قِبل <code>time</code> (انظر فقرة البنية العامة)، أو عدد الثواني <code>seconds_with_frac</code>، أو عدد الثواني <code>seconds</code> والكسور <code>microseconds_with_frac</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 حقبة اليونيكس]. يمكن أن يكون الوسيطان <code>seconds_with_frac</code> و <code>microseconds_with_frac</code> من النوع <code>[[Ruby/Integer|Integer]]</code> أو <code>[[Ruby/Float|Float]]</code> أو <code>[[Ruby/Rational|Rational]]</code> أو غيرها من الأصناف العددية (<code>[[Ruby/Numeric|Numeric]]</code>). تتيح الميزة غير المحمولة أن يكون الموضع (offset) سالبًا في بعض الأنظمة.
+ينشئ التابع <code>at</code> [[Ruby/Time|توقيتً]]ا جديدًا انطلاقًا من معلومات الوقت المٌمرَّرة إليه.
-إذا تم إعطاء وسيط عددي، ستكون النتيجة بالتوقيت المحلي.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">at(time) → time
@@ سطر 14: / سطر 12: @@
 at(seconds, microseconds, :microsecond) → time
 at(seconds, nanoseconds, :nsec) → time
-at(seconds, nanoseconds, :nanosecond) → time‎</syntaxhighlight>
+at(seconds, nanoseconds, :nanosecond) → time‎</syntaxhighlight>ينشئ التابع <code>at</code> [[Ruby/Time|توقيتً]]ا جديدًا انطلاقًا من الوقت <code>time</code> المعطى، أو عدد الثواني مع الأجزاء <code>seconds_with_frac</code>، أو عدد الثواني <code>seconds</code> والأجزاء <code>microseconds_with_frac</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 توقيت يونيكس]. تتيح ميزة عدم قابلية النقل (non-portable) أن يكون الموضع (offset) سالبًا في بعض الأنظمة.
+إذا تم إعطاء معامل [[Ruby/Numeric|عددي]]، فستعاد النتيجة وفق التوقيت المحلي.
 ==المعاملات==
 ===<code>time‎</code>===
+يضم معلومات عن التوقيت المراد إنشاؤه.
 ===<code>seconds_with_frac‎</code>===
+عدد كسري يمثل عدد الثواني مع الأجزاء. يمكن أن يكون المعامل <code>seconds_with_frac</code> من النوع <code>[[Ruby/Integer|Integer]]</code> أو <code>[[Ruby/Float|Float]]</code> أو <code>[[Ruby/Rational|Rational]]</code> أو غيرها من الأصناف [[Ruby/Numeric|العددية]].
 ===<code>seconds‎</code>===
+عدد صحيح يمثل عدد الثواني.
 ===<code>microseconds_with_frac‎</code>===
+عدد كسري يمثل أجزاء الثانية. يمكن أن يكون المعامل <code>microseconds_with_frac</code> من النوع <code>[[Ruby/Integer|Integer]]</code> أو <code>[[Ruby/Float|Float]]</code> أو <code>[[Ruby/Rational|Rational]]</code> أو غيرها من الأصناف [[Ruby/Numeric|العددية]].
 ===<code>milliseconds‎</code>===
-===<code>:millisecond‎</code>===
+عدد يمثِّل الميلي ثانية.
 ===<code>microseconds‎</code>===
-===<code>:usec‎</code>===
+عدد يمثِّل قيمة الميكرو ثانية (أجزاء الثانية).
-===<code>:microsecond‎</code>===
 ===<code>nanoseconds‎</code>===
-===<code>:nsec‎</code>===
+عدد يمثِّل قيمة النانو ثانية (أجزاء الثانية).
-===<code>:nanosecond‎</code>===
-==القيمة المُعادة==
+==القيمة المعادة==
+يعاد [[Ruby/Time|توقيتً]]ا جديدًا (كائن من النوع <code>[[Ruby/Time|Time]]</code>).
 ==أمثلة==
-مثال على استخدام التابع <code>at‎</code>:
+مثال على استخدام التابع <code>at‎</code>:<syntaxhighlight lang="ruby">Time.at(0)                                #=> 1969-12-31 18:00:00 -0600
-<syntaxhighlight lang="ruby">Time.at(0)                                #=> 1969-12-31 18:00:00 -0600
 Time.at(Time.at(0))                       #=> 1969-12-31 18:00:00 -0600
 Time.at(946702800)                        #=> 1999-12-31 23:00:00 -0600
@@ سطر 38: / سطر 48: @@
 Time.at(946684800, 123456.789).nsec       #=> 123456789
 Time.at(946684800, 123456789, :nsec).nsec  #=> 123456789‎</syntaxhighlight>
-==انظر أيضا==
+==انظر أيضًا==
-* التابع <code>[[Ruby/Time/gm|gm]]</code>: ينشئ التابع <code>gm</code> [[Ruby/Time|توقيت]]ا <code>[[Ruby/Time|Time]]</code> استنادًا إلى القيم المعطاة، ويتم تفسيرها على أنها UTC (GMT). يجب تحديد السنة. القيم الأخرى تساوي افتراضيا الحد الأدنى لقيمة هذا الحقل (وقد تكون <code>nil</code> أو قد تُحذف). يمكن تحديد الشهر بعدد من 1 إلى 12، أو بأسماء الشهور الإنجليزية المكونة من ثلاثة أحرف. يتم تحديد الساعات من المجال (0..23). سيُطلق استثناء <code>[[Ruby/ArgumentError|ArgumentError]]</code> إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر وسائط في الطلب المُخرج من <code>[[Ruby/Time/to_a|#to_a]]</code>.
+*التابع <code>[[Ruby/Time/gm|gm]]</code>: ينشئ [[Ruby/Time|توقيتً]]ا جديدًا استنادًا إلى معلومات الوقت المعطاة.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/Time.html#method-c-at قسم  التابع at‎ في الصنف Time‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/Time.html#method-c-at قسم التابع at‎ في الصنف Time‎ في توثيق روبي الرسمي.]