DMIN |
Donnée minimal |
|---|---|
| Access 2019, Access 2016, Access 2013, Access 2010, Access 2007, Access 2003, Access XP, Access 2000 | Microsoft Access |
Syntaxe
| DMin(expression,domain, [criteria]) |
Paramètres
| Nom | Description |
|---|---|
| expression | Ce paramètre permet d'indiquer le champ dans lequel vous rechercher la valeur minimum. |
| domain | Ce paramètre permet d'indiquer l'ensemble d'enregistrement correspondant au domaine. |
| criteria | Ce paramètre permet d'indiquer le critère de recherche à appliquer à l'expression. |
Description
Cette fonction permet de retourner la valeur minimal d'un ensemble de données numérique d'un domaine ou d'un ensemble d'enregistrement.
Remarques
- La fonction retourne la plus petite valeur d'un domaine : La fonction DMin permet de rechercher la valeur minimale contenue dans un champ d'une table ou d'une requête. Contrairement à la fonction SQL Min, elle effectue directement la recherche dans le domaine spécifié. Cette fonction est particulièrement utile pour obtenir rapidement une valeur minimale dans un formulaire ou un état.
- Le paramètre domain indique où effectuer la recherche : Le deuxième paramètre correspond au nom de la table ou de la requête contenant les données à analyser. Cette séparation entre le domaine et le formulaire courant permet d'accéder facilement à des informations provenant d'autres sources de données. Il n'est donc pas nécessaire que le champ recherché appartienne à la source de données active.
- Le paramètre criteria permet de limiter les enregistrements analysés : Grâce au paramètre optionnel criteria, il est possible de rechercher la valeur minimale uniquement parmi les enregistrements répondant à certaines conditions. Par exemple, on peut obtenir le salaire minimum d'un département ou le prix le plus bas d'une catégorie de produits. Cette possibilité rend DMin très flexible.
- La fonction peut être utilisée avec différents types de données : Bien qu'elle soit souvent employée avec des nombres, DMin fonctionne également avec des dates et des chaînes de caractères. Dans le cas des dates, elle retourne la plus ancienne date répondant aux critères. Pour les chaînes, elle renvoie la première valeur selon l'ordre alphabétique défini par les règles de tri d'Access.
- Le résultat est retourné sous forme de Variant : La fonction DMin retourne une valeur de type Variant, ce qui lui permet de représenter différents types de données. Si aucun enregistrement ne satisfait les critères spécifiés, le résultat est généralement Null. Il est donc recommandé de tester cette éventualité avant d'utiliser la valeur dans un calcul ou un affichage.
- Elle est très utilisée dans les formulaires et les états : DMin permet d'afficher automatiquement la plus petite valeur disponible dans une table sans créer de requête spécifique. Par exemple, elle peut afficher la date de la première commande d'un client ou le prix minimum d'un article. Cette approche simplifie la création d'interfaces de consultation et de tableaux de bord.
- Elle appartient à la famille des fonctions de domaine : DMin fait partie des fonctions telles que DMax, DAvg, DCount, DSum, DLookup, DFirst et DLast. Toutes ces fonctions permettent d'interroger directement une table ou une requête à partir d'une expression Access. Elles sont particulièrement adaptées aux calculs ponctuels et aux recherches rapides.
- Les critères doivent respecter la syntaxe des expressions Access : Le paramètre criteria est fourni sous forme de chaîne de caractères et doit respecter les conventions de syntaxe d'Access. Les chaînes de texte doivent être placées entre guillemets simples, tandis que les dates sont généralement encadrées par des caractères #. Une erreur de syntaxe dans ce paramètre empêchera la fonction de produire le résultat attendu.
- Une utilisation intensive peut affecter les performances : Chaque appel à DMin entraîne une nouvelle recherche dans la table ou la requête spécifiée. Si la fonction est exécutée un très grand nombre de fois dans une boucle ou pour chaque ligne d'un formulaire continu, les performances peuvent diminuer. Dans ces situations, une requête SQL utilisant MIN() est souvent plus performante.
- La fonction est compatible avec toutes les versions modernes de Microsoft Access : DMin est disponible 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é permet aux applications existantes 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 DMin dans Microsoft Access :
DMin("UnitPrice", "Order Details", "OrderID = 10247")
Dans cet exemple, vous renverriez le prix unitaire minimum de la table Détails de la commande où l'identifiant de commande est 10247. Cela correspond à l'instruction SQL suivante :
SELECT Min([Order Details].UnitPrice) AS MinOfUnitPrice
FROM [Order Details]
WHERE ((([Order Details].OrderID)=10247));
Exemple de code VBA
La fonction DMin peut être utilisée dans le code VBA de Microsoft Access.
Par exemple :
Dim LMin As Currency
LMin = DMin("UnitPrice", "Order Details", "OrderID = 10247")
Dans cet exemple, la variable appelée LMin contiendrait désormais le prix unitaire minimum de la table Détails de la commande où l'identifiant de commande est 10247.
Dernière mise à jour : Mardi, le 28 juillet 2015