Partition, fonction
Renvoie Variant (String) qui indique dans quelle plage se trouve un nombre dans une série calculée de plages.
Syntaxe
Partition(nombre, début, arrêt, intervalle)
La syntaxe de la fonction Partition comporte les arguments nommés suivants :
| Élément | Description |
|---|---|
| number | Obligatoire. Nombre que vous souhaitez évaluer par rapport aux plages. |
| start | Obligatoire. Nombre qui est le début de la plage globale de nombres. Ne peut pas être inférieur à 0. |
| stop | Obligatoire. Nombre qui correspond à la fin de la plage globale de nombres. Ne peut pas être égal ou inférieur à start. |
| interval | Obligatoire. Nombre qui est la différence entre une plage et la suivante. Le nombre ne peut pas être inférieur à 1. |
Remarques
La fonction Partition identifie la plage à laquelle appartient number et renvoie une variable de type Variant (String) qui décrit cette plage. La fonction Partition est très utile dans les requêtes. Vous pouvez créer une requête de sélection qui indique combien de commandes appartiennent à différentes plages, par exemple, les valeurs de commande de 1 à 1 000, de 1 001 à 2 000, etc.
Le tableau suivant indique comment les plages sont déterminées en utilisant trois groupes d’éléments, start, end et interval. Les colonnes Première plage et Dernière plage indiquent les valeurs renvoyées par Partition. Les plages sont représentées par lowervalue: uppervalue, où l’extrémité inférieure (lowervalue) de la plage est séparée de l’extrémité supérieure (uppervalue) de la plage avec deux-points (:).
| start | stop | interval | Avant la première valeur | Première plage | Dernière plage | Après la dernière valeur |
|---|---|---|---|---|---|---|
| 0 | 99 | 5 | " :-1" | " 0: 4" | " 95: 99" | " 100: " |
| 20 | 199 | 10 | " : 19" | " 20: 29" | " 190: 199" | " 200: " |
| 100 | 1010 | 20 | " : 99" | " 100: 119" | " 1000: 1010" | " 1011: " |
Dans le tableau ci-dessus, la troisième ligne affiche le résultat lorsque le début et l’arrêt définissent un ensemble de nombres qui ne peuvent pas être divisés uniformément par intervalle. La dernière plage s’étend jusqu’à end (11 nombres) même si interval est égal à 20.
Au besoin, Partition renvoie une plage avec un nombre suffisant d’espaces de début pour que le nombre de caractères à gauche et à droite du signe deux-points soit le même que celui dans end, plus un. Ainsi, si vous utilisez Partition avec d’autres nombres, le texte obtenu sera géré correctement lors des opérations de tri ultérieures.
Si interval est égal à 1, la plage est number:number, indépendamment des arguments start et end. Par exemple, si interval est égal à 1, number est égal à 100 et end est égal à 1 000, Partition renvoie " 100: 100".
N’importe quel argument peut être une valeur décimale, mais il est arrondi à l’entier pair le plus proche avant le traitement. Si l’un des arguments a la valeur Null, Partition retourne une valeur Null.
Exemple
Cet exemple suppose que vous disposez d’une table Orders qui contient un champ Freight. Il crée une procédure de sélection qui compte le nombre de commandes avec des coûts de transport qui appartiennent à chacune de ces plages. La fonction Partition est d’abord utilisée pour établir ces plages, puis la fonction NOMBRE SQL compte le nombre de commandes dans chaque plage.
Dans cet exemple, les arguments de la fonction Partition sont start = 0, end = 500, interval = 50. La première plage sera donc 0:49, et ainsi de suite jusqu’à 500.
SELECT DISTINCTROW Partition([freight],0, 500, 50) AS Range,
Count(Orders.Freight) AS Count
FROM Orders
GROUP BY Partition([freight],0,500,50);
Voir aussi
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.