Django 过滤器 、日期格式化、数学运算

Django 的模板中的数学运算
前言

django模板只提供了加法的filter，没有提供专门的乘法和除法运算；
django提供了widthratio的tag用来计算比率，可以变相用于乘法和除法的计算。

加法

{{value|add:10}}
note:value=5,则结果返回15

减法

{{value|add:-10}}
note:value=5,则结果返回-5，加一个负数就是减法了

乘法

{% widthratio 5 1 100%}
note:等同于：(5 / 1) * 100 ，结果返回500，withratio需要三个参数，它会使用参数1/参数2*参数3的方式进行运算，进行乘法运算，使「参数2」=1

除法

{% widthratio 5 100 1%}
note:等同于：(5 / 100) * 1,则结果返回0.05,和乘法一样，使「参数3」= 1就是除法了。

Django模版加法：
{{ value|add:10}} value=5，则返回15
1
Django模版减法：
{{value|add:-10}} value=5，则返回-5，这个比较好理解，减法就是加一个负数
1
Django模版乘法：
{% widthratio 5 1 100 %} 上面的代码表示：5/1 *100，返回500，widthratio需要三个参数，它会使用 参数1/参数2*参数3，所以要进行乘法的话，就将参数2=1即可
1
Django做除法，这里用到widthratio这个方法
<td>{% widthratio foo.product_amount 100 1 %}</td>#}

如果想将widthratio函数处理后的值当做变量，可以如下方法
{% widthratio this_value max_value max_width as width %}
{% blocktrans %}The width is: {{ width }}{% endblocktrans %}
1
2
3
4
5
数据保留两位小数
<td>{{ foo.product_amount |floatformat:5 }}</td>
register = template.Library()
1
2
3
一些复杂一些的运算
利用 add 这个filter ,可以做更疯狂的事:
计算 A^2: {% widthratio A 1 A %}
计算 (A+B)^2: {% widthratio A|add:B 1 A|add:B %}
计算 (A+B) * (C+D): {% widthratio A|add:B 1 C|add:D %}
1
2
3
4
除法并保留小数
首先定义方法在templatehelper.py文件中
@register.filter
def div(value, div):
'''
分转化为元，保留两位小数
:param value:
:param div:
:return:
'''
return round((value / div), 2)
然后在模板中可以按照如下使用，当然前提是{% load templatehelper %}：
<td>{{ foo.product_amount |div:100 }}</td>

---------------------

django1.4

html页面从数据库中读出DateTimeField字段时，显示的时间格式和数据库中存放的格式不一致，比如数据库字段内容为2012-08-26 16:00:00，但是页面显示的却是Aug. 26, 2012, 4 p.m.

为了页面和数据库中显示一致，需要在页面格式化时间，需要添加<td>{{ dayrecord.p_time|date:"Y-m-d H:i:s" }}</td> 类似的过滤器。刷新页面，即可正常显示。

过滤器相关：

