13.3 本地化配置
Django6本地化教程：时间日期数字货币格式化与多语言切换
Django6中文学习教程，详细讲解本地化配置，包括时间与日期格式化（如TIME_ZONE、DATE_FORMAT）、数字和货币格式化，以及多语言切换功能实现，适合新手快速上手。
Django6 本地化配置完全指南
引言
本地化是让Web应用适应不同地区和语言的重要功能。Django6内置了强大的本地化支持，帮助您轻松配置时间、日期、数字、货币格式和多语言切换。本教程将详细讲解如何实现这些功能，适合Django新手学习。
第一章：时间与日期格式化
Django中时间与日期的本地化主要通过设置时区和格式来实现。
1. 设置时区 (TIME_ZONE)
在settings.py中，您可以设置项目的时区。Django使用UTC时间，但为了本地化，可以调整时区。
# settings.py
TIME_ZONE = 'Asia/Shanghai' # 设置中国时区
USE_TZ = True # 启用时区支持
TIME_ZONE：指定项目使用的时区，例如亚洲/上海。USE_TZ：设置为True以使用带时区的时间，推荐启用以避免时间错误。
2. 自定义日期和时间格式
Django允许在settings.py中定义日期和时间的显示格式。
# settings.py
DATE_FORMAT = 'Y-m-d' # 日期格式，例如2023-10-01
DATETIME_FORMAT = 'Y-m-d H:i:s' # 日期时间格式
TIME_FORMAT = 'H:i:s' # 时间格式
SHORT_DATE_FORMAT = 'm/d/Y' # 短日期格式，例如10/01/2023
在模板中，可以使用{{ value|date:DATE_FORMAT }}来格式化日期。
3. 在视图中和模板中使用格式化
- 视图中：使用Django的
timezone模块来处理时区。from django.utils import timezone from datetime import datetime current_time = timezone.now() # 获取当前带时区的时间 formatted_time = current_time.strftime('%Y-%m-%d %H:%M:%S') - 模板中：使用内置模板标签。
<!-- 假设context中有date变量 --> <p>日期：{{ date|date:DATE_FORMAT }}</p> <p>时间：{{ date|time:TIME_FORMAT }}</p>
第二章：数字和货币格式化
数字和货币格式化是本地化的重要部分，Django提供了灵活的选项。
1. 数字格式化
在settings.py中，可以配置数字的小数点、千位分隔符等。
# settings.py
USE_L10N = True # 启用本地化，自动应用语言相关的格式
DECIMAL_SEPARATOR = '.' # 小数点分隔符，如1.5
THOUSAND_SEPARATOR = ',' # 千位分隔符，如1,000
NUMBER_GROUPING = 3 # 每3位分组
在模板中，使用{{ value|floatformat }}或{{ value|floatformat:2 }}来控制小数位数。
2. 货币格式化
货币格式化通常与数字格式化和多语言结合。Django没有内置的货币格式化功能，但可以使用第三方库如django-money或手动实现。
- 使用django-money（示例）：
# 安装：pip install django-money # settings.py INSTALLED_APPS = [ ... 'djmoney', ] CURRENCIES = ('USD', 'EUR', 'CNY') # 支持的货币 - 手动格式化：结合本地化设置，在模板中使用条件语句或自定义过滤器。
# 自定义模板过滤器（示例） from django import template import locale register = template.Library() @register.filter def currency_format(value, currency_code='CNY'): locale.setlocale(locale.LC_ALL, 'zh_CN.UTF-8') # 设置为中文环境 return locale.currency(value, symbol=True, grouping=True)
第三章：多语言切换功能实现
Django的多语言支持基于i18n（国际化）和L10n（本地化），让应用可以切换语言。
1. 启用多语言支持
在settings.py中，设置相关配置。
# settings.py
USE_I18N = True # 启用国际化
USE_L10N = True # 启用本地化
LANGUAGES = [
('en', 'English'),
('zh-hans', '简体中文'), # 添加中文支持
]
LANGUAGE_CODE = 'zh-hans' # 默认语言
LOCALE_PATHS = [
os.path.join(BASE_DIR, 'locale'), # 指定翻译文件路径
]
2. 创建翻译文件
- 在项目根目录下创建
locale文件夹。 - 运行命令生成翻译文件：
django-admin makemessages -l zh_Hans # 为简体中文生成.po文件 - 编辑
.po文件，添加翻译，然后编译：django-admin compilemessages # 编译为.mo文件
3. 在代码中使用翻译
- 在Python代码中：使用
gettext或_函数。from django.utils.translation import gettext as _ message = _("Hello, World!") # 可翻译的字符串 - 在模板中：使用
{% trans %}或{% blocktrans %}标签。{% load i18n %} <h1>{% trans "Welcome" %}</h1>
4. 实现语言切换功能
创建语言切换的前端和后端。
- 后端视图：处理语言切换请求。
from django.shortcuts import redirect from django.utils.translation import activate from django.conf import settings def set_language(request, language_code): if language_code in dict(settings.LANGUAGES): activate(language_code) # 激活语言 request.session[settings.LANGUAGE_SESSION_KEY] = language_code return redirect(request.META.get('HTTP_REFERER', '/')) # 返回前一页 - URL配置：添加语言切换的URL。
# urls.py from django.urls import path from .views import set_language urlpatterns = [ path('set_language/<str:language_code>/', set_language, name='set_language'), ] - 前端模板：创建语言选择器。
<form action="{% url 'set_language' %}" method="post"> {% csrf_token %} <select name="language" onchange="this.form.submit()"> {% for code, name in LANGUAGES %} <option value="{{ code }}" {% if LANGUAGE_CODE == code %}selected{% endif %}> {{ name }} </option> {% endfor %} </select> </form>
第四章：完整示例与总结
完整示例项目结构
myproject/
settings.py # 配置本地化设置
urls.py # 添加语言切换URL
views.py # 实现语言切换视图
templates/ # 包含多语言模板
locale/ # 存放翻译文件
总结
Django6的本地化功能强大，通过合理配置settings.py、使用翻译工具和前端切换，可以轻松实现时间、日期、数字、货币格式化和多语言支持。关键点包括：设置TIME_ZONE、DATE_FORMAT等，启用USE_I18N和USE_L10N，创建翻译文件，以及实现语言切换逻辑。实践这些步骤，您的应用将能更好地服务全球用户。
进阶建议
- 使用第三方库如
django-money简化货币处理。 - 定期更新翻译文件以适应语言变化。
- 测试不同时区和语言的显示效果。
本教程希望帮助您快速掌握Django6本地化，如有问题，欢迎查阅Django官方文档或社区资源。