Django模板语言,过滤器整理

梦想与她 提交于 2021-01-12 06:30:24

Django模板语言,过滤器整理

1. add

{{ value|add:"2" }}

把add后的参数加给value;

处理时,过滤器首先会强制把两个值转换成Int类型。 如果强制转换失败, 它会试图使用各种方式吧两个值相加。

实例:

{{ arg|add:val }}

1)arg是5,val是3,将会输出8

2)arg是5,val是'3',将会输出8

3)arg是'jason',val是'2',将会输出jason2

4)arg是'jason',val是2,将会输出空

5)arg是[1, 2, 3],val是[4],将会输出[1, 2, 3, 4]

 

2. addslashes

{{ value|addslashes }}

在引号前面加上斜杆

像这样:

如果value 是 "I'm using Django", 输出将变成 "I\'m using Django"

 

3. capfirst

{{ value|capfirst}}

将变量的第一个字母变成大写,如果第一个字符不是字母,则过滤器不生效

如果 "value" 是 "django", 输出将变成 Django

 

4. center

{{ value|center:16}}

使"value"在给定的宽度范围内居中。

 

5. cut

移除value中所有的与给出的变量相同的字符串

{{ value|cut:" "}}

如果value“String with spaces”,输出将为"Stringwithspaces"

 

6. date

根据给定格式对一个date变量格式化

可用的格式字符串:

格式化字符 描述 示例输出
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

实例:

now = datetime.datetime.now()

1){{ now|date:'Y-m-d H:i:s'}}

输出类似:2018-10-09 11:15:22

2){{ now|date }}

输出类似:Oct. 9, 2018

传递的格式可以是预定义的格式DATE_FORMATDATETIME_FORMATSHORT_DATE_FORMATSHORT_DATETIME_FORMAT

3){{ now|date:"DATETIME_FORMAT" }}

输出类似:Oct. 9, 2018, 11:19 a.m.

 

7. default

如果value的计算结果为False,则使用给定的默认值。 否则,使用该value。

{{ value|default:"nothing" }}

 

8. default_if_none

{{ value|default_if_none:"nothing"}}

当且仅当value为None,则使用给定的默认值。 否则,使用该value。

注意,如果给出一个空字符串,默认值将被使用。

 

9. dictsort

{{ value|dictsort:"name" }}

接受一个字典列表,并返回按参数中给出的键排序后的列表。

实例:

Value = [ {'name': 'zed', 'age': 19}, {'name': 'amy', 'age': 22}, {'name': 'joe', 'age': 31}, ]

{{ Value|dictsort:'name' }} {{ Value|dictsort:'age' }}

输出:

[{'name': 'amy', 'age': 22}, {'name': 'joe', 'age': 31}, {'name': 'zed', 'age': 19}]

[{'name': 'zed', 'age': 19}, {'name': 'amy', 'age': 22}, {'name': 'joe', 'age': 31}]

 

10. dictsortreversed

获取字典列表,并返回按照参数中给出的键按相反顺序排序的列表。 这与上面的过滤器完全相同,但返回的值将是相反的顺序。

 

11. divisibleby

{{ value|divisibleby:“2” }}

如果value可以被给出的参数整除,则返回 True

实例:

value = 12

{{ value|divisibleby:“2” }}

输出:True

 

12. filesizeformat

