Directory.GetCreationTime(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém a data e a hora de criação de um diretório.
public:
static DateTime GetCreationTime(System::String ^ path);
public static DateTime GetCreationTime(string path);
static member GetCreationTime : string -> DateTime
Public Shared Function GetCreationTime (path As String) As DateTime
Parâmetros
- path
- String
O caminho do diretório.
Retornos
Uma estrutura definida como a data e a hora de criação do diretório especificado. Esse valor é expresso no horário local.
Exceções
O chamador não tem a permissão necessária.
Versões do .NET Framework e do .NET Core anteriores à 2.1: path é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém um ou mais caracteres inválidos. Você pode consultar caracteres inválidos usando o GetInvalidPathChars() método.
path é null.
O caminho especificado, o nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema.
Exemplos
O exemplo a seguir obtém a hora de criação do diretório especificado.
using System;
using System.IO;
class Test
{
public static void Main()
{
try
{
// Get the creation time of a well-known directory.
DateTime dt = Directory.GetCreationTime(Environment.CurrentDirectory);
// Give feedback to the user.
if (DateTime.Now.Subtract(dt).TotalDays > 364)
{
Console.WriteLine("This directory is over a year old.");
}
else if (DateTime.Now.Subtract(dt).TotalDays > 30)
{
Console.WriteLine("This directory is over a month old.");
}
else if (DateTime.Now.Subtract(dt).TotalDays <= 1)
{
Console.WriteLine("This directory is less than a day old.");
}
else
{
Console.WriteLine("This directory was created on {0}", dt);
}
}
catch (Exception e)
{
Console.WriteLine("The process failed: {0}", e.ToString());
}
}
}
open System
open System.IO
try
// Get the creation time of a well-known directory.
let dt = Directory.GetCreationTime Environment.CurrentDirectory
// Give feedback to the user.
if DateTime.Now.Subtract(dt).TotalDays > 364 then
printfn "This directory is over a year old."
elif DateTime.Now.Subtract(dt).TotalDays > 30 then
printfn "This directory is over a month old."
elif DateTime.Now.Subtract(dt).TotalDays <= 1 then
printfn "This directory is less than a day old."
else
printfn $"This directory was created on {dt}"
with e ->
printfn $"The process failed: {e}"
Imports System.IO
Public Class Test
Public Shared Sub Main()
Try
' Get the creation time of a well-known directory.
Dim dt As DateTime = Directory.GetCreationTime(Environment.CurrentDirectory)
' Give feedback to the user.
If DateTime.Now.Subtract(dt).TotalDays > 364 Then
Console.WriteLine("This directory is over a year old.")
ElseIf DateTime.Now.Subtract(dt).TotalDays > 30 Then
Console.WriteLine("This directory is over a month old.")
ElseIf DateTime.Now.Subtract(dt).TotalDays <= 1 Then
Console.WriteLine("This directory is less than a day old.")
Else
Console.WriteLine("This directory was created on {0}", dt)
End If
Catch e As Exception
Console.WriteLine("The process failed: {0}", e.ToString())
End Try
End Sub
End Class
Comentários
Note
Esse método pode retornar um valor impreciso, pois usa funções nativas cujos valores podem não ser atualizados continuamente pelo sistema operacional.
Esse método é equivalente a File.GetCreationTime.
Se o diretório descrito no path parâmetro não existir, esse método retornará 12:00 meia-noite, 1º de janeiro de 1601 D.C. (C.E.) UTC (Tempo Universal Coordenado), ajustado para hora local.
O path parâmetro tem permissão para especificar informações de caminho relativas ou absolutas. As informações de caminho relativo são interpretadas como relativas ao diretório de trabalho atual. Para obter o diretório de trabalho atual, consulte GetCurrentDirectory.
A confidencialidade de maiúsculas e minúsculas do path parâmetro corresponde à do sistema de arquivos no qual o código está em execução. Por exemplo, não diferencia maiúsculas de minúsculas no NTFS (o sistema de arquivos padrão do Windows) e diferencia maiúsculas de minúsculas em sistemas de arquivos Linux.
Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.