---
title: "django.contrib.humanize"
version: 3.2
locale: zh-hans
source: https://docs.djangoproject.com/zh-hans/3.2/ref/contrib/humanize/
canonical: https://djangodocs.dev/zh-hans/3.2/ref/contrib/humanize/
---
# `django.contrib.humanize`

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

要激活这些过滤器，请在你的 [`INSTALLED_APPS`](/zh-hans/3.2/ref/settings/#std-setting-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`。

[本地格式化](/zh-hans/3.2/topics/i18n/formatting/) 如果启用，例如使用 `''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）的数值。

[本地格式化](/zh-hans/3.2/topics/i18n/formatting/) 如果启用，例如使用 `''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`](/zh-hans/3.2/ref/templates/builtins/#std-templatefilter-date) 标签所述。

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

- `16 Feb 2007` 变成 `yesterday`。
- `17 Feb 2007` 变成 `today`。
- `18 Feb 2007` 变成 `tomorrow`。
- 任何其他的日子都会根据给定的参数进行格式化，如果没有给定参数，则根据 [`DATE_FORMAT`](/zh-hans/3.2/ref/settings/#std-setting-DATE_FORMAT) 配置。

## `naturaltime`

对于日期时间值，返回一个字符串，代表多少秒、多少分钟或多少小时前 —— 如果值超过一天，则返回到 [`timesince`](/zh-hans/3.2/ref/templates/builtins/#std-templatefilter-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`。

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