DateTime.AddTicks() Method in C#

This method is used to returns a new DateTime that adds the specified number of ticks to the value of this instance. This method does not change the value of this DateTime. Instead, it returns a new DateTime whose value is the result of this operation.

Syntax:

public DateTime AddTicks (long value);

Here, it takes a number of 100-nanosecond ticks.

Return Value: This method returns an object whose value is the sum of the date and time represented by this instance and the time 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.AddTicks(Int64) Method:

Example 1:

// C# program to demonstrate the
// DateTime.AddTicks(Double) 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 ticks
            // using AddTicks() method;
            DateTime date2 = date1.AddTicks(3000);

            // Display the date1
            Console.WriteLine("No. of ticks before operation: "
                                        + "{0}", date1.Ticks);


            // Display the date2
            Console.WriteLine("\nNo. of ticks after operation: "
                                         + "{0}",  date2.Ticks);

        }

        catch (ArgumentOutOfRangeException e)
        {
            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

Output:

No. of ticks before operation: 633979152150000000

No. of ticks after operation: 633979152150003000

Example 2: For ArgumentOutOfRangeException

// C# program to demonstrate the
// DateTime.AddTicks(long) 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.Ticks);


            // adding the 1 Ticks
            // using AddTicks() method;
            DateTime date2 = date1.AddTicks(1);

            // Display the date2
            Console.WriteLine("\nDateTime after operation: "
                                      + "{0}",  date2.Ticks);

        }

        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: 3155378975999999999

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

Reference:

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