Le système des formats de Django est capable d’afficher des dates, des heures et des nombres dans les gabarits en utilisant les formats définis pour la langue (locale) active. Il gère également les saisies en formats régionalisés dans les formulaires.
\nLorsqu’il est actif, deux utilisateurs accédant simultanément à un même contenu peuvent voir les dates, les heures et les nombres mis en forme différemment, en fonction des formats de leur langue actuelle.
\nLe système des formats est désactivé par défaut. Pour l’activer, il est nécessaire de définir USE_L10N = True dans votre fichier de réglages.
Lorsque l’utilisation des formats est active, Django peut utiliser des formats régionalisés lorsqu’il reçoit des dates, des heures et des nombres en provenance de formulaires. Cela signifie qu’il essaie différents formats de différentes langues pour deviner le format utilisé par l’utilisateur lors de saisies de données dans un formulaire.
\n\nPour qu’un champ de formulaire utilise des formats régionalisés pour mettre en forme ses données affichées et saisies, utilisez son paramètre localize:
class CashRegisterForm(forms.Form):\n product = forms.CharField()\n revenue = forms.DecimalField(max_digits=4, decimal_places=2, localize=True)\nQuand la mise en forme est activée avec USE_L10N, Django essaie d’utiliser des formats spécifiques à la langue lorsqu’il affiche une valeur dans un gabarit.
Cependant, il n’est pas toujours adéquat d’utiliser des valeurs régionalisées, par exemple si vous produisez du JavaScript ou du XML qui devront être interprétés par le système, ce contenu ne devrait jamais contenir d’affichage régionalisé. Il peut aussi être parfois souhaitable de limiter la régionalisation à certains gabarits, plutôt que de l’utiliser partout.
\nPour permettre un contrôle plus fin sur l’emploi de la régionalisation, Django propose la bibliothèque de gabarit l10n qui contient les balises et filtres suivants.
localizeLien vers cette rubrique#Force la régionalisation d’une seule valeur.
\nPar exemple :
\n{% load l10n %}\n\n{{ value|localize }}\nPour désactiver la régionalisation d’une seule valeur, utilisez unlocalize. Pour contrôler la régionalisation sur toute une section d’un gabarit, utilisez la balise de gabarit localize.
unlocalizeLien vers cette rubrique#Force l’affichage d’une seule valeur sans régionalisation.
\nPar exemple :
\n{% load l10n %}\n\n{{ value|unlocalize }}\nPour forcer la régionalisation d’une seule valeur, utilisez localize. Pour contrôler la régionalisation sur toute une section d’un gabarit, utilisez la balise de gabarit localize.
Renvoie une représentation textuelle et non régionalisée des nombres (int`, float ou Decimal).
Django fournit des définitions de formats pour de nombreuses langues, mais il peut être parfois souhaitable de créer ses propres formats, soit parce qu’il n’existe pas de fichier de formats pour votre langue, soit par ce que vous souhaitez surcharger certaines valeurs.
\nPour utiliser des formats personnalisés, indiquez d’abord le chemin où vous allez placer les fichiers de formats. Pour cela, indiquez dans le réglage FORMAT_MODULE_PATH le chemin du paquet dans lequel seront définis les fichiers de formats ; par exemple :
FORMAT_MODULE_PATH = [\n 'mysite.formats',\n 'some_app.formats',\n]\nLes fichiers ne sont pas placés directement dans ce répertoire, mais dans un répertoire nommé d’après la locale, et doit s’appeler formats.py. Prenez garde de ne pas mettre d’informations sensibles dans ces fichiers car les valeurs contenues pourraient être exposées si la chaîne est passée à django.utils.formats.get_format() (utilisée par le filtre de gabarit date).
Pour personnaliser les formats anglais, voici à quoi ressemblerait la structure nécessaire :
\nmysite/\n formats/\n __init__.py\n en/\n __init__.py\n formats.py\noù formats.py contient les définitions de formats personnalisés. Par exemple :
THOUSAND_SEPARATOR = '\\xa0'\npour utiliser une espace insécable (Unicode 00A0) comme séparateur de milliers au lieu du caractère par défaut qui est la virgule en anglais.
Certaines langues utilisent des formats différents selon le contexte pour les nombres, ce que le système de régionalisation de Django ne sait pas gérer automatiquement.
\nLe système de mise en forme des nombres dépend du type de nombre. Pour les valeurs monétaires, c’est la virgule qui doit être utilisée comme séparateur de milliers et le point décimal comme séparateur décimal. Pour tous les autres nombres, la virgule est utilisée comme séparateur décimal et l’espace comme séparateur de milliers. Le format de langue fournit par Django utilise toujours les séparateurs globaux, une virgule comme séparateur décimal et l’espace comme séparateur de milliers.
\n