# Documentation Django 5.2.8

# Régionalisation des formats

## Aperçu

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.

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.

Note

Pour activer le format de nombre avec séparateur de milliers, il est nécessaire de définir `USE_THOUSAND_SEPARATOR = True` dans le fichier des réglages. Il est aussi possible d’utiliser `intcomma` pour mettre en forme les nombres dans votre gabarit.

Note

Il existe un réglage lié nommé `USE_I18N` qui contrôle l’activation ou non des traductions. Voir Traduction pour plus de détails.

## Saisies régionalisées dans les formulaires

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.

Note

Django utilise différents formats pour afficher les données que ceux qu’il utilise pour analyser les données reçues. Plus particulièrement, les formats d’analyse de dates ne peuvent pas utiliser `%a` (jour de la semaine abrégé), `%A` (jour de la semaine complet), `%b` (nom du mois abrégé), `%B` (nom du mois complet) et `%p` (AM/PM).

Pour 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):
        product = forms.CharField()
        revenue = forms.DecimalField(max_digits=4, decimal_places=2, localize=True)

## Contrôle de la régionalisation dans les gabarits

Django tente d’utiliser une format spécifique à la langue active chaque fois qu’il produit 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.

Pour 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.

### Balises de gabarit

#### `localize`

Active ou désactive la régionalisation de variables de gabarits dans le bloc qu’elle définit.

Pour activer ou désactiver la régionalisation pour un bloc de gabarit, utilisez :

    {% load l10n %}

    {% localize on %}
        {{ value }}
    {% endlocalize %}

    {% localize off %}
        {{ value }}
    {% endlocalize %}

Lorsque la régionalisation est désactivée, les formats des réglages de régionalisation sont appliqués.

Voir aussi `localize` et `unlocalize` pour des filtres de gabarit qui font le même travail au niveau des variables.

### Filtres de gabarit

#### `localize`

Force la régionalisation d’une seule valeur.

Par exemple :

    {% load l10n %}

    {{ value|localize }}

Pour 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`.

#### `unlocalize`

Force l’affichage d’une seule valeur sans régionalisation.

Par exemple :

    {% load l10n %}

    {{ value|unlocalize }}

Pour 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 des nombres (`int`, `float` ou `Decimal`) en leur appliquant les formats des réglages de régionalisation.

## Création de fichiers de formats personnalisés

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.

To use custom formats, specify the path where you’ll place format files first. To do that, set your `FORMAT_MODULE_PATH` setting to the package where format files will exist, for instance:

    FORMAT_MODULE_PATH = [
        "mysite.formats",
        "some_app.formats",
    ]

Les 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 :

    mysite/
        formats/
            __init__.py
            en/
                __init__.py
                formats.py

où `formats.py` contient les définitions de formats personnalisés. Par exemple :

    THOUSAND_SEPARATOR = "\xa0"

pour 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.

## Limites des formats de langue fournis

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.

### Suisse (romande et alémanique)

La mise en forme des nombres en Suisse varie traditionnellement selon le contexte. Par exemple, les valeurs monétaires utilisent un point comme séparateur décimal (`Fr. 23.50`), alors que les mesure utilisent normalement une virgule (`22,5 m`). Le système de régionalisation de Django ne prend pas en charge automatiquement ce genre de variations dépendant du contexte.

Le format de locale fournit par Django utilise les séparateurs génériques, une virgule comme séparateur décimal et une espace comme séparateur de milliers.