作用:

Django过滤器的作用是对管道符 ‘|’前面的变量进行修饰 然后在页面中显示修饰后的结果

语法:

{{变量名|filter_name:参数}}

 

 

注意事项:

  1. 过滤器支持“链式”操作。即一个过滤器的输出作为另一个过滤器的输入。
  2. 过滤器可以接受参数,例如:{{ sss|truncatewords:30 }},这将显示sss的前30个词。
  3. 过滤器参数包含空格的话,必须用引号包裹起来。比如使用逗号和空格去连接一个列表中的元素,如:{{ list|join:', ' }}
  4. '|'左右没有空格没有空格没有空格

内置过滤器:

 

一、形式:小写 {{ name | lower }}
二、串联:先转义文本到HTML,再转换每行到 <p> 标签 {{ my_text|escape|linebreaks }}
三、过滤器的参数 显示前30个字 {{ bio | truncatewords:"30" }}
格式化 {{ pub_date | date:"F j, Y" }}
 
过滤器列表 
{{ 123|add:"5" }} 给value加上一个数值 
{{ "AB'CD"|addslashes }} 单引号加上转义号,一般用于输出到javascript中
 {{ "abcd"|capfirst }} 第一个字母大写 
{{ "abcd"|center:"50" }} 输出指定长度的字符串,并把值对中 
{{ "123spam456spam789"|cut:"spam" }} 查找删除指定字符串 
{{ value|date:"F j, Y" }} 格式化日期 
{{ value|default:"(N/A)" }} 值不存在,使用指定值
 {{ value|default_if_none:"(N/A)" }} 值是None,使用指定值 
{{ 列表变量|dictsort:"数字" }} 排序从小到大 
{{ 列表变量|dictsortreversed:"数字" }} 排序从大到小 
{% if 92|divisibleby:"2" %} 判断是否整除指定数字
 
{{ string|escape }} 转换为html实体
 {{ 21984124|filesizeformat }} 以1024为基数,计算最大值,保留1位小数,增加可读性 
{{ list|first }} 返回列表第一个元素 
{{ "ik23hr&jqwh"|fix_ampersands }} &转为& 
{{ 13.414121241|floatformat }} 保留1位小数,可为负数,几种形式
 {{ 13.414121241|floatformat:"2" }} 保留2位小数
 {{ 23456 |get_digit:"1" }} 从个位数开始截取指定位置的1个数字
 
{{ list|join:", " }} 用指定分隔符连接列表
{{ list|length }} 返回列表个数
 {% if 列表|length_is:"3" %} 列表个数是否指定数值
 {{ "ABCD"|linebreaks }} 用新行用<p> 、 <br /> 标记包裹 
{{ "ABCD"|linebreaksbr }} 用新行用<br /> 标记包裹 
{{ 变量|linenumbers }} 为变量中每一行加上行号 
{{ "abcd"|ljust:"50" }} 把字符串在指定宽度中对左,其它用空格填充
 
{{ "ABCD"|lower }} 小写 
{% for i in "1abc1"|make_list %}ABCDE,{% endfor %} 把字符串或数字的字符个数作为一个列表
 {{ "abcdefghijklmnopqrstuvwxyz"|phone2numeric }} 把字符转为可以对应的数字??
 {{ 列表或数字|pluralize }} 单词的复数形式,如列表字符串个数大于1,返回s,否则返回空串
 
{{ 列表或数字|pluralize:"es" }} 指定es 
{{ 列表或数字|pluralize:"y,ies" }} 指定ies替换为y 
{{ object|pprint }} 显示一个对象的值
 {{ 列表|random }} 返回列表的随机一项 
{{ string|removetags:"br p div" }} 删除字符串中指定html标记
 {{ string|rjust:"50" }} 把字符串在指定宽度中对右,其它用空格填充
 
{{ 列表|slice:":2" }} 切片 
{{ string|slugify }} 字符串中留下减号和下划线,其它符号删除,空格用减号替换
 {{ 3|stringformat:"02i" }} 字符串格式,使用Python的字符串格式语法
 {{ "E<A>A</A>B<C>C</C>D"|striptags }} 剥去[X]HTML语法标记 
{{ 时间变量|time:"P" }} 日期的时间部分格式 
{{ datetime|timesince }} 给定日期到现在过去了多少时间
 {{ datetime|timesince:"other_datetime" }} 两日期间过去了多少时间
 
{{ datetime|timeuntil }} 给定日期到现在过去了多少时间,与上面的区别在于2日期的前后位置。
 {{ datetime|timeuntil:"other_datetime" }} 两日期间过去了多少时间
 {{ "abdsadf"|title }} 首字母大写 
{{ "A B C D E F"|truncatewords:"3" }} 截取指定个数的单词 
{{ "<a>1<a>1<a>1</a></a></a>22<a>1</a>"|truncatewords_html:"2" }} 截取指定个数的html标记,并补完整 
<ul>{{ list|unordered_list }}</ul> 多重嵌套列表展现为html的无序列表
 
