Прочитать на английском

Поделиться через

DateTime.ToFileTimeUtc Метод

  • Ссылка

Определение

Пространство имен:
System
Сборки:
mscorlib.dll, System.Runtime.dll
Сборки:
netstandard.dll, System.Runtime.dll
Сборка:
System.Runtime.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
DateTime.cs
Исходный код:
DateTime.cs
Исходный код:
DateTime.cs

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

C# 
public long ToFileTimeUtc();

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

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() метода .

Применяется к

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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