Django基礎-過濾器
分類：
Django（13） 
版權聲明：本文爲博主原創文章，未經博主允許不得轉載。
原版地址：http://blog.csdn.net/yima1006/article/details/7201199
1.可以通過過濾器來修改變量的顯示，過濾器的形式是：{{ variable | filter }}，管道符號'|'代表使用過濾器
2.過濾器能夠採用鏈式的方式使用，例如：{{ text | escape | linebreaks }}
3.過濾器還可以帶參數，例如： {{ bio|truncatewords:30 }}
4.過濾器的參數中如果帶有空格，那麼需要用引號引起來，例如：{{ list | join : ", "}}
5.django中30個內建的過濾器
(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所設置的形式。
意義：將日期格式數據按照給定的格式輸出
(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 < > is converted to > ' (single quote) is converted to ' " (double quote) is converted to " & is converted to &
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.2 |
| 34.00000 | {{value|floatformat}} | 34 |
| 34.26000 | {{value|floatformat}} | 34.3 |
(2)如果arg是正數，那麼引擎會四捨五入，同時保留arg位的小數。
| 34.23234 | {{value|floatformat:3}} | 34.232 |
| 34.00000 | {{value|floatformat:3}} | 34.000 |
| 34.26000 | {{value|floatformat:3}} | 34.260 |
(3)如果arg是負數，那麼引擎會四捨五入，如果有小數部分，那麼保留arg位小數；否則，則沒有任何小數部分。
| 34.23234 | {{value|floatformat:"-3"}} | 34.232 |
| 34.00000 | {{value|floatformat:"-3"}} | 34 |
| 34.26000 | {{value|floatformat:"-3"}} | 34.26 |
(16)get_digit
使用形式：{{ value | get_digit:"arg"}}，例如，如果value是123456789，arg是2，那麼輸出是8
意義：給定一個數字，返回，請求的數字，記住：1代表最右邊的數字，如果value不是合法輸入，
那麼會返回所有原有值。
(17)iriencode 使用形式：{{value | iriencode}}
意義：如果value中有非ASCII字符，那麼將其進行抓化成URL中適合的編碼，如果value已經進行過URLENCODE，
改操作就不會再起作用。
(18)join
使用形式：{{ value | join:"arg"}}，如果value是['a','b','c']，arg是'//'那麼輸出是a//b//c
意義：使用指定的字符串連接一個list，作用如同python的str.join(list)
(19)last
使用形式：{{ value | last }}
意義：返回列表中的最後一個Item
(20)length
使用形式：{{ value | length }}
意義：返回value的長度。
(21)length_is
使用形式：{{ value | length_is:"arg"}}
意義：返回True，如果value的長度等於arg的時候，例如：如果value是['a','b','c']，arg是3，那麼返回True
(22)linebreaks
使用形式：{{value|linebreaks}}
意義：value中的"\n"將被<br/>替代，並且整個value使用</p>包圍起來，從而適和HTML的格式
(23)linebreaksbr
使用形式：{{value |linebreaksbr}}
意義：value中的"\n"將被<br/>替代
(24)linenumbers
使用形式：{{value | linenumbers}}
意義：顯示的文本，帶有行數。
(25)ljust
使用形式：{{value | ljust}}
意義：在一個給定寬度的字段中，左對齊顯示value (25)center
使用形式：{{value | center}}
意義：在一個給定寬度的字段中，中心對齊顯示value (25)rjust
使用形式：{{value | rjust}}
意義：在一個給定寬度的字段中，右對齊顯示value (26)lower
使用形式：{{value | lower}}
意義：將一個字符串轉換成小寫形式
(27)make_list
使用形式：{{value | make_list}}
意義：將value轉換成一個list，對於字符串，轉換成字符list；對於整數，轉換成整數list
例如value是Joel，那麼輸出將是[u'J',u'o',u'e',u'l']；value是123，那麼輸出將是[1,2,3]
(28)pluralize
使用形式：{{value | pluralize}}，或者{{value | pluralize:"es"}}，或者{{value | pluralize:"y,ies"}}
意義：如果value不是1，則返回一個複數後綴，缺省的後綴是's'
(29)random
使用形式：{{value | random}}
意義：從給定的list中返回一個任意的Item
(30)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
(31)safe
使用形式：{{value | safe}}
意義：當系統設置autoescaping打開的時候，該過濾器使得輸出不進行escape轉換
(32)safeseq
與上述safe基本相同，但有一點不同的就是：safe是針對字符串，而safeseq是針對多個字符串組成的sequence
(33)slice
使用形式：{{some_list | slice:":2"}}
意義：與python語法中的slice相同，:2表示第一的第二個元素
(34)slugify
使用形式：{{value | slugify}}
意義：將value轉換成小寫形式，同事刪除所有分單詞字符，並將空格變成橫線
例如：如果value是Joel is a slug，那麼輸出將是joel-is-a-slug
(35)stringformat
這個不經常用，先不說
(36)striptags
使用形式：{{value | striptags}}
意義：刪除value中的所有HTML標籤
(37)time
使用形式：{{value | time:"H:i"}}或者{{value | time}}
意義：格式化時間輸出，如果time後面沒有格式化參數，那麼輸出按照TIME_FORMAT中設置的進行。
(38)title
轉換一個字符串成爲title格式。
(39)truncatewords
使用形式：{{value | truncatewords:2}}
意義：將value切成truncatewords指定的單詞數目
例如，如果value是Joel is a slug 那麼輸出將是：Joel is ...
(40)truncatewords_html
使用形式同(39)
意義：truncation點之前如果某個標籤打開了，但是沒有關閉，那麼在truncation點會立即關閉。
因爲這個操作的效率比truncatewords低，所有只有在value是html格式時，才考慮使用。
(41)upper
轉換一個字符串爲大寫形式
(42)urlencode
將一個字符串進行URLEncode
(43)urlize
意義：將一個字符串中的URL轉化成可點擊的形式。
使用形式：{{ value | urlize }}
例如，如果value是Check out www.djangoproject.com，那麼輸出將是： Check out <a href="http://www.djangoproject.com">www.djangoproject.com</a>
(44)urlizetrunc
使用形式：{{ value | urlizetrunc:15}}
意義：與(43)相同，但是有一點不同就是現實的鏈接字符會被truncate成特定的長度，後面以...現實。
(45)wordcount
返回字符串中單詞的數目
(46)wordwrap
使用形式：{{value | wordwrap:5}}
意義：按照指定的長度包裝字符串
例如，如果value是Joel is a slug，那麼輸出將會是：
Joel
is a
slug
(47)timesince
使用形式：{{value | timesince:arg}}
意義：返回參數arg到value的天數和小時數
例如，如果 blog_date 是一個日期實例表示 2006-06-01 午夜， 而 comment_date 是一個日期實例表示 2006-06-01 早上8點，
那麼 {{ comment_date|timesince:blog_date }} 將返回 "8 hours".
(48)timeuntil
使用形式：{{value | timeuntil}}
意義：與(47)基本相同，一個不同點就是，返回的是value距離當前日期的天數和小時數