This method is used to return a new DateTime that adds the specified number of milliseconds to the value of this instance.
Syntax:
public DateTime AddMilliseconds (double value);
Here, it takes a number of whole and fractional milliseconds. The value parameter can be negative or positive and is rounded to the nearest integer.
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 milliseconds represented by value.
Exceptions: This method will give ArgumentOutOfRangeException if the resulting DateTime is less than MinValue or greater than MaxValue.
Below programs illustrate the use of DateTime.AddMilliseconds(Double) Method:
Example 1:
// C# program to demonstrate the // DateTime.AddMilliseconds() Method using System;
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 3000 Milliseconds
// using AddMilliseconds() method;
DateTime date2 = date1.AddMilliseconds(3000);
// Display the date1
Console.WriteLine("DateTime before operation: "
+ "{0:hh}:{0:mm}:{0:ss}", date1);
// Display the date2
Console.WriteLine("\nDateTime after operation: "
+ "{0:hh}:{0:mm}:{0:ss}", date2);
}
catch (ArgumentOutOfRangeException e)
{
Console.Write("Exception Thrown: ");
Console.Write("{0}", e.GetType(), e.Message);
}
}
} |
DateTime before operation: 04:00:15 DateTime after operation: 04:00:18
Example 2: For ArgumentOutOfRangeException
// C# program to demonstrate the // DateTime.AddMilliseconds() Method using System;
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}", date1);
// adding the 3000 Milliseconds
// using AddMilliseconds() method;
DateTime date2 = date1.AddMilliseconds(3000);
// Display the date2
Console.WriteLine("\nDateTime after operation: "
+ "{0:hh}:{0:mm}:{0:ss}", 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: 12/31/9999 23:59:59 The resulting DateTime is greater than the DateTime.MaxValue Exception Thrown: System.ArgumentOutOfRangeException
Reference: