A função `FileDateTime` em VBA (Visual Basic for Applications) é usada para obter a data e a hora da última modificação de um arquivo. Essa função retorna um valor do tipo `Variant` que representa a data e a hora em que o arquivo especificado foi modificado pela última vez.
Aqui está como usar a função `FileDateTime`:
FileDateTime(pathname As String) As Variant
- Sintaxe:
- `pathname`: Uma expressão do tipo `String` que representa o caminho completo do arquivo, incluindo o nome do arquivo e sua extensão.
- Exemplo de Uso:
Suponha que você tenha um arquivo em “C:Documentosrelatório.xlsx” e deseja saber a data e hora da última modificação desse arquivo. Veja como fazer isso:
Sub ObterDataHoraArquivo()
Dim caminhoArquivo As String
Dim dataHoraModificacao As Variant
caminhoArquivo = "C:Documentosrelatório.xlsx"
dataHoraModificacao = FileDateTime(caminhoArquivo)
MsgBox "O arquivo foi modificado pela última vez em: " & dataHoraModificacao
End Sub
- Considerações:
- Certifique-se de que o caminho do arquivo está correto e que o arquivo realmente existe. Caso contrário, ocorerrá um erro.
- A função `FileDateTime` suporta apenas arquivos locais e não funciona com URLs ou caminhos de rede que não estão mapeados diretamente.
- Dependendo das configurações regionais do sistema, a data e a hora podem ser formatadas de maneira diferente. Para formatar a data/hora em um padrão específico, você pode usar a função `Format`.
Usar a função `FileDateTime` pode ser uma maneira eficiente de controlar alterações em arquivos ou registrar quando um arquivo foi modificado pela última vez durante automações em ambientes que utilizam o VBA.