DateTime.FromFileTime(Int64) 메서드

정의

지정한 Windows 파일 시간을 해당 현지 시간으로 변환합니다.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

매개 변수

fileTime
Int64

틱으로 표현된 Windows 파일 시간입니다.A Windows file time expressed in ticks.

반환

DateTime

fileTime 매개 변수가 나타내는 날짜와 시간에 해당하는 현지 시간을 나타내는 개체입니다.An object that represents the local time equivalent of the date and time represented by the fileTime parameter.

예외

fileTime이 0보다 작거나 MaxValue보다 큰 시간을 나타냅니다.fileTime is less than 0 or represents a time greater than MaxValue.

예제

다음 예제는 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

설명

Windows 파일 시간은 서 기 1601 년 1 월 1 일 자정 12 시 이후 경과한 100 나노초 간격의 수를 나타내는 64 비트 값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. 그레고리오력에서 서 기 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.

fileTime 매개 변수는 100 나노초 틱으로 표현 되는 파일 시간을 지정 합니다.The fileTime parameter specifies a file time expressed in 100-nanosecond ticks.

.NET Framework 버전 2.0부터 반환 값은 Kind 속성이 DateTimeKind.LocalDateTime입니다.Starting with the .NET Framework version 2.0, the return value is a DateTime whose Kind property is DateTimeKind.Local.

호출자 참고

일반적으로 FromFileTime(Int64) 메서드는 ToFileTime() 메서드에 의해 저장 된 DateTime 값을 복원 합니다.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 값의 serialization 및 deserialization이 다른 표준 시간대에서 발생 하는 경우입니다.- If the serialization and deserialization of the DateTime value occur in different time zones. 예를 들어 DateTime 값이 12:30 P.M. 인 경우For example, if a DateTime value with a time of 12:30 P.M. 미국 동부 표준 시간대는로 serialize 된 다음 미국 태평양 표준 시간대에서 deserialize 됩니다. 원래 값은 오후 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 분에 맞게 조정 됩니다.is adjusted to 9:30 A.M. 에 두 표준 시간대 간의 차이 반영 합니다.to reflect the difference between the two time zones.

-Serialize 된 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.

예를 들어 표준 시간에서 일광 절약 시간으로의 전환은 2010 년 3 월 14 일 오전 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. 다음 예제에서는 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-csharp. 날짜/시간. FromFileTime # 1] [! code-vbsystem.object. DateTime. FromFileTime # 1][!code-csharpSystem.DateTime.FromFileTime#1] [!code-vbSystem.DateTime.FromFileTime#1]

적용 대상

추가 정보