DateTime.ToFileTimeUtc Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Исходный код:

DateTime.cs

Преобразует значение текущего объекта DateTime во временную характеристику файла Windows.

public:
 long ToFileTimeUtc();

public long ToFileTimeUtc ();

member this.ToFileTimeUtc : unit -> int64

Public Function ToFileTimeUtc () As Long

Возвращаемое значение

Int64

Значение текущего объекта DateTime, представленное в виде временной характеристики файла Windows.

Исключения

ArgumentOutOfRangeException

Результирующее время файла будет представлять дату и время до 12:00 полуночи 1 января 1601 года (UTC).

Комментарии

Время файла Windows — это 64-разрядное значение, представляющее количество 100-наносекундных интервалов, прошедших с 12:00 полуночи 1 января 1601 г. н.э. (C.E.) Время в формате UTC. Windows использует время файла для записи, когда приложение создает файл, обращается к файлу или записывает его.

Метод ToFileTimeUtc использует свойство , Kind чтобы определить, является ли текущий DateTime объект локальным временем, временем в формате UTC или неопределенным типом времени, который рассматривается как время в формате UTC. Если это местное время, оно преобразует время в формат UTC перед выполнением преобразования в время файла Windows.

Примечания для тех, кто вызывает этот метод

Метод ToFileTimeUtc() иногда используется для преобразования местного времени в формат UTC, а затем для его восстановления путем вызова FromFileTimeUtc(Int64) метода , за которым следует ToLocalTime() метод . Однако если исходное время представляет недопустимое время в местном часовом поясе, два значения местного времени не будут равны. Дополнительные сведения см. в описании ToLocalTime() метода .

См. также раздел

• ToFileTime()
• Int64
• ToUniversalTime()
• GetUtcOffset(DateTime)