DateTime Constructor (Int64)
.NET Framework (current version)
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 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. */
Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Show: