DateTime.FromFileTime(Int64) Metodo

Definizione

Converte l'ora specificata di un file di Windows in un'ora locale 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

Parametri

fileTime
Int64

Ora di un file di Windows espressa in tick.A Windows file time expressed in ticks.

Restituisce

Oggetto che rappresenta l'ora locale equivalente della data e dell'ora rappresentate dal parametro fileTime.An object that represents the local time equivalent of the date and time represented by the fileTime parameter.

Eccezioni

fileTime è minore di 0 o rappresenta un periodo di tempo maggiore di MaxValue.fileTime is less than 0 or represents a time greater than MaxValue.

Esempi

Nell'esempio seguente viene illustrato il metodo FromFileTime.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

Commenti

Un'ora di file di Windows è un valore a 64 bit che rappresenta il numero di intervalli di 100-nanosecondi trascorsi da 12:00 mezzanotte, 1 gennaio 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. E.V. Ora UTC (Coordinated Universal Time).(C.E.) Coordinated Universal Time (UTC). Windows utilizza un'ora di file per registrare quando un'applicazione crea, accede o scrive in un file.Windows uses a file time to record when an application creates, accesses, or writes to a file.

Il parametro fileTime specifica l'ora di un file espressa in cicli di 100 nanosecondi.The fileTime parameter specifies a file time expressed in 100-nanosecond ticks.

A partire dalla versione .NET Framework 2,0, il valore restituito è un DateTime la cui proprietà Kind è DateTimeKind.Local.Starting with the .NET Framework version 2.0, the return value is a DateTime whose Kind property is DateTimeKind.Local.

Note per i chiamanti

In genere, il metodo FromFileTime(Int64) ripristina un valore DateTime salvato dal metodo ToFileTime().Ordinarily, the FromFileTime(Int64) method restores a DateTime value that was saved by the ToFileTime() method. Tuttavia, i due valori possono variare in base alle condizioni seguenti:However, the two values may differ under the following conditions: -Se la serializzazione e la deserializzazione del DateTime valore si verificano in fusi orari diversi.- If the serialization and deserialization of the DateTime value occur in different time zones. Ad esempio, se un DateTime valore con un'ora di 12:30 oreFor example, if a DateTime value with a time of 12:30 P.M. nel fuso orario di Stati Uniti orientali viene serializzato e quindi deserializzato nel fuso orario del Pacifico (Stati Uniti), il valore originale di 12:30in 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. viene regolato a 9:30 A.M.is adjusted to 9:30 A.M. per riflettere la differenza tra i due fusi orari.to reflect the difference between the two time zones.

-Se il valore DateTime serializzato rappresenta un'ora non valida nel fuso orario locale.- If the DateTime value that is serialized represents an invalid time in the local time zone. In questo caso, il metodo ToFileTime() regola il valore del DateTime ripristinato in modo che rappresenti un'ora valida nel fuso orario locale.In this case, the ToFileTime() method adjusts the restored DateTime value so that it represents a valid time in the local time zone.

Ad esempio, la transizione dall'ora solare all'ora legale si verifica nel fuso orario del Pacifico (Stati Uniti) il 14 marzo 2010, alle 2:00, quando l'ora avanza di un'ora, alle 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. Questo intervallo di ore è un'ora non valida, ovvero un intervallo di tempo che non esiste in questo fuso orario.This hour interval is an invalid time, that is, a time interval that does not exist in this time zone. Nell'esempio seguente viene illustrato che quando un'ora che rientra in questo intervallo viene convertita in un valore long integer dal metodo ToFileTime() e viene quindi ripristinata dal metodo FromFileTime(Int64), il valore originale viene regolato in modo da diventare un tempo valido.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. È possibile determinare se un determinato valore di data e ora può essere soggetto a modifiche passandolo al metodo IsInvalidTime(DateTime), come illustrato nell'esempio.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]

Si applica a

Vedi anche