12：django 模板 内建过滤器

django 模板 内建过滤器

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是&符号的英文，该过滤器的作用是：用&amp;代表&

 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&amp;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