This documentation is archived and is not being maintained.

DateTime Constructor (Int64)

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
)
public DateTime (
	long ticks
)
public function DateTime (
	ticks : long
)

Parameters

ticks

A date and time expressed in 100-nanosecond units.

Exception typeCondition

ArgumentOutOfRangeException

ticks is less than MinValue or greater than MaxValue.

The Kind property is initialized to Unspecified.

The following code example demonstrates one of the DateTime constructors.

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

class Sample 
{
    public static void Main() 
    {
// 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", false).Calendar).Ticks;
    DateTime dt3 = new DateTime(ticks);

    Console.WriteLine(format, 1, "maximum", dt1);
    Console.WriteLine(format, 2, "minimum", dt2);
    Console.WriteLine(format, 3, "custom ", dt3);
    Console.WriteLine("\nThe custom date and time is created from {0:N0} ticks.", ticks);
    }
}
/*
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.

*/

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

class Sample
{
    public static void main(String[] args)
    {
        // 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.get_Ticks());
        // Create a DateTime for the minimum date and time using ticks.
        DateTime dt2 = new DateTime(DateTime.MinValue.get_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, 7, 28, 22, 35, 5, 
             (new CultureInfo("en-US", false)).get_Calendar())).get_Ticks();
        DateTime dt3 = new DateTime(ticks);

        Console.WriteLine(format, (Int32)1, "maximum", dt1);
        Console.WriteLine(format, (Int32)2, "minimum", dt2);
        Console.WriteLine(format, (Int32)3, "custom ", dt3);
        Console.WriteLine("\nThe custom date and time is "
            + "created from {0:N0} ticks.", (Int64)ticks);
    } //main
} //Sample
/*
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 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0
Show: