Functions > FileDirDisk >


FileGetTime

Obtient les informations de date et heure d'un fichier.

FileGetTime ( "filename" [, option = 0 [, format = 0]] )

Paramètres

filename Nom du fichier concerné.
option [optionnel] Indique la date à retourner:
    $FT_MODIFIED (0) = Date de dernière modification (par défaut)
    $FT_CREATED (1) = Date de création
    $FT_ACCESSED (2) = Date du dernier accès

Les constantes sont définies dans FileConstants.au3
format [optionnel] Type de retour:
    $FT_ARRAY (0)= Retourne un tableau (par défaut)
    $FT_STRING (1) = Retourne une chaîne AAAAMMJJHHMMSS

Valeur de retour

Succès: Retourne un tableau ou une chaîne qui contient les informations de date du fichier. Voir Remarque.
Échec: Définit @error <> 0.

Remarque

Le tableau est un tableau à une dimension contenant six éléments:
    [0] = année (quatre chiffres)
    [1] = mois (de 01 à 12)
    [2] = jour (de 01 à 31)
    [3] = heure (de 00 à 23)
    [4] = min (de 00 à 59)
    [5] = sec (de 00 à 59)
Notez que les valeurs de retour sont complétées avec des zéros.

En relation

FileGetAttrib, FileGetSize, FileGetVersion, FileSetAttrib, FileSetTime

Exemple

#include <FileConstants.au3>
#include <MsgBoxConstants.au3>
#include <WinAPIFiles.au3>

Example()

Func Example()
    ; Crée une constante locale avec le chemin du fichier qui sera lu/écrit.
    Local Const $sFilePath = _WinAPI_GetTempFileName(@TempDir)

    ; Définit la date de modification du fichier au 1 novembre 2003 et utilise l'heure actuelle.
    Local $iFileSetTime = FileSetTime($sFilePath, "20031101", $FT_MODIFIED)

    ; Affiche la date de modification du fichier et retourne une chaîne au format AAAAMMJJHHMMSS.
    If $iFileSetTime Then
        MsgBox($MB_SYSTEMMODAL, "", "Timestamp:" & @CRLF & FileGetTime($sFilePath, $FT_MODIFIED, 1))
    Else
        MsgBox($MB_SYSTEMMODAL, "", "Une erreur est survenue lors du paramétrage timestamp du fichier.")
    EndIf

    ; Supprime le fichier temporaire.
    FileDelete($sFilePath)
EndFunc   ;==>Example