التابع 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