DateTime.ToFileTime Metoda

  • Reference

Definice

Obor názvů:
System
Sestavení:
System.Runtime.dll
Sestavení:
netstandard.dll
Sestavení:
mscorlib.dll

převede hodnotu aktuálního DateTime objektu na čas Windows souboru.

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

Návraty

Int64

hodnota aktuálního DateTime objektu vyjádřená jako čas Windows souboru

Výjimky

ArgumentOutOfRangeException

Výsledný čas souboru by představoval datum a čas před 12:00 půlnocí 1. ledna 1601 0001 (UTC).

Příklady

Následující příklad ukazuje ToFileTime metodu.

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

Poznámky

Čas souboru systému Windows je 64bitová hodnota reprezentující počet 100nanosekundových intervalů, které uplynuly od půlnoci (0:00) 1. ledna 1601 n.l. 0001 Koordinovaný světový čas (UTC). Systém Windows používá k záznamu okamžiku, kdy aplikace vytvoří, přistoupí nebo zapíše do souboru, čas souboru.

ToFileTimeMetoda používá Kind vlastnost k určení, zda DateTime je aktuální objekt místní čas, čas UTC nebo nespecifikovaný typ času, který je považován za místní čas.

Poznámky pro volající

FromFileTime(Int64)Metoda obvykle obnoví DateTime hodnotu, která byla uložena ToFileTime() metodou. Tyto dvě hodnoty se ale mohou lišit v následujících podmínkách:

– Pokud dojde k serializaci a deserializaci DateTime hodnoty v různých časových pásmech. Například pokud DateTime hodnota s časem 12:30 ODP. v USA – východ je serializován a pak deserializovat v americkém tichomořském časovém pásmu, původní hodnota je 12:30 hodin. je upraveno na 9:30 dop. aby odrážel rozdíl mezi dvěma časovými pásmy.

– Pokud DateTime hodnota, která je serializovaná, představuje neplatný čas v místním časovém pásmu. V tomto případě ToFileTime() Metoda upraví obnovenou DateTime hodnotu tak, aby představovala platný čas v místním časovém pásmu.

K přechodu ze standardního času na letní čas dojde například v americkém časovém pásmu Tichomoří dne 14. března 2010 ve 2:00 hodiny. V tomto okamžiku dojde k posunutí času o jednu hodinu na 3:00. Tento interval hodin je neplatným časem, to znamená časovým intervalem, který v tomto časovém pásmu neexistuje. Následující příklad ukazuje, že když je čas, který spadá do tohoto rozsahu, převeden na hodnotu typu Long Integer ToFileTime() metodou a pak je obnoven FromFileTime(Int64) metodou, původní hodnota se upraví tak, aby se staly platným časem. Můžete určit, zda konkrétní hodnota data a času může být změněna předáním do IsInvalidTime(DateTime) metody, jak ukazuje příklad.

Platí pro

Viz také