Template:Floor

[view] [edit] Template documentation

Implements the mathematical floor function, i.e. returns the input value if it is an integer, otherwise returns the largest integer below the input value.

For positive numbers, the decimals will be simply dropped. For negative numbers, it will also truncate the displayed decimals but the integer part of the absolute value displayed is incremented. This is the mathematical definition of the IEEE rounding mode toward minus infinite.

Usage:

{{Floor|value}}

Examples:

• {{Floor|3.9}} = 3.
• {{Floor|3.5}} = 3.
• {{Floor|3.1}} = 3.
• {{Floor|3.0}} = 3.
• {{Floor|1.0}} = 1.
• {{Floor|0.9}} = 0.
• {{Floor|0.5}} = 0.
• {{Floor|0.1}} = 0.
• {{Floor|0.0}} = 0.
• {{Floor|-0.1}} = -1.
• {{Floor|-0.5}} = -1.
• {{Floor|-0.9}} = -1.
• {{Floor|-1.0}} = -1.
• {{Floor|-3.0}} = -3.
• {{Floor|-3.2}} = -4.
• {{Floor|-3.5}} = -4.
• {{Floor|-3.9}} = -4.

Known bug (should appear extremely rarely as this goes beyond the precision of math performed in pages using this template)

• {{Floor|0.99999999999999983}} = 0 (OK).
• {{Floor|0.99999999999999984}} = 0 (wrong but comes from limited floating point precision, the input is 1-epsilon, adding 0.5 yields 1.5-epsilon which rounds to 2 exactly, then subtracting 1 gives 1 exactly).
• {{Floor|0.99999999999999999}} = 1 (wrong but comes from limited floating point precision, the input is considered equal to the exact integer 1).

• {{Floor|-0.99999999999999983}} = -1 (OK).
• {{Floor|-0.99999999999999984}} = -2 (wrong but comes from limited floating point precision, the input is not exactly equal to the integer -1, but subtracting 0.5 yields -1.5 exactly due to precision limits, which then rounds to -2).
• {{Floor|-0.99999999999999999}} = -1 (OK, the input is considered equal to the exact integer -1, so this exact -1 integer is returned).

See also:

• Template:Ceil