All examples presented in this article have been tested on Thymeleaf 3.1 and are applicable to various Thymeleaf scenarios, such as generating random numbers in Halo CMS themes.

This article is also available in: Simplified Chinese
此文章有简体中文版本

Integers

Generate random integer in range [min, min+range)

${#numbers.formatDecimal(T(java.lang.Math).floor(T(java.lang.Math).random()*range+min),0,0)}

Generate random integer in range [min, max]

${#numbers.formatDecimal(T(java.lang.Math).floor(T(java.lang.Math).random()*(max-min+1)+min),0,0)}

<p
  th:with="range=5,min=1"
  th:text="${#numbers.formatDecimal(T(java.lang.Math).floor(T(java.lang.Math).random()*range+min),0,0)}"
></p>

<p
  th:with="max=5,min=1"
  th:text="${#numbers.formatDecimal(T(java.lang.Math).floor(T(java.lang.Math).random()*(max-min+1)+min),0,0)}"
></p>

Using as List Index

No need for #numbers.formatDecimal when used as list index. Replace my_list with your actual list variable:

<p
  th:with="randomIndex=${T(java.lang.Math).floor(T(java.lang.Math).random()*#lists.size(my_list))}"
  th:text="${my_list[randomIndex]}"
></p>

Formatting Control

Formatted random integer in [min, min+range)
Format: Integer part ≥ integerDigits (padded with leading zeros), decimal part fixed to decimalDigits.

${#numbers.formatDecimal(T(java.lang.Math).floor(T(java.lang.Math).random()*range+min),integerDigits,decimalDigits)}

Formatted random integer in [min, max]
Same formatting rules as above:

${#numbers.formatDecimal(T(java.lang.Math).floor(T(java.lang.Math).random()*(max-min+1)+min),integerDigits,decimalDigits)}

<p 
  th:with="range=5,min=0,integerDigits=3,decimalDigits=2"
  th:text="${#numbers.formatDecimal(T(java.lang.Math).floor(T(java.lang.Math).random()*range+min),integerDigits,decimalDigits)}"
></p>

<p 
  th:with="max=4,min=0,integerDigits=3,decimalDigits=2"
  th:text="${#numbers.formatDecimal(T(java.lang.Math).floor(T(java.lang.Math).random()*(max-min+1)+min),integerDigits,decimalDigits)}"
></p>

Decimals/Floats

Generate random float in [min, max)

${T(java.lang.Math).random()*(max-min)+min}

<p
  th:with="max=1.8,min=0.5"
  th:text="${T(java.lang.Math).random()*(max-min)+min}"
></p>

Formatting Control

Formatted random float in [min, max)
Format: Integer part ≥ integerDigits (padded with leading zeros), decimal part fixed to decimalDigits.

${#numbers.formatDecimal(T(java.lang.Math).random()*(max-min)+min,integerDigits,decimalDigits)}

<p
  th:with="max=150.8,min=0.5,integerDigits=2,decimalDigits=2"
  th:text="${#numbers.formatDecimal(T(java.lang.Math).random()*(max-min)+min,integerDigits,decimalDigits)}"
></p>

Project Status

As of publication (February 20, 2025), the Thymeleaf random number feature request remains open with no updates:
Random integer in #numbers · Issue #787 · thymeleaf/thymeleaf