django.contrib.humanize

一套 Django 模板过滤器，用于为数据添加 “人情味”。

要激活这些过滤器，请在你的 INSTALLED_APPS 配置中添加 'django.contrib.humanize'。添加完毕后，在模板中使用 {% load humanize %}，你就可以使用以下过滤器了。

apnumber

对于数字 1-9，返回拼出的数字。否则，返回数字。这遵循了美联社的风格。

举例：

• 1 变成 one。
• 2 变成 two。
• 10 变成 10。

你可以传入一个整数或整数的字符串表示。

intcomma

将一个整数或浮点数（或其中之一的字符串表示法）转换为每三位数包含逗号的字符串。

举例：

• 4500 变成 4,500。
• 4500.2 变成 4,500.2。
• 45000 变成 45,000。
• 450000 变成 450,000。
• 4500000 变成 4,500,000。

本地格式化 如果启用，例如使用 ''de 语言，将得到尊重：

• 45000 变成 '45.000'。
• 450000 变成 '450.000'。

intword

将大整数（或整数的字符串表示）转换为友好的文本表示。将 1.0 翻译成单数，将所有其他数值翻译成复数，这对某些语言可能不正确。对于 100 万以上的数字效果最好。

举例：

• 1000000 变成 1.0 million。
• 1200000 变成 1.2 million。
• 1200000000 变成 1.2 billion。
• -1200000000 变成 -1.2 billion。

支持最高 10^100（Googol）的数值。

本地格式化 如果启用，例如使用 ''de 语言，将得到尊重：

• 1000000 变成 '1,0 Million'。
• 1200000 变成 '1,2 Millionen'。
• 1200000000 变成 '1,2 Milliarden'。
• -1200000000 变成 '-1,2 Milliarden'。

Changed in Django 3.1:

增加了对负整数的支持。

naturalday

对于当天或一天之内的日期，根据情况返回 “today”、“tomorrow” 或 “yesterday”。否则，使用传入的格式字符串格式化日期。

**参数：**日期格式化字符串，如 date 标签所述。

例子（当 ‘today’ 是 2007 年 2 月 17 日）：

• 16 Feb 2007 变成 yesterday。
• 17 Feb 2007 变成 today。
• 18 Feb 2007 变成 tomorrow。
• 任何其他的日子都会根据给定的参数进行格式化，如果没有给定参数，则根据 DATE_FORMAT 配置。

naturaltime

对于日期时间值，返回一个字符串，代表多少秒、多少分钟或多少小时前 —— 如果值超过一天，则返回到 timesince 格式。如果日期时间值是在未来，返回值将自动使用一个适当的短语。

例子（当 ‘now’ 是 2007 年 2 月 17 日 16:30:00）：

• 17 Feb 2007 16:30:00 变成 now。
• 17 Feb 2007 16:29:31 变成 29 seconds ago。
• 17 Feb 2007 16:29:00 变成 a minute ago。
• 17 Feb 2007 16:25:35 变成 4 minutes ago。
• 17 Feb 2007 15:30:29 变成 59 minutes ago。
• 17 Feb 2007 15:30:01 变成 59 minutes ago。
• 17 Feb 2007 15:30:00 变成 an hour ago。
• 17 Feb 2007 13:31:29 变成 2 hours ago。
• 16 Feb 2007 13:31:29 变成 1 day, 2 hours ago。
• 16 Feb 2007 13:30:01 变成 1 day, 2 hours ago。
• 16 Feb 2007 13:30:00 变成 1 day, 3 hours ago。
• 17 Feb 2007 16:30:30 变成 30 seconds from now。
• 17 Feb 2007 16:30:29 变成 29 seconds from now。
• 17 Feb 2007 16:31:00 变成 a minute from now。
• 17 Feb 2007 16:34:35 变成 4 minutes from now。
• 17 Feb 2007 17:30:29 变成 an hour from now。
• 17 Feb 2007 18:31:29 变成 2 hours from now。
• 18 Feb 2007 16:31:29 变成 1 day from now。
• 26 Feb 2007 18:31:29 变成 1 week, 2 days from now。

ordinal

将一个整数转换为字符串的序数。

举例：

• 1 变成 1st。
• 2 变成 2nd。
• 3 变成 3rd。

你可以传入一个整数或整数的字符串表示。