Bentuk lokalisasi

Ikhtisar

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.

Dua pengguna mengakses isi sama mungkin melihat tanggal, waktu dan angka berbentuk dalam cara berbeda, bergantung pada bentuk untuk lokal saat ini mereka.

Catatan

Untuk mengadakan pembentukan angka dengan pemisah ribuan, diperlukan untuk menyetel USE_THOUSAND_SEPARATOR = True Dalam berkas setelan. Cara lain, anda dapat menggunakan intcomma untuk membentuk angka dalam cetakan anda.

Catatan

There is a related USE_I18N setting that controls if Django should activate translation. See Terjemahan for more details.

Masukan sadar lokal dalam formulir

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.

Catatan

Django menggunakan bentuk-bentuk berbeda untuk menampilkan data pada itu digunakan untuk mengurai data. Kebanyakan terutama, bentuk-bentuk untuk mengurai tanggal tidak dapat menggunakan %a (nama hari kerja disingkat), %A (nama hari kerja penuh), %b (nama bulan disingkat), %B (nama bulan penuh), atau %p (AM/PM).

Untuk mengadakan bidang formulir untuk melokalkan masukan dan keluaran data menggunakan argumen localize nya:

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

Mengendalikan lokalisasi dalam cetakan-cetakan

Django mencoba menggunakan format spesifik lokal ketika itu mengeluarkan nilai dalam 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 cetakan

localize

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

Untuk mengaktivasi atau menonaktifvasi lokalisasi untuk blok cetakan, gunakan:

{% load l10n %}

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

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

When localization is disabled, the localization settings formats are applied.

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

Filter templat

localize

memaksa lokalisasi pada sebuah nilai tunggal.

Sebagai contoh:

{% 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.

unlocalize

Memaksa sebuah nilai tunggal untuk dicetak tanpa lokalisasi.

Sebagai contoh:

{% 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.

Returns a string representation for numbers (int, float, or Decimal) with the localization settings formats applied.

Membuat berkas bentuk disesuaikan

Django provides format definitions for many locales, but sometimes you might want to create your own, because a format file doesn't exist for your locale, or because you want to overwrite some of the values.

Untuk menggunakan bentuk disesuaikan, tentukan jalur dimana anda akan menempatkan berkas bentuk dahulu, setel pengaturan FORMAT_MODULE_PATH ke paket dimana berkas akan ada, contohnya:

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, struktur seperti ini akan diperlukan:

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

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

THOUSAND_SEPARATOR = "\xa0"

untuk menggunakan ruang tanpa-berhenti (Unicode 00A0) sebagai pemisah ribuan, bukannya awalan untuk Inggris, sebuah koma.

Batasan-batasan dari bentuk lokal disediakan.

Beberapa lokal menggunakan bentuk konteks-sensitif untuk angka, dimana sistem lokalisasi Django tidak dapat ditangani otomatis.

Swis (Jerman)

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.