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

مراجعة 10:01، 7 نوفمبر 2018

ينشئ التابع at توقيتا جديدًا انطلاقا من الوسيط المعطى time (انظر فقرة البنية العامة)، أو عدد الثواني seconds_with_frac، أو عدد الثواني seconds والكسور microseconds_with_frac التي مرت منذ حقبة يونيكس. يمكن أن يكون الوسيطان seconds_with_frac و microseconds_with_frac من النوع Integer أو Float أو Rational أو غيرها من الأصناف العددية (Numeric). تتيح ميزة غير المحمولة أن يكون الموضع (offset) سالبًا في بعض الأنظمة.

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

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

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‎

المعاملات

`time‎`

وسيط يضم معلومات عن التوقيت.

`seconds_with_frac‎`

عدد كسري يمثل عدد الثواني

`seconds‎`

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

`microseconds_with_frac‎`

عدد كسري يمثل الميكروثواني

`milliseconds‎`

عدد الميليثواني

`microseconds‎`

عدد الميكروثواني

`nanoseconds‎`

عدد النانوثواني

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

يعيد التابع at توقيتا جديدًا.

أمثلة

مثال على استخدام التابع 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: ينشئ التابع gm توقيتا Time استنادًا إلى القيم المعطاة.

مصادر

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

@@ سطر 3: / سطر 3: @@
 [[تصنيف: 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|توقيت]]ا جديدًا انطلاقا من الوسيط المعطى <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) سالبًا في بعض الأنظمة.
-إذا تم إعطاء وسيط عددي، ستكون النتيجة بالتوقيت المحلي.
+إذا تم إعطاء وسيط عددي، ستعاد النتيجة وفق التوقيت المحلي.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">at(time) → time
@@ سطر 17: / سطر 17: @@
 ==المعاملات==
 ===<code>time‎</code>===
+وسيط يضم معلومات عن التوقيت.
 ===<code>seconds_with_frac‎</code>===
+عدد كسري يمثل عدد الثواني
 ===<code>seconds‎</code>===
+عدد صحيح يمثل عدد الثواني.
 ===<code>microseconds_with_frac‎</code>===
+عدد كسري يمثل الميكروثواني
 ===<code>milliseconds‎</code>===
-===<code>:millisecond‎</code>===
+عدد الميليثواني
 ===<code>microseconds‎</code>===
-===<code>:usec‎</code>===
+عدد الميكروثواني
-===<code>:microsecond‎</code>===
 ===<code>nanoseconds‎</code>===
-===<code>:nsec‎</code>===
+عدد النانوثواني
-===<code>:nanosecond‎</code>===
 ==القيمة المُعادة==
+يعيد التابع <code>at</code> [[Ruby/Time|توقيت]]ا جديدًا.
 ==أمثلة==
-مثال على استخدام التابع <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
@@ سطر 39: / سطر 49: @@
 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>: ينشئ التابع <code>gm</code> [[Ruby/Time|توقيت]]ا <code>[[Ruby/Time|Time]]</code> استنادًا إلى القيم المعطاة.
 ==مصادر==
 *[http://ruby-doc.org/core-2.5.1/Time.html#method-c-at قسم  التابع at‎ في الصنف Time‎ في توثيق روبي الرسمي.]