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.
Two users accessing the same content may see dates, times and numbers formatted in different ways, depending on the formats for their current locale.
Catatan
To enable number formatting with thousand separators, it is necessary to
set USE_THOUSAND_SEPARATOR = True
in
your settings file. Alternatively, you could use intcomma
to
format numbers in your template.
Catatan
There is a related USE_I18N
setting that controls if Django
should activate translation. See Terjemahan for more
details.
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).
To enable a form field to localize input and output data use its localize
argument:
class CashRegisterForm(forms.Form):
product = forms.CharField()
revenue = forms.DecimalField(max_digits=4, decimal_places=2, localize=True)
Django tries to use a locale specific format whenever it outputs a value in a template.
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
localize
¶Mengadakan atau meniadakan lokalisasi dari variabel-variabel cetakan dalam blok terkandung.
To activate or deactivate localization for a template block, use:
{% 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.
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 unlocalized numbers (int
, float
,
or Decimal
).
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.
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",
]
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
).
To customize the English formats, a structure like this would be needed:
mysite/
formats/
__init__.py
en/
__init__.py
formats.py
Selagi formats.py
mengandung pengertian bentuk penyesuaian. Sebagai contoh:
THOUSAND_SEPARATOR = "\xa0"
to use a non-breaking space (Unicode 00A0
) as a thousand separator,
instead of the default for English, a comma.
Some locales use context-sensitive formats for numbers, which Django's localization system cannot handle automatically.
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.
Mei 07, 2024