الفرق بين المراجعتين لصفحة: «Ruby/Time/round»

من موسوعة حسوب
< Ruby‏ | Time
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>round‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف:...'
 
ط مراجعة وتدقيق.
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>round‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude>
<noinclude>{{DISPLAYTITLE: التابع <code>Time.round‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Time]]
[[تصنيف: Ruby Time]]
يُقرّب التابع <code>round</code> الثواني الفرعية وفق دقة معينة من المنازل العشرية (0 هو القيمة الافتراضية). تقوم بيُعيد التابع <code>round</code> [[Ruby/Time|توقيت]]ا <code>[[Ruby/Time|Time]]</code> جديدًا. يجب أن يكون الوسيط <code>ndigits</code> (انظر فقرة البنية العامة) 0 أو عددًا صحيحًا أو موجبًا.
يُقرّب التابع <code>round</code> الأجزاء العشرية من الثواني وفق دقة معينة من المنازل العشرية للتوقيت الذي استدعي معه.  
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="ruby">round([ndigits])→ new_time‎</syntaxhighlight>
<syntaxhighlight lang="ruby">round([ndigits])→ new_time‎</syntaxhighlight>
==المعاملات==
==المعاملات==
===<code>ndigits‎</code>===
===<code>ndigits‎</code>===
يحدد عدد المنازل العشرية
يحدد عدد المنازل العشرية. يجب أن يكون هذا المعامل عددًا صحيحًا موجبًا. القيمة الافتراضية هي: 0.
==القيمة المُعادة==
==القيمة المعادة==
يعاد توقيتٌ جديدٌ يحوي التوقيت المعطى بعد تقريب أجزاء الثانية فيه بدقة <code>ndigits‎</code>.
 
==أمثلة==
==أمثلة==
مثال على استخدام التابع <code>round‎</code>:
مثال على استخدام التابع <code>round‎</code>:
سطر 36: سطر 38:
t = Time.utc(1999,12,31, 23,59,59)
t = Time.utc(1999,12,31, 23,59,59)
p (t + 0.123456789).round(4).iso8601(6)  #=> "1999-12-31T23:59:59.123500Z"‎</syntaxhighlight>
p (t + 0.123456789).round(4).iso8601(6)  #=> "1999-12-31T23:59:59.123500Z"‎</syntaxhighlight>
==انظر أيضا==
==انظر أيضًا==
* التابع <code>[[Ruby/Time/nsec|nsec]]</code>: يُعيد التابع <code>nsec</code> عدد النانوثواني المقابل لل[[Ruby/Time|توقيت]] <code>time</code>.
* التابع <code>[[Ruby/Time/nsec|nsec]]</code>: يُعيد عدد النانوثواني المقابل لل[[Ruby/Time|توقيت]] الذي استدعي معه.
* التابع <code>[[Ruby/Time/saturday-3F|saturday?‎]]</code>: يُعيد التابع <code>saturday?‎</code> القيمة <code>true</code> إن كان [[Ruby/Time|التوقيت]] <code>time</code> يمثل يوم السبت.
==مصادر==
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Time.html#method-i-round قسم التابع round‎ في الصنف Time‎ في توثيق روبي الرسمي.]
*[http://ruby-doc.org/core-2.5.1/Time.html#method-i-round قسم التابع round‎ في الصنف Time‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 16:52، 7 ديسمبر 2018

يُقرّب التابع round الأجزاء العشرية من الثواني وفق دقة معينة من المنازل العشرية للتوقيت الذي استدعي معه.

البنية العامة

round([ndigits]) new_time

المعاملات

ndigits‎

يحدد عدد المنازل العشرية. يجب أن يكون هذا المعامل عددًا صحيحًا موجبًا. القيمة الافتراضية هي: 0.

القيمة المعادة

يعاد توقيتٌ جديدٌ يحوي التوقيت المعطى بعد تقريب أجزاء الثانية فيه بدقة ndigits‎.

أمثلة

مثال على استخدام التابع round‎:

require 'time'
t = Time.utc(2010,3,30, 5,43,"25.123456789".to_r)
p t.iso8601(10)           #=> "2010-03-30T05:43:25.1234567890Z"
p t.round.iso8601(10)     #=> "2010-03-30T05:43:25.0000000000Z"
p t.round(0).iso8601(10)  #=> "2010-03-30T05:43:25.0000000000Z"
p t.round(1).iso8601(10)  #=> "2010-03-30T05:43:25.1000000000Z"
p t.round(2).iso8601(10)  #=> "2010-03-30T05:43:25.1200000000Z"
p t.round(3).iso8601(10)  #=> "2010-03-30T05:43:25.1230000000Z"
p t.round(4).iso8601(10)  #=> "2010-03-30T05:43:25.1235000000Z"
p t.round(5).iso8601(10)  #=> "2010-03-30T05:43:25.1234600000Z"
p t.round(6).iso8601(10)  #=> "2010-03-30T05:43:25.1234570000Z"
p t.round(7).iso8601(10)  #=> "2010-03-30T05:43:25.1234568000Z"
p t.round(8).iso8601(10)  #=> "2010-03-30T05:43:25.1234567900Z"
p t.round(9).iso8601(10)  #=> "2010-03-30T05:43:25.1234567890Z"
p t.round(10).iso8601(10) #=> "2010-03-30T05:43:25.1234567890Z"
t = Time.utc(1999,12,31, 23,59,59)
p((t + 0.4).round.iso8601(3))    #=> "1999-12-31T23:59:59.000Z"
p((t + 0.49).round.iso8601(3))   #=> "1999-12-31T23:59:59.000Z"
p((t + 0.5).round.iso8601(3))    #=> "2000-01-01T00:00:00.000Z"
p((t + 1.4).round.iso8601(3))    #=> "2000-01-01T00:00:00.000Z"
p((t + 1.49).round.iso8601(3))   #=> "2000-01-01T00:00:00.000Z"
p((t + 1.5).round.iso8601(3))    #=> "2000-01-01T00:00:01.000Z"
t = Time.utc(1999,12,31, 23,59,59)
p (t + 0.123456789).round(4).iso8601(6)  #=> "1999-12-31T23:59:59.123500Z"‎

انظر أيضًا

  • التابع nsec: يُعيد عدد النانوثواني المقابل للتوقيت الذي استدعي معه.

مصادر