DateTime.ToFileTime DateTime.ToFileTime DateTime.ToFileTime DateTime.ToFileTime Method

Определение

Преобразует значение текущего объекта DateTime во временную характеристику файла Windows.Converts the value of the current DateTime object to a Windows file time.

public:
 long ToFileTime();
public long ToFileTime ();
member this.ToFileTime : unit -> int64
Public Function ToFileTime () As Long

Возвраты

Значение текущего объекта DateTime, представленное в виде временной характеристики файла Windows.The value of the current DateTime object expressed as a Windows file time.

Исключения

Получившееся время файла представит дату и время до 0:00 1 января 1601 года нашей эрыThe resulting file time would represent a date and time before 12:00 midnight January 1, 1601 C.E. в формате UTC.UTC.

Примеры

В следующем примере демонстрируется ToFileTime метод.The following example demonstrates the ToFileTime method.

int main()
{
   System::Console::WriteLine( "Enter the file path:" );
   String^ filePath = System::Console::ReadLine();
   if ( System::IO::File::Exists( filePath ) )
   {
      System::DateTime fileCreationDateTime = System::IO::File::GetCreationTime( filePath );
      __int64 fileCreationFileTime = fileCreationDateTime.ToFileTime();
      System::Console::WriteLine( "{0} in file time is {1}.", fileCreationDateTime, fileCreationFileTime );
   }
   else
   {
      System::Console::WriteLine( "{0} is an invalid file", filePath );
   }
}

static void Main(string[] args)
{
	System.Console.WriteLine("Enter the file path:");
	string filePath = System.Console.ReadLine();

	if (System.IO.File.Exists(filePath)) {
		System.DateTime fileCreationDateTime = 
			System.IO.File.GetCreationTime(filePath);

		long fileCreationFileTime = fileCreationDateTime.ToFileTime();

		System.Console.WriteLine("{0} in file time is {1}.",
								 fileCreationDateTime,
								 fileCreationFileTime);
	} 
	else {
		System.Console.WriteLine("{0} is an invalid file", filePath);
	}
}
Public Shared Sub Main()

   System.Console.WriteLine("Enter the file path:")
   Dim filePath As String
   filePath = System.Console.ReadLine()

   If System.IO.File.Exists(filePath) Then
      Dim fileCreationDateTime As System.DateTime
      fileCreationDateTime = System.IO.File.GetCreationTime(filePath)

      Dim fileCreationFileTime As Long
      fileCreationFileTime = fileCreationDateTime.ToFileTime()

      System.Console.WriteLine("{0} in file time is {1}.", _
                               fileCreationDateTime, _
                               fileCreationFileTime)
   Else
      System.Console.WriteLine("{0} is an invalid file", filePath)
   End If
End Sub

Комментарии

Время файла Windows — это 64-разрядное значение, представляющее количество 100-наносекундных интервалов, прошедших с 00:00 1 января 1601 года н. э.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.) Скоординированного времени (UTC).(C.E.) Coordinated Universal Time (UTC). Windows использует время файла для записи, когда приложение создает, обращается к или записывает в файл.Windows uses a file time to record when an application creates, accesses, or writes to a file.

ToFileTime Использует метод Kind свойства, чтобы определить ли текущий DateTime объект является местное время, время в формате UTC или неуказанный вида времени, который интерпретируется как местное время.The ToFileTime method uses the Kind property to determine whether the current DateTime object is a local time, a UTC time, or an unspecified kind of time which is treated as a local time.

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

Как правило FromFileTime(Int64) метод восстанавливает DateTime значение, которое было сохранено путем ToFileTime() метод.Ordinarily, the FromFileTime(Int64) method restores a DateTime value that was saved by the ToFileTime() method. Тем не менее эти два значения могут отличаться при следующих условиях:However, the two values may differ under the following conditions: Если сериализация и десериализация DateTime значение возникать в разных часовых поясах.- If the serialization and deserialization of the DateTime value occur in different time zones. Например если DateTime значение времени 12:30 поFor example, if a DateTime value with a time of 12:30 P.M. в США. Восточное часовой пояс сериализуется и затем десериализуется в США. Тихоокеанском стандартном часовом поясе, исходное значение 12:30 по Гринвичуin the U.S. Eastern Time zone is serialized, and then deserialized in the U.S. Pacific Time zone, the original value of 12:30 P.M. настраивается в 9:30:00is adjusted to 9:30 A.M. Чтобы отразить разницу между двумя часовыми поясами.to reflect the difference between the two time zones.

Если DateTime значение, которое сериализуется представляет недопустимое время в местном часовом поясе.- If the DateTime value that is serialized represents an invalid time in the local time zone. В этом случае ToFileTime() метод корректирует восстановленной DateTime значение так, чтобы он представлял допустимое время в местном часовом поясе.In this case, the ToFileTime() method adjusts the restored DateTime value so that it represents a valid time in the local time zone.

Например переход со стандартного времени на летнее время происходит в США. Тихоокеанском стандартном часовом поясе с 14 марта 2010 г. в 2:00, когда время увеличивается на один час до 3:00.For example, the transition from standard time to daylight saving time occurs in the U.S. Pacific Time zone on March 14, 2010, at 2:00 A.M., when the time advances by one hour, to 3:00 A.M. Этот часовой интервал является недопустимым временем, то есть интервал времени, не существует в данном часовом поясе.This hour interval is an invalid time, that is, a time interval that does not exist in this time zone. В следующем примере показано, что при времени, в который попадает в этот диапазон преобразуется в значение типа long integer, ToFileTime() метода и затем восстановлен FromFileTime(Int64) метод, исходное значение корректируется так, чтобы стать допустимым.The following example shows that when a time that falls within this range is converted to a long integer value by the ToFileTime() method and is then restored by the FromFileTime(Int64) method, the original value is adjusted to become a valid time. Можно определить ли определенная дата и время значение может быть меняться, передав его в IsInvalidTime(DateTime) метод, как показано в примере.You can determine whether a particular date and time value may be subject to modification by passing it to the IsInvalidTime(DateTime) method, as the example illustrates.

[!code-csharpSystem.DateTime.FromFileTime#1] [!code-vbSystem.DateTime.FromFileTime#1][!code-csharpSystem.DateTime.FromFileTime#1] [!code-vbSystem.DateTime.FromFileTime#1]

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

Дополнительно