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-nanosecond, прошедших с 12:00 полуночи, 1 января 1601 года A.D. (C.E.) Координированное универсальное время (UTC). Windows использует время записи файла при создании, доступе к приложению или записи в файл.
Метод ToFileTimeUtc использует Kind свойство для определения того, является ли текущий DateTime объект локальным временем, временем UTC или неопределенным типом времени, который рассматривается как время в формате UTC. Если это локальное время, оно преобразует время в ФОРМАТЕ UTC перед выполнением преобразования в время файла Windows.
Примечания для тех, кто вызывает этот метод
Иногда ToFileTimeUtc() метод используется для преобразования локального времени в utc, а затем для его восстановления путем вызова FromFileTimeUtc(Int64) метода, за которым следует ToLocalTime() метод. Однако если исходное время представляет недопустимое время в местном часовом поясе, два значения местного времени не будут равны. Дополнительные сведения см. в методе ToLocalTime() .
