aboutsummaryrefslogtreecommitdiffhomepage
path: root/content/en/functions/math/index.md
blob: fd4d10a317707eafbc7074b6e0847c24d282400a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
---
title: math
description: Hugo provides mathematical operators in templates.
categories: [functions]
keywords: []

menu:
  docs:
    parent: functions
function:
  aliases: []
  returnType:
  signatures: []
relatedFunctions: []
---

| Function        | Description                                                                 | Example                                           |
|-----------------|-----------------------------------------------------------------------------|---------------------------------------------------|
| `add`           | Adds two or more numbers.                                                   | `{{ add 12 3 2 }}` → `17`                    |
|                 | *If one of the numbers is a float, the result is a float.*                  | `{{ add 1.1 2 }}` → `3.1`                    |
| `sub`           | Subtracts one or more numbers from the first number.                        | `{{ sub 12 3 2 }}` → `7`                     |
|                 | *If one of the numbers is a float, the result is a float.*                  | `{{ sub 3 2.5 }}` → `0.5`                    |
| `mul`           | Multiplies two or more numbers.                                             | `{{ mul 12 3 2 }}` → `72`                    |
|                 | *If one of the numbers is a float, the result is a float.*                  | `{{ mul 2 3.1 }}` → `6.2`                    |
| `div`           | Divides the first number by one or more numbers.                            | `{{ div 12 3 2 }}` → `2`                     |
|                 | *If one of the numbers is a float, the result is a float.*                  | `{{ div 6 4.0 }}` → `1.5`                    |
| `mod`           | Modulus of two integers.                                                    | `{{ mod 15 3 }}` → `0`                       |
| `modBool`       | Boolean of modulus of two integers. Evaluates to `true` if result equals 0. | `{{ modBool 15 3 }}` → `true`                |
| `math.Abs`      | Returns the absolute value of the given number.                             | `{{ math.Abs -2.1 }}` → `2.1`                |
| `math.Ceil`     | Returns the least integer value greater than or equal to the given number.  | `{{ math.Ceil 2.1 }}` → `3`                  |
| `math.Floor`    | Returns the greatest integer value less than or equal to the given number.  | `{{ math.Floor 1.9 }}` → `1`                 |
| `math.Log`      | Returns the natural logarithm of the given number.                          | `{{ math.Log 42 }}` → `3.737`                |
| `math.Max`      | Returns the greater of all numbers. Accepts scalars, slices, or both.       | `{{ math.Max 1 (slice 2 3) 4 }}` → `4`       |
| `math.Min`      | Returns the smaller of all numbers. Accepts scalars, slices, or both.       | `{{ math.Min 1 (slice 2 3) 4 }}` → `1`       |
| `math.Product`  | Returns the product of all numbers. Accepts scalars, slices, or both.       | `{{ math.Product 1 (slice 2 3) 4 }}` → `24`  |
| `math.Pow`      | Returns the first number raised to the power of the second number.          | `{{ math.Pow 2 3 }}` → `8`                   |
| `math.Round`    | Returns the nearest integer, rounding half away from zero.                  | `{{ math.Round 1.5 }}` → `2`                 |
| `math.Sqrt`     | Returns the square root of the given number.                                | `{{ math.Sqrt 81 }}` → `9`                   |
| `math.Sum`      | Returns the sum of all numbers. Accepts scalars, slices, or both.           | `{{ math.Sum 1 (slice 2 3) 4 }}` → `10`      |