格式化为“可读”文件大小(即'13 KB't4> MB''102 bytes'等)。

{{ value|filesizeformat }}

实例:

value = 1234567890

{{ value|filesizeformat }}

输出:1.1 GB

 

13. first

{{ value|first }}

返回序列中的第一项(字符串、列表、元组等)

如果value是列表['a', 'b', 'c'],输出将为'a'

 

14. floatformat

当不使用参数时,将浮点数舍入到小数点后一位;使用参数时,保留参数指定的位数

实例:

pi = 3.1415926

{{ pi|floatformat }}

{{ pi|floatformat:0 }}

{{ pi|floatformat:2 }}

输出:

3.1 3 3.14

 

15. get_digit

给定一个整数,返回所请求的数字,其中1是最右边的数字,2是第二个最右边的数字等。 返回无效输入的原始值(如果输入或参数不是整数,或参数小于1)。否则,输出总是一个整数。

实例:

{{ value|get_digit:"2" }}

如果value123456789,则输出将为8

 

16. join

使用字符串连接列表,例如Python的str.join(list)

{{ value|join:" // " }}

如果value是列表['a', 'b', 'c'],输出将为“a // b // C“。

 

17. last

返回列表中的最后一个项目

{{ value|last }}

如果value是列表['a', 'b', 'c'],输出将为'c'

 

18. length

返回值的长度

{{ value|length }}

如果value['a', 'b', 'c', 'd']"abcd",输出将为4

对于未定义的变量,过滤器返回0

 

19. length_is

如果值的长度是参数,则返回True,否则返回False

{{ value|length_is:"4" }}

如果value是['a', 'b', 'c', 'd']或"abcd",输出将为True。

 

20. linebreaks

替换纯文本中的换行为正确的HTML标签;单独的一个换行变成(<br/>) ,原文本用p标签包裹起来。

如果valueJoel\nis a slug,输出将为<p>Joel<br/>is a slug</p>

 

21. linebreaksbr

与linebreaks类似, 区别是, linebreaksbr只替换换行, 替换完成后没有p标签包裹.

如果valueJoel\nis a slug,输出将为Joel<br/>is a slug

 

22. linenumbers

输出多行文本时, 在行前显示行号.

{{ value|linenumbers }}

如果value为:

one two three

输出将是:

  1. one
  2. two
  3. three

 

23. ljust

将给定宽度的字段中的值左对齐。

"{{ value|ljust:"10" }}"

如果valueDjango,则输出将为“Django ”

 

24. lower

将字符串转换为全部小写。

如果valueABC, 则输出将为abc

 

25. make_list

返回转换为列表的值。

{{ value|make_list }}

如果value是字符串"Joel",输出将是列表['J', 'o' , 'e', 'l']。 如果value123,输出将为列表['1', '2', '3']

 

26. pluralize

如果值不是1则返回一个复数形式 , 通常用 's'表示.

例如:

You have {{ num_messages }} message{{ num_messages|pluralize }}.

如果num_messages1,则输出将为 You have 1 message. 如果num_messages2,输出将为 You have 2 messages.

另外如果你需要的不是 's'后缀的话, 你可以提供一个备选的参数给过滤器;

例如:

You have {{ num_walruses }} walrus{{ num_walruses|pluralize:"es" }}.

对于非一般形式的复数,你可以同时指定 单复数形式,用逗号隔开.

例如:

You have {{ num_cherries }} cherr{{ num_cherries|pluralize:"y,ies" }}.

 

27. pprint

用于调试, 方便查看.

 

28. random

返回给定列表中的随机项。

{{ value|random }}

如果value是['a', 'b', 'c', 'd'], 输出可能是'c'.

 

29. rjust

右对齐给定宽度字段中的值。

 

30. safe

将字符串标记为在输出之前不需要进一步的HTML转义。 当自动转义关闭时,此过滤器不起作用。

 

31. safeseq

safe过滤器应用于序列的每个元素。 与对序列进行操作的其他过滤器(例如join)一起使用非常有用。

{{ some_list|safeseq|join:", " }}

 

32. slice

返回列表的一部分。

{{ some_list|slice:":2" }}

如果some_list['a', 'b', 'c'],那么输出将是['a', 'b']

 

33. striptags

尽一切可能努力剥离所有[X] HTML标签。

{{ value|striptags }}

如果value为"<b>cu ti</b>", 输出结果为cuti(不带样式).

 

34. time

根据给定的格式格式化时间。

实例:

now = datetime.datetime.now()

{{ now|time:'H:i:s' }}

输出类似:

13:25:53

 

35. timesince

将日期格式设为自该日期起的时间(例如,“4天,6小时”)。

实例:

now = datetime.datetime.now()

blog_date = now - datetime.timedelta(days=2)

{{ blog_date|timesince:now }}

{{ now|timesince:blog_date }}

输出类似:

2 days 0 minutes

 

36. timeuntil

与timesince类似

实例:

now = datetime.datetime.now()

blog_date = now - datetime.timedelta(days=2)

{{ blog_date|timeuntil:now }}

{{ now|timeuntil:blog_date }}

输出类似:

0 minutes 2 days

 

37. title

将字符串中的每个单词首字母转为大写

{{ value|title }}

如果value“my FIRST post”,输出将为“My First Post”

 

38. truncatechars

如果字符串字符多于指定的字符数量,那么会被截断。 截断的字符串将以可翻译的省略号序列(“...”)结尾。

{{ value|truncatechars:9 }}

如果value“myFIRSTpost”,输出将为“MyFirst...”

 

39.truncatewords

在一定数量的字后截断字符串。

{{ value|truncatewords:2 }}

如果value“my name is post”,输出将为“My name ...”

 

40. upper

将字符串转换为大写形式

{{ value|upper }}

如果valueabc, 则输出将为ABC

 

41. urlencode

转义要在URL中使用的值。

{{ value|urlencode }}

如果value"https://www.example.org/foo?a=b&c=d",输出将为"https%3A//www.example.org/foo%3Fa%3Db%26c%3Dd"

可以提供包含不应该转义的字符的可选参数。

如果未提供,则'/'字符被假定为安全的。 当所有字符应该转义时,可以提供空字符串。 像这样:

{{ value|urlencode:"" }}

如果value"https://www.example.org/",输出将为"https%3A%2F%2Fwww.example.org%2F"

 

42. wordcount

返回字数(单词数)

{{ value|wordcount }}

如果value“Joel is a slug”,输出将为4

 

43. wordwrap

以指定的行长度换行单词。

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!