📜  C#中的DateTime.AddHours()方法

📅  最后修改于: 2021-05-29 17:01:59             🧑  作者: Mango

此方法用于返回一个新的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/zh-cn/dotnet/api/system.datetime.addhours?view=netframework-4.7.2