Share via


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.