C# DateTime.AddHours()用法及代码示例

此方法用于返回一个新的DateTime，它将指定的小时数添加到此实例的值。

用法:

public DateTime AddHours (double value);

在此，值是整小时数和小数小时数。值参数可以为负或正。

返回值：此方法返回一个对象，该对象的值是此实例表示的日期和时间与value表示的小时数之和。

异常：如果生成的DateTime小于MinValue或大于MaxValue，则此方法将提供ArgumentOutOfRangeException。

以下示例程序旨在说明DateTime.AddDays(Double)方法的用法：

示例1:

// C# program to demonstrate the 
// DateTime.AddHours(Double) Method 
using System; 
using System.Globalization; 
  
class GFG { 
  
    // Main Method 
    public static void Main() 
    { 
        try { 
  
            // creating object of DateTime 
            DateTime date1 = new DateTime(2010, 1, 
                                     1, 4, 0, 15); 
  
            // adding the 5.50 hours 
            // using AddHours() method; 
            DateTime date2 = date1.AddHours(5.50); 
  
            // Display the date1 
            Console.WriteLine("DateTime before operation:"+ 
                            " {0:y} {0:dd}, {0:t}", date1); 
  
            // Display the date2 
            Console.WriteLine("\nDateTime after operation: "+ 
                               "{0:y} {0:dd}, {0:t}", date2); 
        } 
  
        catch (ArgumentOutOfRangeException e) 
        { 
            Console.Write("Exception Thrown: "); 
            Console.Write("{0}", e.GetType(), e.Message); 
        } 
    } 
}

输出：

DateTime before operation: 2010 January 01, 04:00

DateTime after operation: 2010 January 01, 09:30

示例2:对于ArgumentOutOfRangeException

// C# program to demonstrate the 
// DateTime.AddHours(Double) Method 
using System; 
using System.Globalization; 
  
class GFG { 
  
    // Main Method 
    public static void Main() 
    { 
        try { 
  
            // creating object of DateTime  
            // and initialize with MinValue 
            DateTime date1 = DateTime.MaxValue; 
  
            // Display the date1 
            Console.WriteLine("DateTime before operation: "+ 
                              "{0:y} {0:dd}, {0:t}", date1); 
  
            // adding the TimeSpan of 5 days 
            // using AddHours() method; 
            DateTime date2 = date1.AddHours(5); 
  
            // Display the date2 
            System.Console.WriteLine("\nDateTime after operation:"+ 
                                    " {0:y} {0:dd}, {0:t}", date2); 
        } 
  
        catch (ArgumentOutOfRangeException e)  
        { 
            Console.WriteLine("\nThe resulting DateTime is "+ 
                      "greater than the DateTime.MaxValue "); 
  
            Console.Write("Exception Thrown: "); 
            Console.Write("{0}", e.GetType(), e.Message); 
        } 
    } 
}

输出：

DateTime before operation: 9999 December 31, 23:59

The resulting DateTime is greater than the DateTime.MaxValue 
Exception Thrown: System.ArgumentOutOfRangeException

注意：

此方法不会更改此DateTime的值。而是返回一个新的DateTime，其值是此操作的结果。
值的小数部分是一分钟的小数部分。例如，7.5等于7分钟，30秒，0毫秒和0个滴答。
value参数四舍五入到最接近的毫秒数。

参考：

https://docs.microsoft.com/en-us/dotnet/api/system.datetime.addhours?view=netframework-4.7.2

相关用法

注：本文由纯净天空筛选整理自RohitPrasad3大神的英文原创作品 DateTime.AddHours() Method in C#。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。