django 1.8 官方文档翻译:9-1-4 格式本地化

简介: 格式本地化概览Django的格式化系统可以在模板中使用当前地区特定的格式,来展示日期、时间和数字。也可以处理表单中输入的本地化。

格式本地化

概览

Django的格式化系统可以在模板中使用当前地区特定的格式,来展示日期、时间和数字。也可以处理表单中输入的本地化。

当它被开启时,访问相同内容的两个用户可能会看到以不同方式格式化的日期、时间和数字,这取决于它们的当前地区的格式。

格式化系统默认是禁用的。需要在你的设置文件中设置USE_L10N = True来启用它。

注意

为了方便起见,django-admin startproject创建的默认的settings.py文件包含了 [USE_L10N = True](../../ref/settings.html#std:setting-USE_L10N) 的设置。但是要注意,要开启千位分隔符的数字格式化,你需要在你的设置文件中设置USE_THOUSAND_SEPARATOR = True。或者,你也可以在你的模板中使用intcomma来格式化数字。

注意

USE_I18N 是另一个独立的并且相关的设置,它控制着Django是否应该开启翻译。详见翻译

表单中的本地化识别输入

格式化开启之后,Django可以在表单中使用本地化格式来解析日期、时间和数字。也就是说,在表单上输入时,它会尝试不同的格式和地区来猜测用户使用的格式。

注意

Django对于展示数据,使用和解析数据不同的格式。尤其是,解析日期的格式不能使用%a(星期名称的缩写),%A (星期名称的全称),%b (月份名称的缩写), %B(月份名称的全称),或者%p(上午/下午)。

只是使用localize参数,就能开启表单字段的本地化输入和输出:

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

在模板中控制本地化

当你使用USE_L10N来开启格式化的时候,Django会尝试使用地区特定的格式,无论值在模板的什么位置输出。

然而,这对于本地化的值不可能总是十分合适,如果你在输出JavaScript或者机器阅读的XML,你会想要使用去本地化的值。你也可能想只在特定的模板中使用本地化,而不是任何位置都使用。

DJango提供了l10n模板库,包含以下标签和过滤器,来实现对本地化的精细控制。

模板标签

localize

在包含的代码块内开启或关闭模板变量的本地化。

这个标签可以对本地化进行比USE_L10N更加精细的操作。

这样做来为一个模板激活或禁用本地化:

{% load l10n %}

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

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

注意

在 {% localize %}代码块内并不遵循f USE_L10N的值。

对于在每个变量基础上执行相同工作的模板过滤器,参见localizeunlocalize

模板过滤器

localize

强制单一值的本地化。

例如:

{% load l10n %}

{{ value|localize }}

使用unlocalize来在单一值上禁用本地化。使用localize 模板标签来在大块的模板区域内控制本地化。

unlocalize

强制单一值不带本地化输出。

例如:

{% load l10n %}

{{ value|unlocalize }}

使用localize来强制单一值的本地化。使用localize模板标签来在大块的模板区域内控制本地化。

创建自定义的格式文件

Django为许多地区提供了格式定义,但是有时你可能想要创建你自己的格式,因为你的的确并没有现成的格式文件,或者你想要覆写其中的一些值。

Changed in Django 1.8:

添加了指定FORMAT_MODULE_PATH为列表的功能。之前只支持单一的字符串值。

指定你首先放置格式文件的位置来使用自定义格式。把你的FORMAT_MODULE_PATH设置设置为格式文件存在的包名来使用它,例如:

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

文件并不直接放在这个目录中,而是放在和地区名称相同的目录中,文件也必须名为formats.py

需要这样一个结构来自定义英文格式:

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

其中formats.py包含自定义的格式定义。例如:

from __future__ import unicode_literals

THOUSAND_SEPARATOR = '\xa0'

使用非间断空格(Unicode 00A0)作为千位分隔符,来代替英语中默认的逗号。

提供本地化格式的限制

一些地区对数字使用上下文敏感的格式,Django的本地化系统不能自动处理它。

瑞士(德语)

瑞士的数字格式化取决于被格式化的数字类型。对于货币值,使用逗号作为千位分隔符,以及使用小数点作为十进制分隔符。对于其它数字,逗号用于十进制分隔符,空格用于千位分隔符。Django提供的本地格式使用通用的分隔符,即逗号用于十进制分隔符,空格用于千位分隔符。

译者:Django 文档协作翻译小组,原文:ocalized Web UI formatting and form input

本文以 CC BY-NC-SA 3.0 协议发布,转载请保留作者署名和文章出处。

Django 文档协作翻译小组人手紧缺,有兴趣的朋友可以加入我们,完全公益性质。交流群:467338606。

相关文章
|
7月前
|
存储 自然语言处理 开发者
Django国际化与本地化
Django提供了强大的国际化和本地化支持,使开发者能够轻松地构建多语言和多地区的Web应用
61 3
|
7月前
|
自然语言处理 中间件 开发者
Django的国际化与本地化支持:打造多语言应用
【4月更文挑战第15天】Django,一款强大的Web框架,内置出色的支持国际化和本地化功能,使得创建多语言应用变得简单。本文介绍了国际化(i18n)与本地化(l10n)的概念,阐述了Django的相应机制,包括标记可翻译字符串、提取与翻译、设置语言和地区、本地化格式处理。遵循文中步骤,开发者能有效构建适应不同语言和地区需求的Web应用,提升用户体验。
|
JSON 数据格式 Python
django drf 案例--实现url编码和json和dict格式转化小工具(涉及定义模型类,序列化器,类视图,路由),接口测试
django drf 案例--实现url编码和json和dict格式转化小工具(涉及定义模型类,序列化器,类视图,路由),接口测试
|
JSON 数据格式 Python
Django响应JsonResponse返回json格式数据报错
Django响应JsonResponse返回json格式数据报错
1079 0
|
JSON 前端开发 数据库
Django 查询数据库返回JSON格式数据
和前端交互全部使用JSON,如何将数据库查询结果转换成JSON格式
|
中间件 Python
django 1.8 官方文档翻译: 3-6-1 中间件概览
Django 文档协作翻译小组人手紧缺,有兴趣的朋友可以加入我们,完全公益性质。 交流群:467338606 网站:http://python.usyiyi.cn/django/index.html 中间件 中间件是一个介入Django的请求和响应的处理过程中的钩子框架。
1057 4
|
Python
django 1.8 官方文档翻译: 4-2-4 人性化
Django 文档协作翻译小组人手紧缺,有兴趣的朋友可以加入我们,完全公益性质。 交流群:467338606 网站:http://python.usyiyi.cn/django/index.html django.contrib.humanize 一系列Django的模板过滤器,有助于向数据添加“人文关怀”。
811 0
|
数据库 Python 开发者
django 1.8 官方文档翻译: 3-4-2 内建显示视图
Django 文档协作翻译小组人手紧缺,有兴趣的朋友可以加入我们,完全公益性质。 交流群:467338606 网站:http://python.usyiyi.cn/django/index.html 基于类的内建通用视图 编写Web应用可能是单调的,因为你需要不断的重复某一种模式。
780 0
|
SQL 测试技术 数据库
django 1.8 官方文档翻译: 2-6-3 提供初始数据
Django 文档协作翻译小组人手紧缺,有兴趣的朋友可以加入我们,完全公益性质。 交流群:467338606 网站:http://python.usyiyi.cn/django/index.html 为模型提供初始数据 当你首次建立一个应用的时候,为你的数据库预先安装一些硬编码的数据,是很有用处的。
1028 0