{"title":"Expressions conditionnelles","version":"1.9","locale":"fr","docname":"ref/models/conditional-expressions","url":"/fr/1.9/ref/models/conditional-expressions/","canonical":"https://djangodocs.dev/fr/1.9/ref/models/conditional-expressions/","summary":"New in Django 1.8 Les expressions conditionnelles permettent d’utiliser de la logique if … elif … else à l’intérieur des filtres, des annotations, des agrégations…","html":"

Expressions conditionnellesLien vers cette rubrique#

\n\n

Les expressions conditionnelles permettent d’utiliser de la logique if … elif … else à l’intérieur des filtres, des annotations, des agrégations et des mises à jour. Une expression conditionnelle évalue une série de conditions pour chaque ligne d’une table et renvoie l’expression résultante correspondante. Les expressions conditionnelles peuvent également être combinées et imbriquées comme toute autre expression.

\n
\n

Les classes d’expressions conditionnellesLien vers cette rubrique#

\n

Nous allons utiliser le modèle suivant dans les exemples qui suivront :

\n
Code
from django.db import models\n\nclass Client(models.Model):\n    REGULAR = 'R'\n    GOLD = 'G'\n    PLATINUM = 'P'\n    ACCOUNT_TYPE_CHOICES = (\n        (REGULAR, 'Regular'),\n        (GOLD, 'Gold'),\n        (PLATINUM, 'Platinum'),\n    )\n    name = models.CharField(max_length=50)\n    registered_on = models.DateField()\n    account_type = models.CharField(\n        max_length=1,\n        choices=ACCOUNT_TYPE_CHOICES,\n        default=REGULAR,\n    )\n
\n
\n

WhenLien vers cette rubrique#

\n
\n
\nclass When(condition=None, then=None, **lookups)Lien vers cette définition#
\n
\n\n

Un objet When() est utilisé pour englober une condition et ses résultats pour leur exploitation dans une expression conditionnelle. L’emploi d’un objet When() est semblable à celui d’une méthode filter(). La condition peut être indiquée en utilisant des objets de recherche de champ ou des objets Q. Le résultat est fourni en utilisant le mot-clé then.

\n

Quelques exemples :

\n
Code
>>> from django.db.models import When, F, Q\n>>> # String arguments refer to fields; the following two examples are equivalent:\n>>> When(account_type=Client.GOLD, then='name')\n>>> When(account_type=Client.GOLD, then=F('name'))\n>>> # You can use field lookups in the condition\n>>> from datetime import date\n>>> When(registered_on__gt=date(2014, 1, 1),\n...      registered_on__lt=date(2015, 1, 1),\n...      then='account_type')\n>>> # Complex conditions can be created using Q objects\n>>> When(Q(name__startswith="John") | Q(name__startswith="Paul"),\n...      then='name')\n
\n

N’oubliez pas que chacune de ces valeurs peut être elle-même une expression.

\n\n
\n
\n

CaseLien vers cette rubrique#

\n
\n
\nclass Case(*cases, **extra)Lien vers cette définition#
\n
\n\n

Une expression Case() est semblable à une instruction if … elif … else en Python. Chaque condition dans les objets When() fournis est évaluée dans l’ordre, jusqu’à ce que l’une d’elle résulte en une valeur vraie. L’expression result de l’objet When() correspondant est renvoyée.

\n

Un exemple simple :

\n
Code
>>>\n>>> from datetime import date, timedelta\n>>> from django.db.models import CharField, Case, Value, When\n>>> Client.objects.create(\n...     name='Jane Doe',\n...     account_type=Client.REGULAR,\n...     registered_on=date.today() - timedelta(days=36))\n>>> Client.objects.create(\n...     name='James Smith',\n...     account_type=Client.GOLD,\n...     registered_on=date.today() - timedelta(days=5))\n>>> Client.objects.create(\n...     name='Jack Black',\n...     account_type=Client.PLATINUM,\n...     registered_on=date.today() - timedelta(days=10 * 365))\n>>> # Get the discount for each Client based on the account type\n>>> Client.objects.annotate(\n...     discount=Case(\n...         When(account_type=Client.GOLD, then=Value('5%')),\n...         When(account_type=Client.PLATINUM, then=Value('10%')),\n...         default=Value('0%'),\n...         output_field=CharField(),\n...     ),\n... ).values_list('name', 'discount')\n[('Jane Doe', '0%'), ('James Smith', '5%'), ('Jack Black', '10%')]\n
\n

Case() accepts any number of When() objects as individual arguments.\nOther options are provided using keyword arguments. If none of the conditions\nevaluate to TRUE, then the expression given with the default keyword\nargument is returned. If a default argument isn’t provided, None is\nused.

\n

Si nous voulions modifier notre requête précédente pour obtenir le rabais sur la base de la fidélité de Client, nous pourrions le faire à l’aide d’expressions de recherche :

\n
Code
>>> a_month_ago = date.today() - timedelta(days=30)\n>>> a_year_ago = date.today() - timedelta(days=365)\n>>> # Get the discount for each Client based on the registration date\n>>> Client.objects.annotate(\n...     discount=Case(\n...         When(registered_on__lte=a_year_ago, then=Value('10%')),\n...         When(registered_on__lte=a_month_ago, then=Value('5%')),\n...         default=Value('0%'),\n...         output_field=CharField(),\n...     )\n... ).values_list('name', 'discount')\n[('Jane Doe', '5%'), ('James Smith', '0%'), ('Jack Black', '10%')]\n
\n\n
\n
\n
\n

Requêtes avancéesLien vers cette rubrique#

\n

Les expressions conditionnelles peuvent être utilisées dans les annotations, les agrégations, les recherches et les mises à jour. Elles peuvent également être combinées et imbriquées avec d’autres expressions. Cela permet d’effectuer des requêtes conditionnelles puissantes.

\n
\n

Mise à jour conditionnelleLien vers cette rubrique#

\n

Admettons que nous voulions modifier le type de compte account_type de nos clients pour qu’il corresponde aux dates d’enregistrement. Nous pouvons le faire à l’aide d’une expression conditionnelle et de la méthode update():

\n
Code
>>> a_month_ago = date.today() - timedelta(days=30)\n>>> a_year_ago = date.today() - timedelta(days=365)\n>>> # Update the account_type for each Client from the registration date\n>>> Client.objects.update(\n...     account_type=Case(\n...         When(registered_on__lte=a_year_ago,\n...              then=Value(Client.PLATINUM)),\n...         When(registered_on__lte=a_month_ago,\n...              then=Value(Client.GOLD)),\n...         default=Value(Client.REGULAR)\n...     ),\n... )\n>>> Client.objects.values_list('name', 'account_type')\n[('Jane Doe', 'G'), ('James Smith', 'R'), ('Jack Black', 'P')]\n
\n
\n
\n

Agrégation conditionnelleLien vers cette rubrique#

\n

Et si nous voulions savoir combien de clients existent pour chaque type de compte ? Nous pouvons imbriquer une expression conditionnelle à l’intérieur de fonctions d’agrégation pour pouvoir faire cela :

\n
Code
>>> # Create some more Clients first so we can have something to count\n>>> Client.objects.create(\n...     name='Jean Grey',\n...     account_type=Client.REGULAR,\n...     registered_on=date.today())\n>>> Client.objects.create(\n...     name='James Bond',\n...     account_type=Client.PLATINUM,\n...     registered_on=date.today())\n>>> Client.objects.create(\n...     name='Jane Porter',\n...     account_type=Client.PLATINUM,\n...     registered_on=date.today())\n>>> # Get counts for each value of account_type\n>>> from django.db.models import IntegerField, Sum\n>>> Client.objects.aggregate(\n...     regular=Sum(\n...         Case(When(account_type=Client.REGULAR, then=1),\n...              output_field=IntegerField())\n...     ),\n...     gold=Sum(\n...         Case(When(account_type=Client.GOLD, then=1),\n...              output_field=IntegerField())\n...     ),\n...     platinum=Sum(\n...         Case(When(account_type=Client.PLATINUM, then=1),\n...              output_field=IntegerField())\n...     )\n... )\n{'regular': 2, 'gold': 1, 'platinum': 3}\n
\n
\n
","rootId":"conditional-expressions","toc":[{"title":"Les classes d’expressions conditionnelles","anchor":"the-conditional-expression-classes","children":[{"title":"When","anchor":"when","children":[]},{"title":"Case","anchor":"case","children":[]}]},{"title":"Requêtes avancées","anchor":"advanced-queries","children":[{"title":"Mise à jour conditionnelle","anchor":"conditional-update","children":[]},{"title":"Agrégation conditionnelle","anchor":"conditional-aggregation","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Référence de l’API","url":"/fr/1.9/ref/"},{"docname":"ref/models/index","title":"Modèles","url":"/fr/1.9/ref/models/"}],"prev":{"docname":"ref/models/expressions","title":"Expressions de requête","url":"/fr/1.9/ref/models/expressions/"},"next":{"docname":"ref/models/database-functions","title":"Fonctions de base de données","url":"/fr/1.9/ref/models/database-functions/"},"formats":{"html":"/fr/1.9/ref/models/conditional-expressions/","markdown":"/fr/1.9/ref/models/conditional-expressions.md","json":"/fr/1.9/ref/models/conditional-expressions.json"},"source":"https://github.com/django/django/blob/stable/1.9.x/docs/ref/models/conditional-expressions.txt","official":"https://docs.djangoproject.com/fr/1.9/ref/models/conditional-expressions/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","fr","ja","id","pt-br","es"]}