FILEDATETIME |
Date/heure du fichier |
|---|---|
| Access 2019, Access 2016, Access 2013, Access 2010, Access 2007, Access 2003, Access XP, Access 2000 | Microsoft Access |
Syntaxe
| FileDateTime(file_path) |
Paramètres
| Nom | Description |
|---|---|
| file_path | Ce paramètre permet d'indiquer le chemin du nom de fichier pour lequel il faut demander la date de création ou de la dernière modification. |
Description
Cette fonction permet de retourner le temps de la création ou de la dernière modification d'un fichier.
Remarques
- La fonction retourne la date et l'heure associées à un fichier : La fonction FileDateTime permet d'obtenir les informations de date et d'heure d'un fichier présent sur le système de fichiers. Le résultat est une valeur de type Date/Heure pouvant être affichée, comparée ou utilisée dans des calculs. Cette fonction est particulièrement utile pour le suivi des documents et des fichiers générés par une application.
- Le paramètre doit contenir un chemin de fichier valide : Le paramètre file_path doit désigner un fichier existant et accessible par l'application. Il peut s'agir d'un chemin absolu ou relatif, selon le répertoire courant de l'application. Si le fichier n'existe pas ou si le chemin est incorrect, Microsoft Access génère une erreur d'exécution.
- La date retournée dépend du système de fichiers : Selon le système de fichiers utilisé (NTFS, FAT32,...) et la version de Windows, la valeur retournée correspond généralement à la date de la dernière modification du fichier. Certaines documentations mentionnent également la date de création, mais en pratique FileDateTime retourne principalement la date de dernière modification. Il est donc préférable de vérifier ce comportement selon le contexte d'utilisation.
- Le résultat est une véritable valeur Date/Heure : La fonction ne retourne pas une simple chaîne de caractères mais une valeur de type Date/Heure. Cette valeur peut être utilisée directement avec des fonctions telles que DateDiff, DateAdd, Year, Month, Day ou Format. Cela facilite les comparaisons entre plusieurs fichiers ou le calcul de leur ancienneté.
- Elle est utile pour vérifier si un fichier a été modifié : FileDateTime permet de savoir rapidement si un fichier a été mis à jour depuis une date donnée. Cette fonctionnalité est très utilisée dans les applications effectuant des importations automatiques, des synchronisations ou des sauvegardes. Elle permet de traiter uniquement les fichiers réellement modifiés.
- Elle peut être utilisée pour contrôler la fraîcheur des données : Dans certaines applications Access, les données sont importées à partir de fichiers externes. En utilisant FileDateTime, il est possible de vérifier si le fichier source est plus récent que la dernière importation. Cette vérification évite des traitements inutiles et améliore les performances de l'application.
- La fonction peut être combinée avec Dir et FileLen : FileDateTime est souvent utilisée avec Dir, vérifiant l'existence d'un fichier, et FileLen, retournant sa taille. Ensemble, ces fonctions permettent d'obtenir rapidement plusieurs informations importantes sur un fichier. Elles sont très utilisées dans les programmes de gestion documentaire et les utilitaires de maintenance.
- Elle génère une erreur si le fichier est introuvable : Contrairement à certaines fonctions qui retournent simplement Null, FileDateTime produit une erreur lorsqu'elle ne peut pas accéder au fichier demandé. Il est donc recommandé d'utiliser Dir ou une gestion d'erreurs (On Error) avant son appel. Cette précaution améliore la robustesse des applications Access.
- Elle est particulièrement utile pour les applications de gestion de fichiers : Les programmes qui manipulent des documents, des images, des rapports ou des sauvegardes utilisent fréquemment FileDateTime pour afficher la date de mise à jour d'un fichier. Cette information peut servir à trier des fichiers, à détecter des versions plus récentes ou à produire des journaux d'activité. La fonction constitue donc un outil important pour la gestion des ressources externes.
- La fonction est compatible avec toutes les versions modernes de Microsoft Access : FileDateTime est disponible depuis les premières versions de Microsoft Access intégrant VBA et son fonctionnement est demeuré stable au fil des années. Elle est compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette stabilité permet aux applications utilisant cette fonction de continuer à fonctionner correctement après une migration vers une version plus récente d'Access.
Exemple
Voici un exemple de comment utiliser la fonction FileDateTime dans Microsoft Access :
FileDateTime ("C:\instructions.doc")
Résultat: 6/1/2004 7:40:18 PM
FileDateTime ("H:\Documents\Supplies.xls")
Résultat: 7/3/2004 3:12:14 PM
Exemple de code VBA
La fonction FileDateTime peut être utilisée dans le code VBA de Microsoft Access.
Par exemple :
Dim LResult As Date
LResult = FileDateTime ("C:\instructions.doc")
Dans cet exemple, la variable appelée LResult contiendrait désormais la date de création ou de dernière modification du fichier instructions.doc.
Dernière mise à jour : Mardi, le 28 juillet 2015