1. #numbersユーティリティの基本

Thymeleafの#numbersユーティリティは、数値のフォーマットや丸め処理、変換などを簡単に行うためのツールです。テンプレート内で数値操作を直感的に記述でき、特に数値を見やすく表示したい場合に非常に便利です。まず、基本的な数値フォーマットの例を見てみましょう。


<p th:text="${#numbers.formatDecimal(12345.6789, 2, 2, 'COMMA')}"></p>

このコードでは、小数点以下2桁までを表示し、桁区切りにカンマを使用しています。結果として「12,345.68」と表示されます。

2. 小数点以下の丸め処理

#numbers.formatDecimalは、小数点以下の丸め処理を行う際に便利です。以下は、値を2桁まで丸める例です。


<p th:text="${#numbers.formatDecimal(98765.4321, 2, 2)}"></p>

このコードでは、「98765.43」と表示されます。数値をより見やすく整える際に役立ちます。

3. 数値のフォーマットスタイルをカスタマイズする

#numbersを使えば、さまざまなフォーマットスタイルを適用できます。以下は、通貨形式で数値を表示する例です。


<p th:text="${#numbers.formatCurrency(1234.56, 'JPY')}"></p>

このコードでは、「￥1,234」と表示されます。通貨単位や桁区切りの設定を簡単に変更できるのがポイントです。

4. 数値を丸めずに表示する

必要に応じて、小数点以下を丸めずそのまま表示することも可能です。以下の例では、すべての小数点以下を保持して表示しています。


<p th:text="${#numbers.formatDecimal(12345.6789, 0, 4)}"></p>

この結果、「12345.6789」と表示されます。データの精度を保つ必要がある場合に便利です。

5. 数値を四捨五入する

数値を四捨五入するには、#numbers.formatDecimalのオプションを活用します。以下は、小数点以下1桁まで四捨五入する例です。


<p th:text="${#numbers.formatDecimal(3.14159, 1, 1)}"></p>

このコードでは、「3.1」と表示されます。数値を簡単に丸める方法として役立ちます。

6. 実践例: 数値を動的に表示する

以下は、動的に数値を操作して表示する例です。このコードでは、通貨形式、小数点以下の丸め、桁区切りのフォーマットを組み合わせています。


<p>フォーマット済みの数値: <span th:text="${#numbers.formatDecimal(amount, 2, 2, 'COMMA')}"></span></p>
<p>通貨形式: <span th:text="${#numbers.formatCurrency(amount, 'USD')}"></span></p>
<p>四捨五入済み: <span th:text="${#numbers.formatDecimal(amount, 0, 0)}"></span></p>

これらのコードを使用することで、数値の表示を直感的かつ柔軟に制御できます。

7. まとめ

本記事では、Thymeleafの#numbersユーティリティについて詳しく解説しました。数値のフォーマット、丸め処理、通貨形式の表示、そして小数点以下の制御など、#numbersを使えばテンプレート内で数値の操作が簡単に行えます。特に、数値の丸めや桁区切りを直感的に記述できる点が非常に便利です。通貨のフォーマット表示や動的な数値操作にも応用できるため、Webアプリケーションのテンプレート作成時には欠かせないツールです。

例えば、#numbers.formatDecimalを使うことで、小数点以下の桁数を指定してフォーマットする方法や、#numbers.formatCurrencyで通貨形式を表示する方法を紹介しました。また、数値を丸めずそのまま表示する方法や、四捨五入の活用例についても具体例を挙げて説明しました。

以下に、本記事で紹介した重要なコードをまとめますので、プロジェクトで活用してみてください。


<p>丸めた数値: <span th:text="${#numbers.formatDecimal(98765.4321, 2, 2)}"></span></p>
<p>通貨形式: <span th:text="${#numbers.formatCurrency(1234.56, 'JPY')}"></span></p>
<p>丸めない数値: <span th:text="${#numbers.formatDecimal(12345.6789, 0, 4)}"></span></p>
<p>四捨五入: <span th:text="${#numbers.formatDecimal(3.14159, 1, 1)}"></span></p>

#numbersを使いこなすことで、数値表示をよりわかりやすく、効率的に管理できるようになります。

先生と生徒の振り返り会話

生徒

「今日の記事を読んで、#numbersユーティリティで数値を簡単に操作できることがわかりました！特に、通貨形式や丸め処理が便利ですね。」

先生

「その通りです！#numbersを活用すれば、テンプレート内のコードをシンプルに保ちながら柔軟な数値表示が可能になります。」

生徒

「さっそくプロジェクトで試してみます。ほかにも応用例があれば教えてください！」

先生

「いいですね！次はリストや日付のユーティリティについても学んでみましょう。」