DateTime.ToFileTimeUtc Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует значение текущего объекта DateTime во временную характеристику файла Windows.
public:
long ToFileTimeUtc();public long ToFileTimeUtc ();member this.ToFileTimeUtc : unit -> int64Public Function ToFileTimeUtc () As LongВозвращаемое значение
Значение текущего объекта DateTime, представленное в виде временной характеристики файла Windows.
Исключения
Результирующее время файла будет представлять дату и время до 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() метода .
