summaryrefslogtreecommitdiffstats
path: root/docs/content/en/functions/math.md
blob: 4abf34d1d517a05a80e7364b482ce8abed33cc34 (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
40
41
---
title: Math
description: Hugo provides mathematical operators in templates.
date: 2017-02-01
publishdate: 2017-02-01
lastmod: 2023-03-11
keywords: [math, operators]
categories: [functions]
menu:
  docs:
    parent: "functions"
toc:
signature: []
workson: []
hugoversion:
relatedfuncs: []
deprecated: false
draft: false
aliases: []
---

| 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.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 two or more numbers.                                 | `{{ math.Max 12 3 2 }}` → `12` |  
| `math.Min`   | Returns the smaller of two or more numbers.                                 | `{{ math.Min 12 3 2 }}` → `2`  |
| `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`     |