الفرق بين المراجعتين ل"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: يُعيد عدد النانوثواني المقابل للتوقيت الذي استدعي معه.

مصادر