.. _ref-contrib-humanize:

========================
django.contrib.humanize
========================

.. module:: django.contrib.humanize
   :synopsis: Un ensemble de filtres de templates propres à Django, utiles pour
			  ajouter une "touche humaine" aux données..

Un ensemble de filtres de templates propres à Django, utiles pour ajouter une
"touche humaine" aux données.

Pour activer ces filtres, ajoutez ``'django.contrib.humanize'``
à votre propriété ``INSTALLED_APPS``. Une fois cela fait, utilisez ``{% load humanize %}``
dans un gabarit, et vous avez alors accès à ces filtres :

apnumber
--------

Pour les nombres allant de 1 à 9, retourne le chiffre épelé. Sinon, retourne
le nombre. Suit le style Associated Press.

Exemples:

    * ``1`` devient ``'one'``.
    * ``2`` devient ``'two'``.
    * ``10`` devient ``10``.

Vous pouvez lui passer un entier ou une chaîne de caractères représentant
un entier.

intcomma
--------

Convertit un entier en une chaîne de caractères contenant des virgules tous
les trois chiffres.

Exemples:

    * ``4500`` devient ``'4,500'``.
    * ``45000`` devient ``'45,000'``.
    * ``450000`` devient ``'450,000'``.
    * ``4500000`` devient ``'4,500,000'``.

Vous pouvez lui passer un entier ou une chaîne de caractères représentant
un entier.

intword
-------

Convertit un entier long en une représentation textuelle compréhensible. Fonctionne
mieux pour les nombres dépassant le million.

Exemples:

    * ``1000000`` devient ``'1.0 million'``.
    * ``1200000`` devient ``'1.2 million'``.
    * ``1200000000`` devient ``'1.2 billion'``.

Les valeurs supérieures à 1000000000000000 (un quatrillion) sont supportées.

Vous pouvez lui passer un entier ou une chaîne de caractères représentant
un entier.

ordinal
-------

Convertit un entier dans sa représentation ordinale sous forme de chaîne
de caractères.

Exemples:

    * ``1`` devient ``'1st'``.
    * ``2`` devient ``'2nd'``.
    * ``3`` devient ``'3rd'``.

Vous pouvez lui passer un entier ou une chaîne de caractères représentant
un entier.

naturalday
----------

.. versionadded:: 1.0

Pour les dates correspondant à la date du jour ou celles à plus ou moins un jour,
retourne la valeur appropriée "today", "tomorrow" ou "yesterday". Sinon, formate
la date en utilisant le format passé en chaîne de caractères.

**Argument:** La chaîne de caractères de formatage des dates telle que décrite
par le tag par défaut :ttag:`now`.

Exemples (si 'today' vaut 17 Feb 2007):

    * ``16 Feb 2007`` devient ``yesterday``.
    * ``17 Feb 2007`` devient ``today``.
    * ``18 Feb 2007`` devient ``tomorrow``.
    * Tout autre date est formatée selon l'argument donné ou le paramètre de
      configuration :setting:`DATE_FORMAT` si aucun n'est fourni.