當前位置: 首頁>>代碼示例 >>用法及示例精選 >>正文


C# DateTime.AddMinutes()用法及代碼示例


此方法用於返回一個新的DateTime,它將指定的分鍾數添加到此實例的值中。

用法:

public DateTime AddMinutes (double value);

在這裏,值是整數分鍾的一部分。值參數可以為負或正。


返回值:此方法返回一個對象,該對象的值是此實例表示的日期和時間與value表示的分鍾數之和。

異常:如果生成的DateTime小於MinValue或大於MaxValue,則此方法將引發ArgumentOutOfRangeException。

以下示例程序旨在說明上述方法的用法:

示例1:

// C# program to demonstrate the 
// DateTime.AddMinutes(Double) Method 
using System; 
  
class GFG { 
  
// Main Method 
public static void Main() 
{ 
  
    // Creating a DateTime object 
    DateTime d1 = new DateTime(2018, 9, 
                            7, 7, 0, 0); 
  
    // Taking minutes 
    double[] m1 = {.01567, .06743, 12.12347, 
                           .89, .6666, 250.0}; 
  
    foreach(double m2 in m1) 
    { 
  
        // using the method 
        Console.WriteLine("{0} + {1} minute(s) = {2}", d1, 
                                   m2, d1.AddMinutes(m2)); 
    }                     
} 
}

輸出:

09/07/2018 07:00:00 + 0.01567 minute(s) = 09/07/2018 07:00:00
09/07/2018 07:00:00 + 0.06743 minute(s) = 09/07/2018 07:00:04
09/07/2018 07:00:00 + 12.12347 minute(s) = 09/07/2018 07:12:07
09/07/2018 07:00:00 + 0.89 minute(s) = 09/07/2018 07:00:53
09/07/2018 07:00:00 + 0.6666 minute(s) = 09/07/2018 07:00:39
09/07/2018 07:00:00 + 250 minute(s) = 09/07/2018 11:10:00

示例2:

// C# program to demonstrate the 
// DateTime.AddMinutes(Double) Method 
using System; 
  
class GFG { 
  
// Main Method 
public static void Main() 
{ 
  
    // Creating a DateTime object 
    // by taking it MaxValue 
    DateTime d1 = DateTime.MaxValue; 
  
    // Taking minute variable 
    double m1 = 1.7; 
  
    // Using the Method will error as the 
    // resulting DateTime is greater than  
    // MaxValue 
    Console.WriteLine(d1.AddMinutes(m1)); 
} 
}

運行時錯誤:

Unhandled Exception:
System.ArgumentOutOfRangeException: The added or subtracted value results in an un-representable DateTime.
Parameter name: value

注意:

  • 此方法不會更改此DateTime的值。而是返回一個新的DateTime,其值是此操作的結果。
  • 值的小數部分是一分鍾的小數部分。例如,7.5等於7分鍾,30秒,0毫秒和0個滴答。
  • value參數四舍五入到最接近的毫秒數。

參考:



相關用法


注:本文由純淨天空篩選整理自Kirti_Mangal大神的英文原創作品 DateTime.AddMinutes() Method in C#。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。