التابع Time.at في روبي
ينشئ التابع 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