Format localizationLink to this heading

IkhtisarLink to this heading

Django's formatting system is capable of displaying dates, times and numbers in templates using the format specified for the current locale. It also handles localized input in forms.

Ketika itu diadakan, dua pengguna mengakses isi sama mungkin melihat tanggal, waktu dan ang berbentuk dalam cara berbeda, tergantung pada bentuk untuk lokal saat ini.

Sistem pembentukan ditiadakan secara awalan. Untuk mengadakan itu, itu diperlukan untuk mengatur USE_L10N = True 1 dalam berkas pengaturan anda.

Locale aware input in formsLink to this heading

Ketika pembentukan diadakan, Django menggunakan bentuk lokalisasi ketika mengurai tanggal, waktu dan sejumlah dalam formulir. Itu berarti itu mencoba bentuk berbeda untuk lokal-lokal berbeda ketika menebak bentuk digunakan oleh pengguna ketika memasukkan data pada formulir.

To enable a form field to localize input and output data use its localize argument:

Code
class CashRegisterForm(forms.Form):
   product = forms.CharField()
   revenue = forms.DecimalField(max_digits=4, decimal_places=2, localize=True)

Mengendalikan lokalisasi dalam cetakan-cetakanLink to this heading

Ketika anda mengadakan pembentukan dengan USE_L10N, Django akan mencoba menggunakan bentuk khusus lokal kapanpun itu mengeluarkan sebuah nilai dalam sebuah cetakan.

Bagaimanapun, itu mungkin tidak selalu sesuai untuk menggunakan nilai-nilai lokal -- sebagai contoh, jika anda sedang mengeluarkan JavaScript atau XML yang dirancang untuk menjadi dapat-dibaca-mesin, anda akan selalu ingin nilai-nilai tidak terlokalisasi. Anda mungkin ingin juga menggunakan lokalisasi dalam cetakan-cetakan terpilih, daripada menggunakan lokalisasi dimanapun,

Untuk mengizinkan pengendalian baik terhadap penggunaan lokalisasi, Django menyediakan pustaka cetakan l10n yang mengandung etiket-etiket dan penyaring-penyaring berikut

Etiket cetakanLink to this heading

localizeLink to this heading

Mengadakan atau meniadakan lokalisasi dari variabel-variabel cetakan dalam blok terkandung.

Etiket ini mengizinkan pengendalian berkurai baik dari lokalisasi daripada USE_L10N.

Untuk mengaktifkan atau menonaktifkan lokalisasi untuk sebuah blok cetakan, gunakan:

Code
{% load l10n %}

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

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

Lihat localize dan unlocalize untuk penyaring cetakan yang akan melakukan pekerjaan sama pada dasar per-variabel.

Filter templatLink to this heading

localizeLink to this heading

memaksa lokalisasi pada sebuah nilai tunggal.

Sebagai contoh:

Code
{% load l10n %}

{{ value|localize }}

Untuk meniadakan lokalisasi pada sebuah nilai tunggal, gunakan unlocalize. Untuk mengendalikan lokalisasi terhadap bagian besar dari sebuah cetakan, gunakan etiket cetakan localize.

unlocalizeLink to this heading

Memaksa sebuah nilai tunggal untuk dicetak tanpa lokalisasi.

Sebagai contoh:

Code
{% load l10n %}

{{ value|unlocalize }}

Untuk memaksa lokalisasi pada sebuah nilai tunggal, gunakan localize. Untuk mengendalikan lokalisasi terhadap bagian besar dari sebuah cetakan, gunakan etiket cetakan localize.

Membuat berkas bentuk disesuaikanLink to this heading

Django menyediakan pengertian bentuk untuk banyak lokal-lokal, tetapi terkadang anda mungkin ingin membuat anda sendiri, karena berkas-berkas bentuk tidak ada untuk lokal anda, atau karena anda ingin menimpa beberapa dari nilai-nilai.

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:

Code
FORMAT_MODULE_PATH = [
    'mysite.formats',
    'some_app.formats',
]

Berkas-berkas tidak ditempatkan langsung dalam direktori ini, tetapi dalam sebuah direktori bernama seperti lokal, dan harus dinamai formats.py. Waspadalah tidak menaruh informasi sensitif dalam berkas-berkas ini didalam dapat dikeluarkan jika anda melewatkan string django.utils.formats.get_format() (digunakan oleh penyaring cetakan date).

Untuk menyesuaikan bentuk Inggris, sebuah struktur seperti ini akan diperlukan:

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

Selagi formats.py mengandung pengertian bentuk penyesuaian. Sebagai contoh:

Code
THOUSAND_SEPARATOR = '\xa0'

to use a non-breaking space (Unicode 00A0) as a thousand separator, instead of the default for English, a comma.

Batasan-batasan dari bentuk lokal disediakan.Link to this heading

Some locales use context-sensitive formats for numbers, which Django's localization system cannot handle automatically.

Swis (Jerman)Link to this heading

The Swiss number formatting depends on the type of number that is being formatted. For monetary values, a comma is used as the thousand separator and a decimal point for the decimal separator. For all other numbers, a comma is used as decimal separator and a space as thousand separator. The locale format provided by Django uses the generic separators, a comma for decimal and a space for thousand separators.