DATEVALUE |
Valeur de la date |
|---|---|
| Access 2019, Access 2016, Access 2013, Access 2010, Access 2007, Access 2003, Access XP, Access 2000 | Microsoft Access |
Syntaxe
| DateValue(string) |
Paramètres
| Nom | Description |
|---|---|
| string | Ce paramètre permet d'indiquer une date sous forme de chaîne de caractères. |
Description
Cette fonction permet de convertir une chaîne de caractères en une date.
Remarques
- Si le paramètre comprend des nombres séparés par des barres obliques (ou d'autres séparateurs de date), alors la fonction DateValue utilisera le format de la date abrégé de la fenêtre pour pour déterminer l'ordre de la composition de l'année, du mois et du jour.
- Si le paramètre n'inclus pas, dans sa composition, l'année de la date, alors la fonction DateValue utilisera l'année courante.
- La fonction convertit une chaîne de caractères en une date : La fonction DateValue permet de transformer une chaîne contenant une date en une véritable valeur de type Date/Heure. Une fois la conversion effectuée, cette valeur peut être utilisée dans des comparaisons, des calculs ou des fonctions de manipulation des dates. Elle est particulièrement utile lorsque les dates proviennent de fichiers texte ou de saisies utilisateur.
- Le paramètre doit représenter une date valide : La chaîne passée en paramètre doit être reconnue comme une date valide par Microsoft Access. Si le texte ne correspond à aucun format de date acceptable, une erreur de conversion est générée. Il est donc recommandé de vérifier la validité de la chaîne avec IsDate avant d'utiliser DateValue.
- Le format de la date dépend des paramètres régionaux : Lorsque la chaîne contient une date numérique comme 01/02/2026, son interprétation dépend du format de date configuré dans Windows. Dans un environnement francophone, cette chaîne sera généralement interprétée comme le 1er février 2026, tandis qu'un système utilisant le format américain pourra y voir le 2 janvier 2026. Cette particularité doit être prise en compte lors de l'importation de données.
- Si l'année est absente, l'année courante est utilisée : Lorsque la chaîne ne contient que le jour et le mois, DateValue complète automatiquement la date avec l'année en cours. Par exemple, si l'année actuelle est 2026, l'appel DateValue("15/08") retournera le 15 août 2026. Ce comportement facilite certaines saisies mais peut également entraîner des erreurs si l'année attendue est différente.
- La fonction ignore la partie heure de la chaîne : Si la chaîne contient une date suivie d'une heure, DateValue ne conserve que la partie correspondant à la date. L'heure est supprimée et la valeur retournée représente minuit (00:00:00). Si l'application doit conserver également l'heure, il est préférable d'utiliser CDate plutôt que DateValue.
- Elle est très utile lors de l'importation de données : Les fichiers CSV, les fichiers texte ou certaines feuilles Excel contiennent souvent les dates sous forme de chaînes de caractères. DateValue permet de convertir rapidement ces informations afin qu'elles deviennent exploitables par Access. Les dates ainsi obtenues peuvent ensuite être triées, filtrées ou utilisées dans des calculs.
- Elle est souvent combinée avec la fonction IsDate : Pour éviter les erreurs de conversion, les développeurs utilisent fréquemment IsDate avant d'appeler DateValue. Cette vérification permet de s'assurer que la chaîne représente bien une date valide. Cette combinaison est particulièrement recommandée lorsque les données proviennent d'une saisie utilisateur ou d'une source externe.
- La fonction est disponible dans les requêtes et dans le code VBA : DateValue peut être utilisée dans les requêtes SQL, les formulaires, les états, les macros et les modules VBA. Cette disponibilité permet d'effectuer directement les conversions dans les expressions Access sans créer de fonction supplémentaire. Son comportement reste identique quel que soit le contexte d'utilisation.
- Elle est souvent utilisée avec d'autres fonctions de manipulation des dates : Une fois la chaîne convertie, le résultat peut être transmis à des fonctions comme DateAdd, DateDiff, DatePart, Year, Month ou Day. Cette combinaison permet de réaliser des traitements calendaires complets à partir d'une simple chaîne de caractères. Elle est très utilisée dans les applications de gestion administrative et commerciale.
- La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction DateValue est présente depuis les premières versions de Microsoft Access et son comportement 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é facilite la migration des applications utilisant cette fonction entre différentes versions d'Access.
Exemple
Voici un exemple de comment utiliser la fonction DATEVALUE dans Microsoft Access :
DateValue ("June 30, 2004")
Résultat: 6/30/2004
DateValue ("6/30/2004")
Résultat: 6/30/2004
DateValue ("June 30")
Résultat: 6/30/2004
Exemple de code VBA
La fonction DateValue peut être utilisée dans le code VBA de Microsoft Access.
Par exemple :
Dim LDate As Date
LDate = DateValue ("May 15, 2003")
Dans cet exemple, la variable appelée LDate contiendrait désormais la valeur du 15/05/2003.
Dernière mise à jour : Mardi, le 28 juillet 2015