DateTime Constructor (Int64)

July 28, 2014

Initializes a new instance of the DateTime structure to a specified number of ticks.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public DateTime(
	long ticks
)

Parameters

ticks
Type: System.Int64
A date and time expressed in the number of 100-nanosecond intervals that have elapsed since January 1, 0001 at 00:00:00.000 in the Gregorian calendar.

ExceptionCondition
ArgumentOutOfRangeException

ticks is less than DateTime.MinValue or greater than DateTime.MaxValue.

The Kind property is initialized to Unspecified.

For applications in which a limited degree of time zone awareness is important, you can use the corresponding DateTimeOffset constructor.

The following example demonstrates one of the DateTime constructors.


// This example demonstrates the DateTime(Int64) constructor.
using System;
using System.Globalization;

class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      // Instead of using the implicit, default "G" date and time format string, we 
      // use a custom format string that aligns the results and inserts leading zeroes.
      string format = "{0}) The {1} date and time is {2:MM/dd/yyyy hh:mm:ss tt}";

      // Create a DateTime for the maximum date and time using ticks.
      DateTime dt1 = new DateTime(DateTime.MaxValue.Ticks);

      // Create a DateTime for the minimum date and time using ticks.
      DateTime dt2 = new DateTime(DateTime.MinValue.Ticks);

      // Create a custom DateTime for 7/28/1979 at 10:35:05 PM using a 
      // calendar based on the "en-US" culture, and ticks. 
      long ticks = new DateTime(1979, 07, 28, 22, 35, 5,
     new CultureInfo("en-US").Calendar).Ticks;
      DateTime dt3 = new DateTime(ticks);

      outputBlock.Text += String.Format(format, 1, "maximum", dt1) + "\n";
      outputBlock.Text += String.Format(format, 2, "minimum", dt2) + "\n";
      outputBlock.Text += String.Format(format, 3, "custom ", dt3) + "\n";
      outputBlock.Text += String.Format("\nThe custom date and time is created from {0:N0} ticks.", ticks) + "\n";
   }
}
/*
This example produces the following results:

1) The maximum date and time is 12/31/9999 11:59:59 PM
2) The minimum date and time is 01/01/0001 12:00:00 AM
3) The custom  date and time is 07/28/1979 10:35:05 PM

The custom date and time is created from 624,376,461,050,000,000 ticks.

*/


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2014 Microsoft