add{{ value|add:"2" }}
对象的加法,如果都是整数类型,简单的算术加法;如果是列表,则是列表的相加
如果无法执行对象的相加,比如整数和字符串,则返回一个空串
addslashes{{value | addslashes}}
在引号前面添加斜线,主要应用与字符转义
capfirst{{value| capfirst}}
首字符大写
center{{value|center:"15"}}
在给定的宽度里面居中
cut{{value|cut:" "}}
删除value里面所有给定的字符,这里是空格
date
根据给定的格式格式化日期
格 式字符 | 描述 | 示例输出 |
---|---|---|
a | ‘a.m.‘ or ‘p.m.‘ | ‘a.m.‘ |
A | ‘AM‘ or ‘PM‘. | ‘AM‘ |
b | 3位小写字符表示的月份缩写 | ‘jan‘ |
d | 每个月中的某一天,两位数字(前缀0) | ‘01‘ to ‘31‘ |
D | 3位字符表示的星期几 | ‘Fri‘ |
e | 时区 | ‘‘, ‘GMT‘, ‘-500‘, ‘US/Eastern‘, etc. |
f | 12小时制的时间,分为零被省略 | ‘1‘, ‘1:30‘ |
F | 月份英文全程 | ‘January‘ |
g | 小时,没有前缀0的12小时制表示 | ‘1‘ to ‘12‘ |
G | 小时,没有前缀0的24小时制表示 | ‘0‘ to ‘23‘ |
h | 小时,有前缀0的12小时制表示 | ‘01‘ to ‘12‘ |
H | 小时,有前缀0的24小时制表示 | ‘00‘ to ‘23‘ |
i | 分钟 | ‘00‘ to ‘59‘ |
j | 每个月中的某一天,数字(没有前缀0) | ‘1‘ to ‘31‘ |
l | 星期几的全称 | ‘Friday‘ |
L | 是否是闰年 | True or False |
m | 月份,有前缀0 | ‘01‘ to ‘12‘ |
M | 月份,3位字符,首字符大写 | ‘Jan‘ |
n | 月份,没有前缀0 | ‘1‘ to ‘12‘ |
P | 时间,12小时制,分钟和上下午,分钟数为0时被省略有midnight和noon | ‘1 a.m.‘, ‘1:30 p.m.‘, ‘midnight‘, ‘noon‘, ‘12:30 p.m.‘ |
s | 秒,有前缀0 | ‘00‘ to ‘59‘ |
S | 月份后缀 | ‘st‘, ‘nd‘, ‘rd‘ or ‘th‘ |
t | 每个月的天数 | 28 to 31 |
T | 本机的时区 | ‘EST‘, ‘MDT‘ |
u | 毫秒. | 0 to 999999 |
w | 0-6表示一周的第几天 | ‘0‘ (Sunday) to ‘6‘ (Saturday) |
W | 一年中的第几个星期 | 1, 53 |
y | 年份,两位 | ‘99‘ |
Y | 年份,4位 | ‘1999‘ |
z | 一年中的第几天 | 0 to 365 |
default{{value|defualt:"nothing"}}
如果value为False,使用default的值
default_if_none{{value|default_if_none:"nothing"}}
如果value为None,使用default的值
dictsort{{value|dictsort:"name"}}
返回使用给出的关键字(实例中的name)对value(要求是字典)进行排序的结果
dictsortreversed
类似dictsort,返回逆序排序的结果
divisibleby{{value|divisiblely:"3"}}
是否能整除,如果是,返回True,否则返回False
escape
转义一个字符串的HTML
注意的是,这个过滤器仅当value输出时转义,所以,当有过滤器串联的时候,escape总像是最后一个过滤器,如果你想要立刻转义的话,请使用force_escape
escapejs{{value|escapejs}}
转义字符成为javascript使用的字符,如:"testing\r\njavascript \‘string" <b>escaping</b>", 会被转义成"testing\\u000D\\u000Ajavascript \\u0027string\\u0022 \\u003Cb\\u003Eescaping\\u003C/b\\u003E".
filesizeformat{{ value|filesizeformat }}
格式化一个数值成为人类可读的文件大小,如果value 是 123456789, 将输出 117.7 MB.
first{{ value|first }}
返回列表的第一个元素
fix_ampersands
ampersands是&符号的英文,该过滤器的作用是:用&代表&
floatformat
不使用参数书,默认输出最多一位有效小数点
34.23234 | {{ value|floatformat }} | 34.2 |
34.00000 | {{ value|floatformat }} | 34 |
34.26000 | {{ value|floatformat }} | 34.3 |
使用正数参数
34.23234 | {{ value|floatformat:3 }} | 34.232 |
34.00000 | {{ value|floatformat:3 }} | 34.000 |
34.26000 | {{ value|floatformat:3 }} | 34.260 |
使用负整数参数
34.23234 | {{ value|floatformat:"-3" }} | 34.232 |
34.00000 | {{ value|floatformat:"-3" }} | 34 |
34.26000 | {{ value|floatformat:"-3" }} | 34.260 |
force_escape
强制转义
get_digit{{ value|get_digit:"2" }}
返回一个整数给定位置的数字,从右往左算
{{ value|get_digit:"2" }},如果value是123456,则返回5
iriencode{{ value|iriencode }}
iri:internationalized resource identifier(国际化资源标识符),iri 编码,把一个iri转成一个可以包含在url中的字符串,例如:如果value是?test=1&me=2,那么输出是?test=1&me=2
join{{ value|join:arg }}
用给定的参数字符拼连一个列表,类似于python的str.join(list)
last{{ value|last }}
返回列表的最后一个元素
length
返回给定值的长度,适用于字符串和列表
length_is{{ value|length_is:"4" }}
如果给定值的长度和length_is的参数一样,返回True,否则返回False
linebreaks{{ value|linebreaks }}
用合适的html替换文本中的换行,例如:Joel\nis a slug会被转<p>Joel<br />is a slug</p>
linebreakbr{{ value|linebreaksbr }}
把文本中所有的换行替换成<br />
linenumbers
显示文本行号
ljust
在给定的宽度里面左对齐
lower
全部转换成小写
make_list
返回被转换成列表的值
pnone2numeric{{ value|phone2numeric }}
把一个电话号码(可能包含字符)转换成对应的数字(字符随便转换),如:800-COLLECT转换成800-2655328
pluralize
返回除了值为1外的该值的复数形式,默认在后面加‘s‘。如果不是‘s‘,或者其他请指定
没有参数是,复数形式加s,有1个参数时,加参数,有两个参数时,分别为单数和复数形式
You have {{ num_cherries }} cherr{{ num_cherries|pluralize:"y,ies" }}.
pprint
一个在pprint.pprint()周围的包装,仅用于debuging
random
返回列表中的随机一项
removetags
从给定的用空格隔开的(X)HTML标签列表删除参数里的标签,例如:{{ value|removetags:"b span" }},如果value是"<b>Joel</b> <button>is</button> a <span>slug</span>,那么输出Joel <button>is</button> a slug,注意这个过滤器是大小写敏感的
rjust
在给定的宽度里面右对齐
safe
标记说该字符串输出的时候不需要自动转义,注意的是,safe后边再接一个escape过滤器时还是会转义的,当safe过滤器在autoescape off里面是也是不起作用的
safeseq
对列表中的每一项使用safe过滤器,例如:{{ some_list|safeseq|join:", " }}
slice
返回一个列表的切片,参数格式和python的列表切片类似
slugify{{ value|slugify }}
转换成小写后,删除所有的非单词字符,最后把空格替换成横线
例如:Joel is a slug会输出joel-is-a-slug
stringformat{{ value|stringformat:"s" }}
字符串格式化,类似于python的字符串格式化(但是没有前导%)
striptags
去掉一切可以去掉的(X)HTML标签,注意的是,striptags并不保证输出的内容安全
time
根据给定的格式格式化时间,参数参考date过滤器
注意,只能接受有关于天的格式,而不是日期 的格式,如果你要格式化日期,请使用date过滤器
timesince{{ blog_date|timesince:comment_date }}
格式化一个日期到给定日期的时间,例如4天,6小时等等,没有参数时默认参数是now,例如:{{ blog_date|timesince:comment_date }},如果blog_date是2006年6月1日的午夜,comment_date是2006年6月1日早上8点,那么这个例子返回的是8小时
分钟是最小的单位,可以返回0分钟这样的结果
timeuntil {{ conference_date|timeuntil:from_date }}
类似timesince,加入from_date是2006年6月22,conference_date是2006年6月29,那么这个例子将返回1个星期
title{ value|title }}
把一个字符串转换成首字母大写,my first post被转为"My First Post
truncatechars
截短字符,例如{{ value|truncatechars:9 }},多于9的字符串会被截短,Joel is a slug会被截短为Joel i...
truncatewords
截短单词,例如{{ value|truncatewords:2 }},第二个单词之后的单词会被截掉,Joel is a slug会变成Joel is ...
truncatewords_html
计算次数是,忽略html标签,比truncatewords更低效率,只应该被用于传递的html
{{ value|truncatewords_html:2 }},<p>Joel is a slug</p>输出为<p>Joel is ...</p>
unordered_list
递归的使用一个自嵌套的列表然后返回一个HTML unordered list(ul),例如,var=[‘States‘, [‘Kansas‘, [‘Lawrence‘, ‘Topeka‘], ‘Illinois‘]],那么{{var|unordered_list}}返回的是:
<li>States <ul> <li>Kansas <ul> <li>Lawrence</li> <li>Topeka</li> </ul> </li> <li>Illinois</li> </ul> </li>
upper
返回大写形式
urlencode{{ value|urlencode }}
转义一个能在url中使用的值,例如,http://www.example.org/foo?a=b&c=d被转成http%3A//www.example.org/foo%3Fa%3Db%26c%3Dd
可以接受参数:参数中表明那些字符不需要转义,如果不提供,/默认不转义,如果提供一个空字符串(不同于包含空格的字符串),所有字符需要被转移
urlize{{ value|urlize }}
转换文本中的url成为可点击的链接,例如:Check out www.djangoproject.com输出为Check out <a href="http://www.djangoproject.com" rel="nofollow">www.djangoproject.com</a>
注意的是,如果文本中包含html,事情可能会有点例外,自己注意
urlizetrunc
先urlize文本,在truncatechars被urlize的文本,例如{{ value|urlizetrunc:15 }},如果value是:Check out www.djangoproject.com,那么输出是:Check out <a href="http://www.djangoproject.com" rel="nofollow">www.djangopr...</a>
wordcount
返回单词的个数
wordwrap
在给定的宽度里面包含单词,例如:{{ value|wordwrap:5 }},如果value是Joel is a slug,那么输出类似是:
Joel is a slug
yesno
匹配值输出yes,no,maybe或者自定义的字符等等,{{ value|yesno:"yeah,no,maybe" }}
p