التابع at‎ الخاص بالصنف Time في روبي

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث

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

مصادر