DateTime.AddHours() Method in C#
Last Updated :
21 Jan, 2019
This method is used to return a new DateTime that adds the specified number of hours to the value of this instance.
Syntax:
public DateTime AddHours (double value);
Here, the value is the number of whole and fractional hours. The value parameter can be negative or positive.
Return Value: This method returns an object whose value is the sum of the date and time represented by this instance and the number of hours represented by value.
Exception: This method will give ArgumentOutOfRangeException if the resulting DateTime is less than MinValue or greater than MaxValue.
Below programs illustrate the use of DateTime.AddDays(Double) Method:
Example 1:
using System;
using System.Globalization;
class GFG {
public static void Main()
{
try {
DateTime date1 = new DateTime(2010, 1,
1, 4, 0, 15);
DateTime date2 = date1.AddHours(5.50);
Console.WriteLine( "DateTime before operation:" +
" {0:y} {0:dd}, {0:t}" , date1);
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);
}
}
}
|
Output:
DateTime before operation: 2010 January 01, 04:00
DateTime after operation: 2010 January 01, 09:30
Example 2: For ArgumentOutOfRangeException
using System;
using System.Globalization;
class GFG {
public static void Main()
{
try {
DateTime date1 = DateTime.MaxValue;
Console.WriteLine( "DateTime before operation: " +
"{0:y} {0:dd}, {0:t}" , date1);
DateTime date2 = date1.AddHours(5);
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);
}
}
}
|
Output:
DateTime before operation: 9999 December 31, 23:59
The resulting DateTime is greater than the DateTime.MaxValue
Exception Thrown: System.ArgumentOutOfRangeException
Note:
- This method does not change the value of this DateTime. Instead, it returns a new DateTime whose value is the result of this operation.
- The fractional part of the value is the fractional part of a minute. For example, 7.5 is equivalent to 7 minutes, 30 seconds, 0 milliseconds, and 0 ticks.
- The value parameter is rounded to the nearest millisecond.
Reference:
Share your thoughts in the comments
Please Login to comment...