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

ينشئ التابع at توقيتا جديدًا Time مع القيم المعطاة من قِبل 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‎

أمثلة

مثال على استخدام التابع 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 استنادًا إلى القيم المعطاة، ويتم تفسيرها على أنها UTC (GMT). يجب تحديد السنة. القيم الأخرى تساوي افتراضيا الحد الأدنى لقيمة هذا الحقل (وقد تكون nil أو قد تُحذف). يمكن تحديد الشهر بعدد من 1 إلى 12، أو بأسماء الشهور الإنجليزية المكونة من ثلاثة أحرف. يتم تحديد الساعات من المجال (0..23). سيُطلق استثناء ArgumentError إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر وسائط في الطلب المُخرج من #to_a.

مصادر

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