{{ string|upper }} 全部大写 
<a href="{{ link|urlencode }}">linkage</a> url编码 
{{ string|urlize }} 将URLs由纯文本变为可点击的链接。(没有实验成功)
 {{ string|urlizetrunc:"30" }} 同上,多个截取字符数。(同样没有实验成功)
 
{{ "B C D E F"|wordcount }} 单词数 
{{ "a b c d e f g h i j k"|wordwrap:"5" }} 每指定数量的字符就插入回车符
 {{ boolean|yesno:"Yes,No,Perhaps" }} 对三种值的返回字符串,对应是 非空,空,None
 
日起格式化 
{{ pub_date | date:"F j, Y" }}

日期格式化参数

格式化字符

描述

示例输出

a

'a.m.''p.m.'(请注意,这与PHP的输出略有不同,因为这包括符合Associated Press风格的期间)

'a.m.'

A

'AM''PM'

'AM'

b

月,文字,3个字母,小写。

'jan'

B

未实现。

 

c

ISO 8601格式。 (注意:与其他格式化程序不同,例如“Z”,“O”或“r”,如果值为naive datetime,则“c”格式化程序不会添加时区偏移量(请参阅datetime.tzinfo) 。

2008-01-02T10:30:00.000123+02:002008-01-02T10:30:00.000123如果datetime是天真的

d

月的日子,带前导零的2位数字。

'01''31'

D

一周中的文字,3个字母。

“星期五”

e

时区名称 可能是任何格式,或者可能返回一个空字符串,具体取决于datetime。

'''GMT''-500''US/Eastern'

E

月份,特定地区的替代表示通常用于长日期表示。

'listopada'(对于波兰语区域,而不是'Listopad'

f

时间,在12小时的小时和分钟内,如果它们为零,则分钟停留。 专有扩展。

'1''1:30'

F

月,文,长。

'一月'

g

小时,12小时格式,无前导零。

'1''12'

G

小时,24小时格式,无前导零。

'0''23'

h

小时,12小时格式。

'01''12'

H

小时,24小时格式。

'00''23'

i

分钟。

'00''59'

I

夏令时间,无论是否生效。

'1''0'

j

没有前导零的月份的日子。

'1''31'

l

星期几,文字长。

'星期五'

L

布尔值是否是一个闰年。

TrueFalse

m

月,2位数字带前导零。

'01''12'

M

月,文字,3个字母。

“扬”

n

月无前导零。

'1''12'

N

美联社风格的月份缩写。 专有扩展。

'Jan.''Feb.''March''May'

o

ISO-8601周编号,对应于使用闰年的ISO-8601周数(W)。 对于更常见的年份格式,请参见Y。

'1999年'

O

与格林威治时间的差异在几小时内。

'+0200'

P

时间为12小时,分钟和'a.m。'/'p.m。',如果为零,分钟停留,特殊情况下的字符串“午夜”和“中午”。 专有扩展。

'1 am''1:30 pm' / t3>,'midnight','noon','12:30 pm' / T10>

r

RFC 5322格式化日期。

'Thu, 21 Dec 2000 16:01:07 +0200'

s

秒,带前导零的2位数字。

'00''59'

S

一个月的英文序数后缀,2个字符。

'st''nd''rd''th'

t

给定月份的天数。

28 to 31

T

本机的时区。

'EST''MDT'

u

微秒。

000000 to 999999

U

自Unix Epoch以来的二分之一(1970年1月1日00:00:00 UTC)。

 

w

星期几,数字无前导零。

'0'(星期日)至'6'(星期六)

W

ISO-8601周数,周数从星期一开始。

153

y

年份,2位数字。

'99'

Y

年,4位数。

'1999年'

z

一年中的日子

0365

Z

时区偏移量,单位为秒。 UTC以西时区的偏移量总是为负数,对于UTC以东时,它们总是为正。

-4320043200

 

 

 

自定义过滤器:

因为内置过滤器满足不了我们,所以需要自定义过滤器,只需要遵循Django的规则创建即可

 

自定义filter的创建及使用:

创建:

  1.在app目录下创建templatetags的package包

  2.然后在templatetags下创建一个python文件:my_filters.py

  3.在py文件内写函数:def filter_name(value,arg):     # value参数是管道符前面需要修改的变量,arg是过滤器的‘:’后面的参数

  4.导入包from Django import template

  5.register  = template.Library()

  6.对my_filter函数进行装饰  @register.filter

使用:

  1.重启django项目

  2.模板中需要导入my_filters.py文件 {% load my_filters %}

  3.使用自定义过滤器{{变量|filter_name:arg}}有arg参数 或 {{变量|filter_name}} 没有arg参数  

 

  注:

    1.函数名可以作为过滤器名在django的模板中使用,或者可以在装饰器中对名字进行设置@register.filter(name='filter_name')

自定义filter参数的扩展:

filter的参数除了要修饰的变量外最多只能有一个参数,如果需要多个参数的情况时,可以传入多个参数中间用','隔开

例:

  {{变量名|filter_name:'参数1,参数2,参数3'}}     # 这种方式只能是字符串的形式

  后端过滤器函数进行处理时可以用arg.split(',')方法来获取到多个参数。