{"title":"django.contrib.humanize","version":"5.0","locale":"fr","docname":"ref/contrib/humanize","url":"/fr/5.0/ref/contrib/humanize/","canonical":"https://djangodocs.dev/fr/5.0/ref/contrib/humanize/","summary":"Un ensemble de filtres de gabarits fournis par Django et utiles pour ajouter une « touche humaine » aux données.","html":"<span id=\"django-contrib-humanize\"></span><h1><code class=\"docutils literal notranslate\">django.contrib.humanize</code><a class=\"heading-anchor\" href=\"#module-django.contrib.humanize\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Un ensemble de filtres de gabarits fournis par Django et utiles pour ajouter une « touche humaine » aux données.</p>\n<p>Pour activer ces filtres, ajoutez <code class=\"docutils literal notranslate\">'django.contrib.humanize'</code> à votre réglage  <a class=\"reference internal\" href=\"/fr/5.0/ref/settings/#std-setting-INSTALLED_APPS\"><code class=\"xref std std-setting docutils literal notranslate\">INSTALLED_APPS</code></a> . Ensuite, utilisez <code class=\"docutils literal notranslate\">{% load humanize %}</code> dans un gabarit, et vous aurez accès aux filtres suivants.</p>\n<section id=\"apnumber\">\n<span id=\"std-templatefilter-apnumber\"></span><h2><code class=\"docutils literal notranslate\">apnumber</code><a class=\"heading-anchor\" href=\"#apnumber\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Pour les nombres de 1 à 9, renvoie le nombre écrit en toutes lettres. Sinon, renvoie le nombre lui-même. Cela correspond au style de l’Associated Press.</p>\n<p>Exemples :</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\">1</code> devient <code class=\"docutils literal notranslate\">un</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">2</code> devient <code class=\"docutils literal notranslate\">deux</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">10</code> reste <code class=\"docutils literal notranslate\">10</code>.</p></li>\n</ul>\n<p>Vous pouvez lui passer soit un entier, soit une chaîne de caractères contenant un nombre entier.</p>\n</section>\n<section id=\"intcomma\">\n<span id=\"std-templatefilter-intcomma\"></span><h2><code class=\"docutils literal notranslate\">intcomma</code><a class=\"heading-anchor\" href=\"#intcomma\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Convertit un nombre entier ou à virgule (ou une représentation textuelle d’un de ces nombres) en une chaîne de caractères contenant des virgules tous les trois chiffres.</p>\n<p>Exemples :</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\">4500</code> devient <code class=\"docutils literal notranslate\">4,500</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">4500.2</code> devient <code class=\"docutils literal notranslate\">4,500.2</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">45000</code> devient <code class=\"docutils literal notranslate\">45,000</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">450000</code> devient <code class=\"docutils literal notranslate\">450,000</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">4500000</code> devient <code class=\"docutils literal notranslate\">4,500,000</code>.</p></li>\n</ul>\n<p>La <a class=\"reference internal\" href=\"/fr/5.0/topics/i18n/formatting/\"><span class=\"doc\">Régionalisation des formats</span></a> est respectée si elle est activée, par exemple avec la langue <code class=\"docutils literal notranslate\">'fr'</code>:</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\">45000</code> devient <code class=\"docutils literal notranslate\">'45 000'</code> (espace insécable au lieu de la virgule).</p></li>\n<li><p><code class=\"docutils literal notranslate\">450000</code> devient <code class=\"docutils literal notranslate\">'450 000'</code>.</p></li>\n</ul>\n</section>\n<section id=\"intword\">\n<span id=\"std-templatefilter-intword\"></span><h2><code class=\"docutils literal notranslate\">intword</code><a class=\"heading-anchor\" href=\"#intword\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Convertit un grand nombre entier (ou sa représentation textuelle) en une représentation de texte conviviale. Traduit <code class=\"docutils literal notranslate\">1.0</code> comme phrase au singulier et toutes les autres valeurs numériques comme phrase au pluriel, ce qui n’est pas toujours correct selon les langues. Recommandé pour les nombres au-dessus du million.</p>\n<p>Exemples :</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\">1000000</code> devient <code class=\"docutils literal notranslate\">1.0 million</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">1200000</code> devient <code class=\"docutils literal notranslate\">1.2 millions</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">1200000000</code> devient <code class=\"docutils literal notranslate\">1.2 milliards</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">-1200000000</code> devient <code class=\"docutils literal notranslate\">-1.2 milliards</code>.</p></li>\n</ul>\n<p>Les valeurs allant jusqu’à 10 ^ 100 (googol) sont prises en charge.</p>\n<p>La <a class=\"reference internal\" href=\"/fr/5.0/topics/i18n/formatting/\"><span class=\"doc\">Régionalisation des formats</span></a> est respectée si elle est activée, par exemple avec la langue <code class=\"docutils literal notranslate\">'fr'</code>:</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\">1000000</code> devient <code class=\"docutils literal notranslate\">'1,0 million'</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">1200000</code> devient <code class=\"docutils literal notranslate\">'1,2 millions'</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">1200000000</code> devient <code class=\"docutils literal notranslate\">'1,2 milliards'</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">-1200000000</code> devient <code class=\"docutils literal notranslate\">'-1,2 Milliarden'</code>.</p></li>\n</ul>\n</section>\n<section id=\"naturalday\">\n<span id=\"std-templatefilter-naturalday\"></span><h2><code class=\"docutils literal notranslate\">naturalday</code><a class=\"heading-anchor\" href=\"#naturalday\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Pour les dates qui représentent la journée en cours ou un intervalle de moins d’une journée, renvoie « aujourd’hui », « demain » ou « hier », le cas échéant. Sinon, la date est mise en forme en utilisant le format indiqué.</p>\n<p><strong>Paramètre :</strong> Chaîne de format de date comme pour la balise <a class=\"reference internal\" href=\"/fr/5.0/ref/templates/builtins/#std-templatefilter-date\"><code class=\"xref std std-tfilter docutils literal notranslate\">date</code></a>.</p>\n<p>Exemples (quand « aujourd’hui » est le 17 février 2007) :</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\">16 février 2007</code>  devient <code class=\"docutils literal notranslate\">hier</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">17 février 2007</code> devient <code class=\"docutils literal notranslate\">aujourd'hui</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">18 février 2007</code> devient <code class=\"docutils literal notranslate\">demain</code>.</p></li>\n<li><p>Tout autre jour est mis en forme selon le paramètre donné ou le réglage <a class=\"reference internal\" href=\"/fr/5.0/ref/settings/#std-setting-DATE_FORMAT\"><code class=\"xref std std-setting docutils literal notranslate\">DATE_FORMAT</code></a> si aucun paramètre n’est fourni.</p></li>\n</ul>\n</section>\n<section id=\"naturaltime\">\n<span id=\"std-templatefilter-naturaltime\"></span><h2><code class=\"docutils literal notranslate\">naturaltime</code><a class=\"heading-anchor\" href=\"#naturaltime\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Pour les valeurs de type date/heure, renvoie une chaîne représentant le nombre de secondes, minutes ou heures passées - repassant au format du filtre <a class=\"reference internal\" href=\"/fr/5.0/ref/templates/builtins/#std-templatefilter-timesince\"><code class=\"xref std std-tfilter docutils literal notranslate\">timesince</code></a> si la valeur passée est de plus d’un jour. Au cas où la valeur date/heure est dans le futur, la valeur renvoyée sera automatiquement une phrase appropriée.</p>\n<p>Exemples (quand « maintenant » est le 17 février 2007 16:30:00) :</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\">17 février 2007 16:30:00</code> devient <code class=\"docutils literal notranslate\">maintenant</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">17 février 2007 16:29:31</code> devient <code class=\"docutils literal notranslate\">il y a 29 secondes</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">17 février 2007 16:29:00</code> devient <code class=\"docutils literal notranslate\">il y a une minute</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">17 février 2007 16:25:35</code> devient <code class=\"docutils literal notranslate\">il y a 4 minutes</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">17 février 2007 15:30:29</code> devient <code class=\"docutils literal notranslate\">il y a 59 minutes</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">17 février 2007 15:30:01</code> devient <code class=\"docutils literal notranslate\">il y a 59 minutes</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">17 février 2007 15:30:00</code> devient <code class=\"docutils literal notranslate\">il y a une heure</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">17 février 2007 13:31:29</code> devient <code class=\"docutils literal notranslate\">il y a 2 heures</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">16 février 2007 13:31:29</code> devient « il y a un jour, 2 heures``.</p></li>\n<li><p><code class=\"docutils literal notranslate\">16 février 2007 13:30:01</code> devient « il y a un jour, 2 heures``.</p></li>\n<li><p><code class=\"docutils literal notranslate\">16 février 2007 13:30:00</code> devient « il y a un jour, 3 heures``.</p></li>\n<li><p><code class=\"docutils literal notranslate\">17 février 2007 16:30:30</code> devient <code class=\"docutils literal notranslate\">dans 30 secondes</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">17 février 2007 16:30:29</code> devient <code class=\"docutils literal notranslate\">dans 29 secondes</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">17 février 2007 16:31:00</code> devient <code class=\"docutils literal notranslate\">dans une minute</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">17 février 2007 16:34:35</code> devient <code class=\"docutils literal notranslate\">dans 4 minutes</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">17 février 2007 17:30:29</code> devient <code class=\"docutils literal notranslate\">dans une heure</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">17 février 2007 18:31:29</code> devient <code class=\"docutils literal notranslate\">dans 2 heures</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">18 février 2007 16:31:29</code> devient <code class=\"docutils literal notranslate\">dans 1 jour</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">26 février 2007 18:31:29</code> devient <code class=\"docutils literal notranslate\">dans 1 semaine, 2 jours</code>.</p></li>\n</ul>\n</section>\n<section id=\"ordinal\">\n<span id=\"std-templatefilter-ordinal\"></span><h2><code class=\"docutils literal notranslate\">ordinal</code><a class=\"heading-anchor\" href=\"#ordinal\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Convertit un nombre entier en son nombre ordinal en tant que chaîne de caractères.</p>\n<p>Exemples :</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\">1</code> devient <code class=\"docutils literal notranslate\">1er</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">2</code> devient <code class=\"docutils literal notranslate\">2e</code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\">3</code> devient <code class=\"docutils literal notranslate\">3e</code>.</p></li>\n</ul>\n<p>Vous pouvez lui passer soit un entier, soit une chaîne de caractères contenant un nombre entier.</p>\n</section>","rootId":"module-django.contrib.humanize","toc":[{"title":"apnumber","anchor":"apnumber","children":[]},{"title":"intcomma","anchor":"intcomma","children":[]},{"title":"intword","anchor":"intword","children":[]},{"title":"naturalday","anchor":"naturalday","children":[]},{"title":"naturaltime","anchor":"naturaltime","children":[]},{"title":"ordinal","anchor":"ordinal","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Référence de l’API","url":"/fr/5.0/ref/"},{"docname":"ref/contrib/index","title":"Paquets contrib","url":"/fr/5.0/ref/contrib/"}],"prev":{"docname":"ref/contrib/gis/deployment","title":"Déploiement de GeoDjango","url":"/fr/5.0/ref/contrib/gis/deployment/"},"next":{"docname":"ref/contrib/messages","title":"L’infrastructure des messages","url":"/fr/5.0/ref/contrib/messages/"},"formats":{"html":"/fr/5.0/ref/contrib/humanize/","markdown":"/fr/5.0/ref/contrib/humanize.md","json":"/fr/5.0/ref/contrib/humanize.json"},"source":"https://github.com/django/django/blob/stable/5.0.x/docs/ref/contrib/humanize.txt","official":"https://docs.djangoproject.com/fr/5.0/ref/contrib/humanize/","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","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}