hugo/content/functions/math.md

---
title: Math
description: Hugo provides nine mathematical operators in templates.
godocref:
date: 2017-02-01
publishdate: 2017-02-01
lastmod: 2017-02-01
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 integers.                                                            | `{{add 1 2}}` &rarr; 3           |
| `div`          | Divides two integers.                                                         | `{{div 6 3}}` &rarr; 2           |
| `mod`          | Modulus of two integers.                                                      | `{{mod 15 3}}` &rarr; 0          |
| `modBool`      | Boolean of modulus of two integers. Evaluates to `true` if result equals 0.   | `{{modBool 15 3}}` &rarr; true   |
| `mul`          | Multiplies two integers.                                                      | `{{mul 2 3}}` &rarr; 6           |
| `sub`          | Subtracts two integers.                                                       | `{{sub 3 2}}` &rarr; 1           |
| `math.Ceil`    | Returns the least integer value greater than or equal to the given number.    | `{{math.Ceil 2.1}}` &rarr; 3     |
| `math.Floor`   | Returns the greatest integer value less than or equal to the given number.    | `{{math.Floor 1.9}}` &rarr; 1    |
| `math.Round`   | Returns the nearest integer, rounding half away from zero.                    | `{{math.Round 1.5}}` &rarr; 2    |
Squashed 'docs/' content from commit f887bd7b git-subtree-dir: docs git-subtree-split: f887bd7b4e3e7c7e76cd63951e5b0d37d8fe0ac7 2017-08-10 11:18:22 -04:00			`---`
			`title: Math`
Squashed 'docs/' changes from 20959c7b..36d7e22f 36d7e22f Document fmt.{print, println} template functions 79a72fce Fix link to page variables 00342ca9 Fix broken link on highlight page 15f44952 Fix link in v0.28 release notes 0100df73 Fix code examples for math.{Ceil, Floor, Round} a354a69b Fix broken netlify.toml 4995e5df Merge branch 'master' of github.com:gohugoio/hugoDocs 9cdd990a Hugo 0.29 463558f9 Document math.Log template function 588499af Add nohup.out to .gitignore db8ddcf7 Change name of post files in example to use post prefix 296ec01f Add ox-hugo Emacs package to the tools section f060d6d1 Fix math.Ceil, Floor, and Round naming a2262d24 Document strings.TrimPrefix and TrimSuffix template functions 80c1ce63 Document strings.TrimLeft and TrimRight template functions 2921088d Document urls.Parse template function f0133079 Document math.{ceil, floor, round} template functions 82863808 Fix typo in migration tools section d5215d61 Add link to syntax hl docs in release notes 541f0686 Update versions 275ce2b4 Update 0.28 release notes 886713a1 Add release notes for 0.28 bed02e5f Merge branch 'next' 8e3b1ac4 Add a note about branches 1662b9d0 Add missing Disqus links in templates/internal.md git-subtree-dir: docs git-subtree-split: 36d7e22f5c21c550bd87782d2ddca666178fe1ff 2017-09-28 11:20:10 -04:00			`description: Hugo provides nine mathematical operators in templates.`
Squashed 'docs/' content from commit f887bd7b git-subtree-dir: docs git-subtree-split: f887bd7b4e3e7c7e76cd63951e5b0d37d8fe0ac7 2017-08-10 11:18:22 -04:00			`godocref:`
			`date: 2017-02-01`
			`publishdate: 2017-02-01`
			`lastmod: 2017-02-01`
Squashed 'docs/' changes from 44fe0285..32356e4e 32356e4e Fix typo in header of shortcode-templates.md c8f1a2d2 Correct code example for index template function bfa6a55d Escape code fencing ff8b2f99 Fix typos in deployment with wercker tutorial 557c36e8 theme: Merge commit '7fbb4bed25001182bfeb91f79db0f0c1936582ee' 7fbb4bed Squashed 'themes/gohugoioTheme/' changes from 7dd8a302..ca53082d ce31cee0 Add "See Also" config 158cee1b Make the tags into keywords 61600be6 Add a note to the related section 49edb5a2 Relase 0.27.1 c9bbc001 releaser: Add release notes to /docs for release of 0.27.1 213c6c3b Add bugs poster 8b4590cd Add KeyCDN integration tutorial 2b277859 Add tutorial videos to several docs pages 950fef1f Update roadmap to link to the correct milestones page 496f5bf6 Rename relnotes d6f9378d Bump Netlify versions to 0.27 087fde7f Update 0.27 release notes 603f94ae docs: Document Related Content 3790f6a3 releaser: Bump versions for release of 0.27 0948868c releaser: Add release notes to /docs for release of 0.27 git-subtree-dir: docs git-subtree-split: 32356e4eabe357ae914f4d1d59e8ae31ce936723 2017-09-21 13:03:00 -04:00			`keywords: [math, operators]`
Squashed 'docs/' content from commit f887bd7b git-subtree-dir: docs git-subtree-split: f887bd7b4e3e7c7e76cd63951e5b0d37d8fe0ac7 2017-08-10 11:18:22 -04:00			`categories: [functions]`
			`menu:`
			`docs:`
			`parent: "functions"`
			`toc:`
			`signature: []`
			`workson: []`
			`hugoversion:`
			`relatedfuncs: []`
			`deprecated: false`
			`draft: false`
			`aliases: []`
			`---`

Squashed 'docs/' changes from 20959c7b..36d7e22f 36d7e22f Document fmt.{print, println} template functions 79a72fce Fix link to page variables 00342ca9 Fix broken link on highlight page 15f44952 Fix link in v0.28 release notes 0100df73 Fix code examples for math.{Ceil, Floor, Round} a354a69b Fix broken netlify.toml 4995e5df Merge branch 'master' of github.com:gohugoio/hugoDocs 9cdd990a Hugo 0.29 463558f9 Document math.Log template function 588499af Add nohup.out to .gitignore db8ddcf7 Change name of post files in example to use post prefix 296ec01f Add ox-hugo Emacs package to the tools section f060d6d1 Fix math.Ceil, Floor, and Round naming a2262d24 Document strings.TrimPrefix and TrimSuffix template functions 80c1ce63 Document strings.TrimLeft and TrimRight template functions 2921088d Document urls.Parse template function f0133079 Document math.{ceil, floor, round} template functions 82863808 Fix typo in migration tools section d5215d61 Add link to syntax hl docs in release notes 541f0686 Update versions 275ce2b4 Update 0.28 release notes 886713a1 Add release notes for 0.28 bed02e5f Merge branch 'next' 8e3b1ac4 Add a note about branches 1662b9d0 Add missing Disqus links in templates/internal.md git-subtree-dir: docs git-subtree-split: 36d7e22f5c21c550bd87782d2ddca666178fe1ff 2017-09-28 11:20:10 -04:00			`\| Function \| Description \| Example \|`
			`\|----------------\|-------------------------------------------------------------------------------\|----------------------------------\|`
			\| `add` \| Adds two integers. \| `{{add 1 2}}` → 3 \|
			\| `div` \| Divides two integers. \| `{{div 6 3}}` → 2 \|
			\| `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 \|
			\| `mul` \| Multiplies two integers. \| `{{mul 2 3}}` → 6 \|
			\| `sub` \| Subtracts two integers. \| `{{sub 3 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.Round` \| Returns the nearest integer, rounding half away from zero. \| `{{math.Round 1.5}}` → 2 \|