{"title":"django.contrib.humanize","version":"6.1","locale":"fr","docname":"ref/contrib/humanize","url":"/fr/6.1/ref/contrib/humanize/","canonical":"https://djangodocs.dev/fr/6.1/ref/contrib/humanize/","summary":"Un ensemble de filtres de gabarits fournis par Django et utiles pour ajouter une « touche humaine » aux données. Pour activer ces filtres, ajoutez…","html":"<span id=\"django-contrib-humanize\"></span><h1><code class=\"docutils literal notranslate\"><span class=\"pre\">django.contrib.humanize</span></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\"><span class=\"pre\">'django.contrib.humanize'</span></code> à votre réglage  <a class=\"reference internal\" href=\"/fr/6.1/ref/settings/#std-setting-INSTALLED_APPS\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">INSTALLED_APPS</span></code></a> . Ensuite, utilisez <code class=\"docutils literal notranslate\"><span class=\"pre\">{%</span> <span class=\"pre\">load</span> <span class=\"pre\">humanize</span> <span class=\"pre\">%}</span></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\"><span class=\"pre\">apnumber</span></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\"><span class=\"pre\">1</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">un</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">2</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">deux</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">10</span></code> reste <code class=\"docutils literal notranslate\"><span class=\"pre\">10</span></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\"><span class=\"pre\">intcomma</span></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\"><span class=\"pre\">4500</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">4,500</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">4500.2</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">4,500.2</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">45000</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">45,000</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">450000</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">450,000</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">4500000</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">4,500,000</span></code>.</p></li>\n</ul>\n<p>La <a class=\"reference internal\" href=\"/fr/6.1/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\"><span class=\"pre\">'fr'</span></code>:</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">45000</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">'45 000'</span></code> (espace insécable au lieu de la virgule).</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">450000</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">'450 000'</span></code>.</p></li>\n</ul>\n</section>\n<section id=\"intword\">\n<span id=\"std-templatefilter-intword\"></span><h2><code class=\"docutils literal notranslate\"><span class=\"pre\">intword</span></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\"><span class=\"pre\">1.0</span></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\"><span class=\"pre\">1000000</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">1.0</span> <span class=\"pre\">million</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">1200000</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">1.2</span> <span class=\"pre\">millions</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">1200000000</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">1.2</span> <span class=\"pre\">milliards</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">-1200000000</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">-1.2</span> <span class=\"pre\">milliards</span></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/6.1/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\"><span class=\"pre\">'fr'</span></code>:</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">1000000</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">'1,0</span> <span class=\"pre\">million'</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">1200000</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">'1,2</span> <span class=\"pre\">millions'</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">1200000000</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">'1,2</span> <span class=\"pre\">milliards'</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">-1200000000</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">'-1,2</span> <span class=\"pre\">Milliarden'</span></code>.</p></li>\n</ul>\n</section>\n<section id=\"naturalday\">\n<span id=\"std-templatefilter-naturalday\"></span><h2><code class=\"docutils literal notranslate\"><span class=\"pre\">naturalday</span></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/6.1/ref/templates/builtins/#std-templatefilter-date\"><code class=\"xref std std-tfilter docutils literal notranslate\"><span class=\"pre\">date</span></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\"><span class=\"pre\">16</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span></code>  devient <code class=\"docutils literal notranslate\"><span class=\"pre\">hier</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">aujourd'hui</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">18</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">demain</span></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/6.1/ref/settings/#std-setting-DATE_FORMAT\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">DATE_FORMAT</span></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\"><span class=\"pre\">naturaltime</span></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/6.1/ref/templates/builtins/#std-templatefilter-timesince\"><code class=\"xref std std-tfilter docutils literal notranslate\"><span class=\"pre\">timesince</span></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\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:30:00</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">maintenant</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:29:31</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">il</span> <span class=\"pre\">y</span> <span class=\"pre\">a</span> <span class=\"pre\">29</span> <span class=\"pre\">secondes</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:29:00</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">il</span> <span class=\"pre\">y</span> <span class=\"pre\">a</span> <span class=\"pre\">une</span> <span class=\"pre\">minute</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:25:35</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">il</span> <span class=\"pre\">y</span> <span class=\"pre\">a</span> <span class=\"pre\">4</span> <span class=\"pre\">minutes</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">15:30:29</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">il</span> <span class=\"pre\">y</span> <span class=\"pre\">a</span> <span class=\"pre\">59</span> <span class=\"pre\">minutes</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">15:30:01</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">il</span> <span class=\"pre\">y</span> <span class=\"pre\">a</span> <span class=\"pre\">59</span> <span class=\"pre\">minutes</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">15:30:00</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">il</span> <span class=\"pre\">y</span> <span class=\"pre\">a</span> <span class=\"pre\">une</span> <span class=\"pre\">heure</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">13:31:29</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">il</span> <span class=\"pre\">y</span> <span class=\"pre\">a</span> <span class=\"pre\">2</span> <span class=\"pre\">heures</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">16</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">13:31:29</span></code> devient « il y a un jour, 2 heures``.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">16</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">13:30:01</span></code> devient « il y a un jour, 2 heures``.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">16</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">13:30:00</span></code> devient « il y a un jour, 3 heures``.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:30:30</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">dans</span> <span class=\"pre\">30</span> <span class=\"pre\">secondes</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:30:29</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">dans</span> <span class=\"pre\">29</span> <span class=\"pre\">secondes</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:31:00</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">dans</span> <span class=\"pre\">une</span> <span class=\"pre\">minute</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:34:35</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">dans</span> <span class=\"pre\">4</span> <span class=\"pre\">minutes</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">17:30:29</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">dans</span> <span class=\"pre\">une</span> <span class=\"pre\">heure</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">17</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">18:31:29</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">dans</span> <span class=\"pre\">2</span> <span class=\"pre\">heures</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">18</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">16:31:29</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">dans</span> <span class=\"pre\">1</span> <span class=\"pre\">jour</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">26</span> <span class=\"pre\">février</span> <span class=\"pre\">2007</span> <span class=\"pre\">18:31:29</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">dans</span> <span class=\"pre\">1</span> <span class=\"pre\">semaine,</span> <span class=\"pre\">2</span> <span class=\"pre\">jours</span></code>.</p></li>\n</ul>\n</section>\n<section id=\"ordinal\">\n<span id=\"std-templatefilter-ordinal\"></span><h2><code class=\"docutils literal notranslate\"><span class=\"pre\">ordinal</span></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\"><span class=\"pre\">1</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">1er</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">2</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">2e</span></code>.</p></li>\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">3</span></code> devient <code class=\"docutils literal notranslate\"><span class=\"pre\">3e</span></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. Les entiers négatifs sont renvoyés inchangés.</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/6.1/ref/"},{"docname":"ref/contrib/index","title":"Paquets contrib","url":"/fr/6.1/ref/contrib/"}],"prev":{"docname":"ref/contrib/gis/deployment","title":"Déploiement de GeoDjango","url":"/fr/6.1/ref/contrib/gis/deployment/"},"next":{"docname":"ref/contrib/messages","title":"L’infrastructure des messages","url":"/fr/6.1/ref/contrib/messages/"},"formats":{"html":"/fr/6.1/ref/contrib/humanize/","markdown":"/fr/6.1/ref/contrib/humanize.md","json":"/fr/6.1/ref/contrib/humanize.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/ref/contrib/humanize.txt","official":"https://docs.djangoproject.com/fr/6.1/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","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}