Django模板语言，过滤器整理

最新推荐文章于 2022-10-06 17:27:29 发布

weixin_30621959

最新推荐文章于 2022-10-06 17:27:29 发布

阅读量197

点赞数

文章标签： python php

原文链接：http://www.cnblogs.com/xiao-xue-di/p/9707033.html

版权

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 是 "I'm using Django", 输出将变成 "I\'m using Django"

3. capfirst

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

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

4. center

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

5. cut

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

如果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:00`或`2008-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	布尔值是否是一个闰年。	`True`或`False`
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周数，周数从星期一开始。	`1`，`53`
y	年份，2位数字。	`'99'`
Y	年，4位数。	`'1999年'`
z	一年中的日子	`0`到`365`
Z	时区偏移量，单位为秒。 UTC以西时区的偏移量总是为负数，对于UTC以东时，它们总是为正。	`-43200`到`43200`

实例：

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_FORMAT，DATETIME_FORMAT，SHORT_DATE_FORMAT或SHORT_DATETIME_FORMAT

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

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

7. default

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

8. default_if_none

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

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

9. dictsort

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

实例：

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可以被给出的参数整除，则返回 True

实例：

value = 12

{{ value|divisibleby:“2” }}

输出：True

12. filesizeformat

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

实例：

value = 1234567890

{{ value|filesizeformat }}

输出：1.1 GB

13. 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" }}

如果value为123456789，则输出将为8。

16. join

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

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

17. last

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

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

18. length

返回值的长度

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

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

19. length_is

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

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

20. linebreaks

替换纯文本中的换行为正确的HTML标签；单独的一个换行变成( ) ，原文本用p标签包裹起来。

如果value为Joel\nis a slug，输出将为Joel is a slug。

21. linebreaksbr

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

如果value为Joel\nis a slug，输出将为Joel is a slug。

22. linenumbers

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

如果value为：

one two three

输出将是：

one
two
three

23. ljust

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

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

如果value为Django，则输出将为“Django ”。

24. lower

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

如果value是ABC, 则输出将为abc

25. make_list

返回转换为列表的值。

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

26. pluralize

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

例如:

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

如果num_messages是1，则输出将为 You have 1 message. 如果num_messages是2，输出将为 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是['a', 'b', 'c', 'd'], 输出可能是'c'.

29. rjust

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

30. safe

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

31. safeseq

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

32. slice

返回列表的一部分。

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

33. striptags

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

如果value为"cu ti", 输出结果为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