hugo/docs/content/en/functions/math.md

title	description	date	publishdate	lastmod	keywords	categories	menu	toc	signature	workson	hugoversion	relatedfuncs	deprecated	draft	aliases
Math	Hugo provides mathematical operators in templates.	2017-02-01	2017-02-01	2023-03-11	math operators	functions	docs parent functions						false	false

Function	Description	Example
add	Adds multivalued numbers.	{{add 1 2}} → 3
	If one of the numbers is a float, the result is a float.	{{add 1.1 2}} → 3.1
sub	Subtracts multivalued numbers.	{{sub 3 2}} → 1
	If one of the numbers is a float, the result is a float.	{{sub 3 2.5}} → 0.5
mul	Multiplies multivalued numbers.	{{mul 2 3}} → 6
	If one of the numbers is a float, the result is a float.	{{mul 2 3.1}} → 6.2
div	Divides multivalued numbers.	{{div 6 3}} → 2
		{{div 6 4}} → 1
	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 multivalued numbers.	{{math.Max 1 2}} → 2
math.Min	Returns the smaller of multivalued numbers.	{{math.Min 1 2}} → 1
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