Django常用内置过滤器
1.add
此过滤器将首先尝试将两个值强制为整数。如果失败,它会尝试将值一起添加。这将工作在一些数据类型(字符串,列表等)和失败在其他人。如果失败,结果将是一个空字符串。
{{ value | add:"1" }} # 如果value等于1,展示效果为2
{{ val1 | add:val2 }} # 如果val1为[1,2],val2为[3,4],展示效果为[1,2,3,4]
2.center
将值置于给定宽度的字段中。
{{ value | center:"7" }} # 如果value为hello,展示效果为" hello "
3.cut
从给定字符串中删除arg的所有值。
{{ value | cut:"a" }} # 如果value为"haha lala",展示效果为"hh ll"
4.date
根据给定的格式设置日期
{{ value | date:"Y-m-d H:i:s" }} # 如果value为时间对象,展示效果为把时间对象格式化为2019-01-17 10:04:25
日期可用格式字符串介绍:
格式字符 |
描述 |
示例输出 |
---|---|---|
a |
|
|
A |
|
|
b |
月,文字,3个字母,小写。 |
|
B |
未实现。 |
|
c |
ISO 8601格式。 (注意:与其他格式化程序,如“Z”,“O”或“r”不同,如果值是一个天真的datetime(见 |
|
d |
月的日期,带前导零的2位数字。 |
|
D |
星期几,文字,3个字母。 |
|
e |
时区名称。可以是任何格式,或可能返回一个空字符串,具体取决于datetime。 |
|
E |
月,特定于语言环境的替代表示,通常用于长日期表示。 |
|
f |
时间,12小时小时和分钟,如果他们为零,分钟将关闭。专有扩展。 |
|
F |
月,文字,长。 |
|
g |
小时,12小时格式,不含前导零。 |
|
G |
小时,24小时格式,无前导零。 |
|
h |
小时,12小时格式。 |
|
H |
小时,24小时格式。 |
|
i |
分钟。 |
|
I |
夏令时,无论是否生效。 |
|
j |
没有前导零的月份日。 |
|
l |
星期几,文字,长。 |
|
L |
是否为闰年的布尔值。 |
|
m |
月,2位数字,前导零。 |
|
M |
月,文字,3个字母。 |
|
n |
没有前导零的月。 |
|
N |
月缩写在Associated Press风格。专有扩展。 |
|
o |
ISO-8601周编号年,对应于使用闰年的ISO-8601周编号(W)。更常见的年份格式见Y。 |
|
O |
与格林威治时间的差值(以小时为单位)。 |
|
P |
时间,12小时制,分钟和’a.m。’/’p.m。’,如果它们为零,分钟将关闭,如果合适,分钟将保留特殊字符串’午夜’和’中午’。专有扩展。 |
|
r |
RFC 5322 格式的日期。 |
|
s |
秒,带前导零的2位数。 |
|
S |
每月日期的英文序数后缀,2个字符。 |
|
t |
指定月份的天数。 |
|
T |
本机的时区。 |
|
u |
微秒。 |
|
U |
自Unix时代以来的秒数(1970年1月1日00:00:00 UTC)。 |
|
w |
星期几,没有前导零的数字。 |
|
W |
ISO-8601年的周数,周从星期一开始。 |
|
y |
年,2位数。 |
|
Y |
年,4位数。 |
|
z |
一年中的一天。 |
|
Z |
时区偏移(以秒为单位)。 UTC之前的时区的偏移总是负的,并且对于UTC的东部的偏移总是正的。 |
|
5.default
如果值的计算结果为 False
,则使用给定的默认值。否则,使用该值。
{{ value | defult:"Nothing at all" }} # 如果value是""(空字符串),展示后面的默认值"Nothing at all",否则展示value的值
6.default_if_none
如果(且只有)值是 None
,使用给定的默认值。否则,使用该值。
注意,如果给出一个空字符串,默认值将使用 not。如果要回退空字符串,请使用 default过滤器
{{ value | default_if_none:"nothing" }} # 如果 value 是 None,则展示字符串 "nothing",否则展示value的值
7.dictsort
获取字典列表,并返回该列表按参数中给出的键排序。
{{ value | dictsort:"name" }}
# 如果value是:
[
{'name': 'zed', 'age': 19},
{'name': 'amy', 'age': 22},
{'name': 'joe', 'age': 31},
]
# 输出结果:
[
{'name': 'amy', 'age': 22},
{'name': 'joe', 'age': 31},
{'name': 'zed', 'age': 19},
]
dictsort
还可以通过指定索引处的元素来排序列表(或任何其他实现 __getitem__()
的对象)的列表。
{{ value | dictsort:0 }} # 这里0作为索引必须是整数不是字符串
# 如果 value 是:
[
('a', '42'),
('c', 'string'),
('b', 'foo'),
]
# 那么输出将是:
[
('a', '42'),
('b', 'foo'),
('c', 'string'),
]
8.dictsortreversed
获取字典列表,并返回按照参数中给出的键按相反顺序排序的列表。这与上面的过滤器完全相同,但返回的值将是相反的顺序。
9.fileseizeformat
将该值格式化为“人类可读”文件大小(即 '13 KB'
,'4.1 MB'
,'102 bytes'
等)。
{{ value | filesizeformat }} # 如果 value 是123456789,则展示的是 117.7 MB
文件大小和SI单位
严格地说,filesizeformat
不符合国际单位制度,其建议使用KiB,MiB,GiB等,当字节大小以1024的幂(这是这里的情况)计算时。相反,Django使用对应于更常用名称的传统单位名称(KB,MB,GB等)。
10.floatformat
当不带参数时,将一个浮点数舍入到小数点后一位,但前提是要显示一个小数部分。例如:
|
模板 |
输出 |
---|---|---|
|
|
|
|
|
|
|
|
|
如果与数字整数参数一起使用,则 floatformat
将数字四舍五入到该小数位数。例如:
|
模板 |
输出 |
---|---|---|
|
|
|
|
|
|
|
|
|
特别有用的是传递0(零)作为参数,它将使float浮动到最接近的整数。
|
模板 |
输出 |
---|---|---|
|
|
|
|
|
|
|
|
|
如果传递给 floatformat
的参数为负,则它将一个数字四舍五入到这个小数位,但前提是要显示一个小数部分。例如:
|
模板 |
输出 |
---|---|---|
|
|
|
|
|
|
|
|
|
使用没有参数的 floatformat
等同于使用具有 -1
参数的 floatformat
。
11.join
使用字符串连接列表,如Python的 str.join(list)
{{ value | join:" // " }} # 如果 value 是列表 ['a', 'b', 'c'],则展示的是字符串 "a // b // c"
12.length
返回值的长度。这适用于字符串和列表
{{ value | length }} # 如果 value 是 ['a', 'b', 'c', 'd'] 或 "abcd",展示的是4,过滤器为未定义的变量返回 0
13.lower
将字符串转换为全部小写
{{ value | lower }} # 如果value是"Hello"则展示的是"hello"
14.upper
将字符串转换为全大写
{{ value | upper }} # 如果 value 是"hello",展示的是"HELLO"
15.make_list
返回转换为列表的值。对于字符串,它是一个字符列表。对于整数,在创建列表之前将参数强制转换为unicode字符串
{{ value | make_list }} # 如果value是字符串"la",展示的就是列表["l", "a"],如果value是数12,展示的就是列表[1, 2]
16.random
返回给定列表中的随机项
{{ value|random }} # 如果value的值为[1, 2 , 3],展示的可能就是2,列表随机取
17.truncatechars
如果长度大于指定的字符数,则截断字符串。截断的字符串将以可翻译的省略号序列(“...”)结束
{{ value | truncatechars:2 }} # 如果value是"hello",那么展示的就是"he..."
18.truncatewords
在一定数量的字后截断字符串
{{ value | truncatewords:2 }} # 如果value的值是"gmx is pig",展示的就是"gmx is ..."
19.wordcount
返回字数
{{ value | wordcount }} # 如果value是"gmx is pig",展示的就是3
详情参考链接https://docs.djangoproject.com/en/1.7/ref/templates/builtins/