DateTime.FromFileTime(Int64) DateTime.FromFileTime(Int64) DateTime.FromFileTime(Int64) DateTime.FromFileTime(Int64) Method

Definición

Convierte la hora de archivo de Windows especificada en una hora local equivalente.Converts the specified Windows file time to an equivalent local time.

public:
 static DateTime FromFileTime(long fileTime);
public static DateTime FromFileTime (long fileTime);
static member FromFileTime : int64 -> DateTime
Public Shared Function FromFileTime (fileTime As Long) As DateTime

Parámetros

fileTime
Int64 Int64 Int64 Int64

Hora de un archivo de Windows, expresada en pasos.A Windows file time expressed in ticks.

Devoluciones

Objeto que representa la hora local equivalente a la fecha y hora representadas por el parámetro fileTime.An object that represents the local time equivalent of the date and time represented by the fileTime parameter.

Excepciones

fileTime es menor que 0 o representa una hora posterior a MaxValue.fileTime is less than 0 or represents a time greater than MaxValue.

Ejemplos

En el ejemplo siguiente se muestra el FromFileTime método.The following example demonstrates the FromFileTime method.

System::TimeSpan FileAge( long fileCreationTime )
{
   System::DateTime now = System::DateTime::Now;
   try
   {
      System::DateTime fCreationTime =
         System::DateTime::FromFileTime( fileCreationTime );
      System::TimeSpan fileAge = now.Subtract( fCreationTime );
      return fileAge;
   }
   catch ( ArgumentOutOfRangeException^ ) 
   {
      // fileCreationTime is not valid, so re-throw the exception.
      throw;
   }
}
public System.TimeSpan FileAge(long fileCreationTime) {

	System.DateTime now = System.DateTime.Now;
	try {
		System.DateTime fCreationTime = 
			System.DateTime.FromFileTime(fileCreationTime);
		System.TimeSpan fileAge = now.Subtract(fCreationTime);
		return fileAge;				
	} 
	catch (ArgumentOutOfRangeException) {
		// fileCreationTime is not valid, so re-throw the exception.
		throw;
	}
}
Public Function FileAge(ByVal fileCreationTime As Long) As System.TimeSpan
   Dim now As System.DateTime
   now = System.DateTime.Now

   Try
      Dim fCreationTime As System.DateTime
      Dim fAge As System.TimeSpan
      fCreationTime = System.DateTime.FromFileTime(fileCreationTime)
      fAge = now.Subtract(fCreationTime)
      Return fAge
   Catch exp As ArgumentOutOfRangeException
      ' fileCreationTime is not valid, so re-throw the exception.
      Throw
   End Try
End Function

Comentarios

Hora de un archivo de Windows es un valor de 64 bits que representa el número de intervalos de 100 nanosegundos que han transcurrido desde las 12:00 de la noche del 1 de enero de 1601 D.C.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.) Hora de Universal coordinada (UTC).(C.E.) Coordinated Universal Time (UTC). Windows usa una hora de archivo para registrar cuando se crea, tiene acceso a una aplicación o escribe en un archivo.Windows uses a file time to record when an application creates, accesses, or writes to a file.

El fileTime parámetro especifica una hora de archivo expresada en pasos de 100 nanosegundos.The fileTime parameter specifies a file time expressed in 100-nanosecond ticks.

A partir de la versión 2.0 de .NET Framework, el valor devuelto es un DateTime cuyo Kind propiedad es DateTimeKind.Local.Starting with the .NET Framework version 2.0, the return value is a DateTime whose Kind property is DateTimeKind.Local.

Notas a los autores de las llamadas

Normalmente, el FromFileTime(Int64) método restaura un DateTime valor guardada por el ToFileTime() método.Ordinarily, the FromFileTime(Int64) method restores a DateTime value that was saved by the ToFileTime() method. Sin embargo, los dos valores pueden diferir en las siguientes condiciones:However, the two values may differ under the following conditions: -If la serialización y deserialización de la DateTime producirse en distintas zonas horarias.- If the serialization and deserialization of the DateTime value occur in different time zones. Por ejemplo, si un DateTime valor con un tiempo de 12:30 P.M.For example, if a DateTime value with a time of 12:30 P.M. en los Estados Unidos. Zona de hora se serializa y deserializa a continuación, en los Estados Unidos. Zona horaria del Pacífico, el valor original de 12:30 P.M.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. se ajusta a las 9:30 a. M.is adjusted to 9:30 A.M. para reflejar la diferencia entre las dos zonas horarias.to reflect the difference between the two time zones.

-If el DateTime valor que se serializa representa una hora no válida en la zona horaria local.- If the DateTime value that is serialized represents an invalid time in the local time zone. En este caso, el ToFileTime() método ajusta el restaurada DateTime valor para que represente una hora válida en la zona horaria local.In this case, the ToFileTime() method adjusts the restored DateTime value so that it represents a valid time in the local time zone.

Por ejemplo, se produce la transición desde el horario estándar al horario de verano en Estados Unidos Zona horaria del Pacífico de 14 de marzo de 2010, a las 2:00 A.M., cuando la hora se adelanta una hora, a las 3:00 A.M.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. Este intervalo de hora es una hora no válida, es decir, un intervalo de tiempo que no existe en esta zona horaria.This hour interval is an invalid time, that is, a time interval that does not exist in this time zone. El ejemplo siguiente se muestra que cuando una hora que se encuentra dentro de este intervalo se convierte en un valor entero largo por el ToFileTime() método y, a continuación, se restaura por la FromFileTime(Int64) método, el valor original se ajusta para ser una hora válida.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. Puede determinar si una fecha determinada y el valor de tiempo pueden estar sujeto a modificación pasándolo a la IsInvalidTime(DateTime) método, como en el ejemplo se muestra.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]

Se aplica a

Consulte también: