From dbe984c397d6c1e49167dd8fbfb655dd17a14572 Mon Sep 17 00:00:00 2001 From: Daniel Greenfeld Date: Sun, 4 Nov 2012 16:35:40 -0800 Subject: [PATCH] Fixed #19241 -- Improved floatformat docs Demonstrate how to round to integers using floatformat templatetag --- docs/ref/templates/builtins.txt | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt index 4aa1a990cd5..c7fab8c53dd 100644 --- a/docs/ref/templates/builtins.txt +++ b/docs/ref/templates/builtins.txt @@ -1505,6 +1505,17 @@ that many decimal places. For example: ``34.26000`` ``{{ value|floatformat:3 }}`` ``34.260`` ============ ============================= ========== +Particularly useful is passing 0 (zero) as the argument which will round the +float to the nearest integer. + +============ ================================ ========== +``value`` Template Output +============ ================================ ========== +``34.23234`` ``{{ value|floatformat:"0" }}`` ``34`` +``34.00000`` ``{{ value|floatformat:"0" }}`` ``34`` +``39.56000`` ``{{ value|floatformat:"0" }}`` ``40`` +============ ================================ ========== + If the argument passed to ``floatformat`` is negative, it will round a number to that many decimal places -- but only if there's a decimal part to be displayed. For example: