DateTime Constructor (Int64)
Updated: August 2010
Initializes a new instance of the DateTime structure to a specified number of ticks.
Assembly: mscorlib (in mscorlib.dll)
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.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | ticks is less than DateTime::MinValue or greater than DateTime::MaxValue. |
The Kind property is initialized to DateTimeKind::Unspecified.
For applications in which portability of date and time data or 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 namespace System; using namespace System::Globalization; int 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 = DateTime(DateTime::MaxValue.Ticks); // Create a DateTime for the minimum date and time using ticks. DateTime dt2 = 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. Int64 ticks = DateTime(1979,07,28,22,35,5,(gcnew CultureInfo( "en-US",false ))->Calendar).Ticks; DateTime dt3 = 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. */
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.