DateTimeOffset.ToFileTime Method ()

 

Converts the value of the current DateTimeOffset object to a Windows file time.

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

public long ToFileTime()

Return Value

Type: System.Int64

The value of the current DateTimeOffset object, expressed as a Windows file time.

Exception Condition
ArgumentOutOfRangeException

The resulting file time would represent a date and time before midnight on January 1, 1601 C.E. Coordinated Universal Time (UTC).

A Windows file time is a 64-bit value that represents the number of 100-nanosecond intervals that have elapsed since 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC). Windows uses a file time to record when an application creates, accesses, or writes to a file.

The ToFileTime method converts the current DateTimeOffset object's date and time to UTC before it performs the conversion. In other words, calling the ToFileTime method is equivalent to the following method call:

[C#]

this.ToUtcDateTime().ToFileTime();

[Visual Basic]

Me.ToUtcDateTime().ToFileTime()

Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
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
Return to top
Show: