DateTimeOffset.ToFileTime Method
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Converts the value of the current DateTimeOffset object to a Windows file time.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Function ToFileTime As Long
public long ToFileTime()
Return Value
Type: System.Int64
The value of the current DateTimeOffset object, expressed as a Windows file time.
Exceptions
| 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). |
Remarks
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()
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.