一、形式：小写
{{ 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 }} &转为&amp;
{{ 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

日期格式化参数：

a 'a.m.' 或 'p.m.' (注意,它与PHP 的输出略有不同.它包括了句点(django扩展). 'a.m.' 
A 'AM' 或 'PM'. 'AM' 
B 未实现.   
d 每月第几天, 带前导零 '01' to '31' 
D 每周第几天,3字母的字符串. 'Fri' 
f 时间, 12-小时制的小时和分钟数, 如果分钟数为零,则不显示.(django 扩展). '1', '1:30' 
F 月份, 长文本格式. 'January' 
g 小时, 12-小时制,没有前导零 '1' to '12' 
G 小时, 24-小时制,没有前导零 '0' to '23' 
h 小时, 12-小时制,有前导零 '01' to '12' 
H 小时, 24-小时制,有前导零 '00' to '23' 
i 分钟. '00' to '59' 
I 未实现   
j 每月第几天, 无前导零 '1' to '31' 
l 每周第几天,长文本格式. 'Friday' 
L 是否闰年. True or False 
m 数字表示的月份,有前导零. '01' to '12' 
M 月份,3字母短文本格式. 'Jan' 
n 数字表示的月份,无前导零 '1' to '12' 
N 出版风格的月份缩写(django 扩展) 'Jan.', 'Feb.', 'March', 'May' 
O 与格林威治的时间差(以小时计) '+0200' 
P 12小时制的小时分钟及'a.m.'/'p.m.' 分钟数若为零则不显示. 用字符串表示特殊 的时间点, 如 'midnight' 和 'noon' (django扩展) '1 a.m.', '1:30 p.m.', 'midnight','noon', '12:30 p.m.' 
r RFC 822 格式的日期 . 'Thu, 21 Dec 2000 16:01:07+0200' 
s 秒数, 带有前导零的数字表示 '00' to '59' 
S 英语序数后缀,用于一个月的第几天,2个字符 'st', 'nd', 'rd' or 'th' 
t 给定月共有多少天. 28 to 31 
T 本机时区. 'EST', 'MDT' 
U 未实现   
w 一周中的第几天,没有前导零的数字 '0' (Sunday) to '6' (Saturday) 
W ISO-8601 一年的第多少星期数, 一周从 星期一开始 1, 23 
y Year, 2 位数字表示 '99' 
Y Year, 4 位数字表示 '1999' 
z 一年中的第几天 . 0 to 365 
Z 以秒计的时区偏移量. 这个偏移量对UTC西部 时区总是负数,而对UTC东部时区则总是正数 -43200 to 43200

-------------------django内建的过滤器-------------------
1、add 
使用形式为：{{ value | add: "2"}}
意义：将value的值增加2

2、addslashes
使用形式为：{{ value | addslashes }}
意义：在value中的引号前增加反斜线

3、capfirst
使用形式为：{{ value | capfirst }}
意义：value的第一个字符转化成大写形式

4、cut
使用形式为：{{ value | cut:arg}}， 例如，如果value是“String with spaces” arg是" "那么输出是"Stringwithspaces"
意义：从给定value中删除所有arg的值

5、date
使用形式为：：
(a) {{ value | date:"D d M Y" }}，例如，如果value是一个datetime对象(datetime.datetime.now())那么输出将是字符串"Wed 09 Jan 2008"
(b) {{ value | date }}，这种形式没有格式化字符串，这时候，格式化字符串会自动采用DATE_FORMAT所设置的形式。

意义：将日期格式数据按照给定的格式输出

(c){{value|date:"Y-m-d H:i"}} 例如：如果value是一个datetime对象(datetime.datetime.now())那么输出将是字符串“2017-03-23 18:11:48”

6、default
使用形式：{{ value | default: "nothing" }}，例如，如果value是“”，那么输出将是nothing
意义：如果value的意义是False，那么输出使用缺省值

7、default_if_none
使用形式：{{ value | default_if_none:"nothing" }}，例如，如果value是None，那么输出将是nothing
意义：如果value是None，那么输出将使用缺省值

8、dictsort
意义：如果value的值是一个字典，那么返回值是按照关键字排序的结果
使用形式：{{ value | dictsort:"name"}}，例如，
如果value是：
[
{'name': 'zed', 'age': 19},
{'name': 'amy', 'age': 22},
{'name': 'joe', 'age': 31}, ]
那么，输出是：
[
{'name': 'amy', 'age': 22},
{'name': 'joe', 'age': 31},
{'name': 'zed', 'age': 19}, ]

9、dictsortreversed
意义：如果value的值是一个字典，那么返回值是按照关键字排序的结果的反序
使用形式：与上述(8)完全相同。

10、divisibleby
使用形式：{{ value | divisibleby:arg}}，如果value是21，arg是3，那么输出将是True
意义：如果value能够被arg整除，那么返回值将是True

11、escape
使用形式：{{ value | escape}}
意义：替换value中的某些字符，以适应HTML格式，包括：
< is converted to &lt;
> is converted to &gt;
' (single quote) is converted to '
" (double quote) is converted to &quot;
& is converted to &amp;

注：escape仅仅在输出的时候才起作用，所以escape不能够用在链式过滤器的中间，
他应该总是最后一个过滤器，如果想在链式过滤器的中间使用，那么可以使用force_escape

12、escapejs
使用形式：{{ value | escapejs }}
意义：替换value中的某些字符，以适应JAVASCRIPT和JSON格式。

13、filesizeformat
使用形式：{{ value | filesizeformat }}
意义：格式化value，使其成为易读的文件大小，例如：13KB，4.1MB等。

14、first
使用形式：{{ value | first }}
意义：返回列表中的第一个Item，例如，如果value是列表['a','b','c']，那么输出将是'a'。

15、floatformat
使用形式：{{ value | floatformat}}或者{{value|floatformat:arg}}， arg可以是正数也可以是负数。没有参数的floatformat相当于floatformat:-1

1、如果不带arg，那么引擎会四舍五入，同时最多只保留一位小数。
34.23234{{ value|floatformat }}34.234.00000{{ value|floatformat }}3434.26000{{ value|floatformat }}34.3

2、如果arg是正数，那么引擎会四舍五入，同时保留arg位的小数。
34.23234{{ value|floatformat:3 }}34.23234.00000{{ value|floatformat:3 }}34.00034.26000{{ value|floatformat:3 }}34.260

3、如果arg是负数，那么引擎会四舍五入，如果有小数部分，那么保留arg位小数；否则，则没有任何小数部分。
34.23234{{ value|floatformat:"-3" }}34.23234.00000{{ value|floatformat:"-3" }}3434.26000{{ value|floatformat:"-3" }}34.26(16)get_digit

使用形式：{{ value | get_digit:"arg"}}，例如，如果value是123456789，arg是2，那么输出是8
意义：给定一个数字，返回，请求的数字，记住：1代表最右边的数字，如果value不是合法输入，那么会返回所有原有值。

16、iriencode
使用形式：{{value | iriencode}}
意义：如果value中有非ASCII字符，那么将其进行抓化成URL中适合的编码，如果value已经进行过URLENCODE，
改操作就不会再起作用。

17、join
使用形式：{{ value | join:"arg"}}，如果value是['a','b','c']，arg是'//'那么输出是a//b//c
意义：使用指定的字符串连接一个list，作用如同python的str.join(list)

18、last
使用形式：{{ value | last }}
意义：返回列表中的最后一个Item

19、length
使用形式：{{ value | length }}
意义：返回value的长度。

20、length_is
使用形式：{{ value | length_is:"arg"}}
意义：返回True，如果value的长度等于arg的时候，例如：如果value是['a','b','c']，arg是3，那么返回True

21、linebreaks
使用形式：{{value|linebreaks}}
意义：value中的"\n"将被<br/>替代，并且整个value使用</p>包围起来，从而适和HTML的格式

22、linebreaksbr
使用形式：{{value |linebreaksbr}}
意义：value中的"\n"将被<br/>替代

23、linenumbers
使用形式：{{value | linenumbers}}
意义：显示的文本，带有行数。

24、ljust
使用形式：{{value | ljust}}
意义：在一个给定宽度的字段中，左对齐显示value

25、center
使用形式：{{value | center}}
意义：在一个给定宽度的字段中，中心对齐显示value

26、rjust
使用形式：{{value | rjust}}
意义：在一个给定宽度的字段中，右对齐显示value

27、lower
使用形式：{{value | lower}}
意义：将一个字符串转换成小写形式

28、make_list
使用形式：{{value | make_list}}
意义：将value转换成一个list，对于字符串，转换成字符list；对于整数，转换成整数list
例如value是Joel，那么输出将是[u'J',u'o',u'e',u'l']；value是123，那么输出将是[1,2,3]

29、pluralize
使用形式：{{value | pluralize}}，或者{{value | pluralize:"es"}}，或者{{value | pluralize:"y,ies"}}
意义：如果value不是1，则返回一个复数后缀，缺省的后缀是's'

30、random
使用形式：{{value | random}}
意义：从给定的list中返回一个任意的Item

31、removetags
使用形式：{{value | removetags:"tag1 tag2 tag3..."}}
意义：删除value中tag1,tag2....的标签。例如，如果value是<b>Joel</b> <button>is</button> a <span>slug</span>
tags是"b span"，那么输出将是：Joel <button>is</button> a slug

32、safe
使用形式：{{value | safe}}
意义：当系统设置autoescaping打开的时候，该过滤器使得输出不进行escape转换

33、safeseq
与上述safe基本相同，但有一点不同的就是：safe是针对字符串，而safeseq是针对多个字符串组成的sequence

34、slice
使用形式：{{some_list | slice:":2"}}
意义：与python语法中的slice相同，:2表示第一的第二个元素

35、slugify
使用形式：{{value | slugify}}
意义：将value转换成小写形式，同事删除所有分单词字符，并将空格变成横线
例如：如果value是Joel is a slug，那么输出将是joel-is-a-slug

36、stringformat
这个不经常用，先不说

37、striptags
使用形式：{{value | striptags}}
意义：删除value中的所有HTML标签

38、time
使用形式：{{value | time:"H:i"}}或者{{value | time}}
意义：格式化时间输出，如果time后面没有格式化参数，那么输出按照TIME_FORMAT中设置的进行。

39、title
转换一个字符串成为title格式。

40、truncatewords
使用形式：{{value | truncatewords:2}}
意义：将value切成truncatewords指定的单词数目
例如，如果value是Joel is a slug 那么输出将是：Joel is ...

41、truncatewords_html
使用形式同(39)
意义：truncation点之前如果某个标签打开了，但是没有关闭，那么在truncation点会立即关闭。
因为这个操作的效率比truncatewords低，所有只有在value是html格式时，才考虑使用。

42、upper
转换一个字符串为大写形式

43、urlencode
将一个字符串进行URLEncode

44、urlize
意义：将一个字符串中的URL转化成可点击的形式。
使用形式：{{ value | urlize }}
例如，如果value是Check out www.djangoproject.com，那么输出将是：
Check out <a href="http://www.djangoproject.com">www.djangoproject.com</a>

45、urlizetrunc
使用形式：{{ value | urlizetrunc:15}}
意义：与(43)相同，但是有一点不同就是现实的链接字符会被truncate成特定的长度，后面以...现实。

46、wordcount
返回字符串中单词的数目

47、wordwrap
使用形式：{{value | wordwrap:5}}
意义：按照指定的长度包装字符串
例如，如果value是Joel is a slug，那么输出将会是：
Joel
is a
slug

48、timesince
使用形式：{{value | timesince:arg}}
意义：返回参数arg到value的天数和小时数
例如，如果 blog_date 是一个日期实例表示 2006-06-01 午夜， 而 comment_date 是一个日期实例表示 2006-06-01 早上8点，
那么 {{ comment_date|timesince:blog_date }} 将返回 "8 hours".

49、timeuntil
使用形式：{{value | timeuntil}}
意义：与(47)基本相同，一个不同点就是，返回的是value距离当前日期的天数和小时数。