الفرق بين المراجعتين لصفحة: «Ruby/Time/at»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| (مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع <code>at | <noinclude>{{DISPLAYTITLE: التابع <code>Time.at</code> في روبي}}</noinclude> | ||
[[تصنيف: Ruby]] | [[تصنيف: Ruby]] | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Time]] | [[تصنيف: Ruby Time]] | ||
ينشئ التابع <code>at</code> [[Ruby/Time| | ينشئ التابع <code>at</code> [[Ruby/Time|توقيتً]]ا جديدًا انطلاقًا من معلومات الوقت المٌمرَّرة إليه. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">at(time) → time | <syntaxhighlight lang="ruby">at(time) → time | ||
| سطر 14: | سطر 12: | ||
at(seconds, microseconds, :microsecond) → time | at(seconds, microseconds, :microsecond) → time | ||
at(seconds, nanoseconds, :nsec) → time | at(seconds, nanoseconds, :nsec) → time | ||
at(seconds, nanoseconds, :nanosecond) → time</syntaxhighlight> | at(seconds, nanoseconds, :nanosecond) → time</syntaxhighlight>ينشئ التابع <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 توقيت يونيكس]. تتيح ميزة عدم قابلية النقل (non-portable) أن يكون الموضع (offset) سالبًا في بعض الأنظمة. | ||
إذا تم إعطاء معامل [[Ruby/Numeric|عددي]]، فستعاد النتيجة وفق التوقيت المحلي. | |||
==المعاملات== | ==المعاملات== | ||
===<code>time</code>=== | ===<code>time</code>=== | ||
يضم معلومات عن التوقيت المراد إنشاؤه. | |||
===<code>seconds_with_frac</code>=== | ===<code>seconds_with_frac</code>=== | ||
عدد كسري يمثل عدد الثواني مع الأجزاء. يمكن أن يكون المعامل <code>seconds_with_frac</code> من النوع <code>[[Ruby/Integer|Integer]]</code> أو <code>[[Ruby/Float|Float]]</code> أو <code>[[Ruby/Rational|Rational]]</code> أو غيرها من الأصناف [[Ruby/Numeric|العددية]]. | |||
===<code>seconds</code>=== | ===<code>seconds</code>=== | ||
عدد صحيح يمثل عدد الثواني. | |||
===<code>microseconds_with_frac</code>=== | ===<code>microseconds_with_frac</code>=== | ||
عدد كسري يمثل أجزاء الثانية. يمكن أن يكون المعامل <code>microseconds_with_frac</code> من النوع <code>[[Ruby/Integer|Integer]]</code> أو <code>[[Ruby/Float|Float]]</code> أو <code>[[Ruby/Rational|Rational]]</code> أو غيرها من الأصناف [[Ruby/Numeric|العددية]]. | |||
===<code>milliseconds</code>=== | ===<code>milliseconds</code>=== | ||
عدد يمثِّل الميلي ثانية. | |||
===<code>microseconds</code>=== | ===<code>microseconds</code>=== | ||
عدد يمثِّل قيمة الميكرو ثانية (أجزاء الثانية). | |||
===<code>nanoseconds</code>=== | ===<code>nanoseconds</code>=== | ||
== | عدد يمثِّل قيمة النانو ثانية (أجزاء الثانية). | ||
==القيمة المعادة== | |||
يعاد [[Ruby/Time|توقيتً]]ا جديدًا (كائن من النوع <code>[[Ruby/Time|Time]]</code>). | |||
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <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(Time.at(0)) #=> 1969-12-31 18:00:00 -0600 | ||
Time.at(946702800) #=> 1999-12-31 23:00:00 -0600 | Time.at(946702800) #=> 1999-12-31 23:00:00 -0600 | ||
| سطر 38: | سطر 48: | ||
Time.at(946684800, 123456.789).nsec #=> 123456789 | Time.at(946684800, 123456.789).nsec #=> 123456789 | ||
Time.at(946684800, 123456789, :nsec).nsec #=> 123456789</syntaxhighlight> | Time.at(946684800, 123456789, :nsec).nsec #=> 123456789</syntaxhighlight> | ||
==انظر | ==انظر أيضًا== | ||
* التابع <code>[[Ruby/Time/gm|gm]]</code>: ينشئ | *التابع <code>[[Ruby/Time/gm|gm]]</code>: ينشئ [[Ruby/Time|توقيتً]]ا جديدًا استنادًا إلى معلومات الوقت المعطاة. | ||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/Time.html#method-c-at قسم | *[http://ruby-doc.org/core-2.5.1/Time.html#method-c-at قسم التابع at في الصنف Time في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 12:04، 6 ديسمبر 2018
ينشئ التابع 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