Django 如何在模型中使用 django.contrib.humanize

在本文中，我们将介绍如何在 Django 模型中使用 django.contrib.humanize 库。django.contrib.humanize 是 Django 的一个内置应用程序，提供了一些辅助函数，用于将数据格式化为更易读的形式，例如格式化日期、时间和数字。

阅读更多：Django 教程

1. 安装 django.contrib.humanize

首先，确保 django.contrib.humanize 已经包含在 INSTALLED_APPS 设置中。在 settings.py 文件中确认以下代码：

INSTALLED_APPS = [
    ...
    'django.contrib.humanize',
    ...
]

2. 使用 django.contrib.humanize 的函数

django.contrib.humanize 提供了几个常用的函数，包括 ordinal, intcomma, naturaltime, intword 和 apnumber。接下来我们将详细介绍这些函数的用法及示例。

2.1 ordinal

ordinal 函数用于将数字转换为带有序数后缀的字符串。例如，将数字 1 转换为 “1st”，数字 2 转换为 “2nd”。

示例代码：

from django.contrib.humanize.templatetags.humanize import ordinal

number = 1
ordinal_number = ordinal(number)
print(ordinal_number)  # 1st

2.2 intcomma

intcomma 函数用于将数字的千位分隔符添加到字符串表示形式中。例如，将数字 1000000 转换为 “1,000,000”。

示例代码：

from django.contrib.humanize.templatetags.humanize import intcomma

number = 1000000
formatted_number = intcomma(number)
print(formatted_number)  # 1,000,000

2.3 naturaltime

naturaltime 函数用于将日期或时间转换为更易读的形式，即将日期或时间转换为 “x days ago”、”x minutes ago” 等形式。

示例代码：

from django.contrib.humanize.templatetags.humanize import naturaltime
from django.utils.timezone import now

timestamp = now()
formatted_timestamp = naturaltime(timestamp)
print(formatted_timestamp)  # Moments ago

2.4 intword

intword 函数用于将大数字转换为人类可读的缩写。例如，将数字 1000000 转换为 “1.0 million”。

示例代码：

from django.contrib.humanize.templatetags.humanize import intword

number = 1000000
formatted_number = intword(number)
print(formatted_number)  # 1.0 million

2.5 apnumber

apnumber 函数用于将数字转换为人类可读的缩写形式。例如，将数字 4 转换为 “four”。

示例代码：

from django.contrib.humanize.templatetags.humanize import apnumber

number = 4
formatted_number = apnumber(number)
print(formatted_number)  # four

3. 在模型中使用 django.contrib.humanize

在 Django 模型中使用 django.contrib.humanize 可以使数据更容易理解和显示。例如，我们可以在模型的方法中使用 naturaltime 函数将时间字段转换为更可读的形式。

示例代码：

from django.db import models
from django.contrib.humanize.templatetags.humanize import naturaltime

class Post(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)

    def formatted_time(self):
        return naturaltime(self.created_at)

post = Post.objects.get(pk=1)
formatted_time = post.formatted_time()
print(formatted_time)  # e.g. 2 minutes ago

在上述示例中，我们创建了一个名为 formatted_time 的模型方法，该方法使用了 naturaltime 函数将 created_at 字段转换为更易读的形式。通过调用 formatted_time() 方法，我们可以在模板中获取格式化后的时间。

总结

在本文中，我们学习了如何在 Django 模型中使用 django.contrib.humanize 库。我们详细介绍了其中几个常用函数的用法，并提供了示例代码。通过使用这些函数，我们可以将数据格式化为更易读的形式，并在模型中使用这些函数将数据呈现给用户。通过合理使用 django.contrib.humanize 库，可以提升网站用户体验和可读性。