Thymeleafの#dates.formatメソッドとは？初心者向け日付フォーマットガイド
生徒
「Thymeleafで日付を指定した形式でフォーマットする方法はありますか？」
先生
「はい！Thymeleafには#dates.formatという便利なメソッドがあります。このメソッドを使うと、日付を自由にフォーマットできますよ。」
生徒
「具体的にどのように使うのか教えてください！」
先生
「それでは、基本的な使い方から応用例まで一緒に見ていきましょう。」
1. #dates.formatメソッドの基本
#dates.formatメソッドは、Thymeleafテンプレート内で日付を指定したフォーマットで表示するためのメソッドです。例えば、「yyyy-MM-dd」形式で日付を表示する場合は以下のように書きます。
<p th:text="${#dates.format(today, 'yyyy-MM-dd')}"></p>
このコードを実行すると、現在の日付（例: 2025-01-28）が「yyyy-MM-dd」の形式で表示されます。todayは日付オブジェクトとして事前に設定されているものとします。
2. 日本語形式での日付フォーマット
日本語形式で日付を表示する場合は、「yyyy年MM月dd日」のフォーマットを指定します。以下の例を見てみましょう。
<p th:text="${#dates.format(today, 'yyyy年MM月dd日')}"></p>
このコードを実行すると、「2025年01月28日」のように日本語形式で日付が表示されます。地域に合わせたフォーマットが必要な場合に非常に便利です。
3. 日付と時刻を表示する
日付だけでなく時刻を含めて表示したい場合には、「yyyy-MM-dd HH:mm:ss」のようなフォーマットを指定します。
<p th:text="${#dates.format(today, 'yyyy-MM-dd HH:mm:ss')}"></p>
このコードでは、現在の日付と時刻が「2025-01-28 14:30:00」のように表示されます。タイムスタンプを含めたデータ表示に適しています。
4. 曜日を含めた日付フォーマット
曜日を含めた日付を表示する場合は、「EEEE」のパターンを使用します。以下はその例です。
<p th:text="${#dates.format(today, 'yyyy-MM-dd (EEEE)')}"></p>
このコードを実行すると、「2025-01-28 (火曜日)」のように曜日が表示されます。カレンダーやスケジュール機能のテンプレートで役立ちます。
5. デフォルト値を設定する
日付がnullの場合にデフォルト値を設定することも可能です。以下の例では、日付がない場合に「日付未設定」を表示します。
<p th:text="${date != null ? #dates.format(date, 'yyyy-MM-dd') : '日付未設定'}"></p>
このコードでは、dateがnullの場合に「日付未設定」と表示され、それ以外の場合はフォーマットされた日付が表示されます。
6. 実践例: 動的な日付フォーマット
以下は、日付を動的にフォーマットし、現在の日付や1週間後の日付を表示する例です。
<p>現在の日付: <span th:text="${#dates.format(today, 'yyyy-MM-dd')}"></span></p>
<p>1週間後の日付: <span th:text="${#dates.format(#dates.addDays(today, 7), 'yyyy-MM-dd')}"></span></p>
このコードでは、動的に計算された日付が指定した形式で表示されます。スケジュール管理やリマインダー機能のテンプレートで活用できます。
7.まとめ
今回は、Thymeleafの#dates.formatメソッドを使用した日付フォーマットの基本的な使い方から応用例までを解説しました。#dates.formatを利用すれば、テンプレート内で日付を自由自在にフォーマットできるため、見やすい表示形式を簡単に実現できます。
また、曜日や時刻を含むフォーマット、日本語形式、条件付きのデフォルト表示など、実践的なテクニックも学びました。
日付の表示は多くのアプリケーションで必要とされる要素なので、この知識を活用してテンプレートをさらに魅力的にしましょう。
<p th:text="${#dates.format(today, 'dd/MM/yyyy HH:mm:ss')}"></p>
<p th:text="${#dates.format(#dates.addDays(today, -7), 'yyyy-MM-dd')}"></p>
このように、#dates.formatを組み合わせて動的な日付フォーマットを活用することで、ユーザーにとって便利で分かりやすい情報提供が可能になります。
生徒
「Thymeleafの#dates.formatメソッドを使えば、日付を色々な形式で表示できるのが分かりました！特に曜日や時間を含めたフォーマットが役立ちそうです。」
先生
「そうですね！例えば、スケジュール管理やイベントカレンダーなどの機能にピッタリです。また、条件付きでデフォルト値を設定する方法も実務でよく使われます。」
生徒
「デフォルト値を設定する方法も便利ですね。テンプレートがもっとスマートに書けるようになりそうです。」
先生
「その通りです。今日学んだ#dates.formatを活用して、ぜひ実際のプロジェクトで試してみてくださいね。」
この記事を読んだ人からの質問
プログラミング初心者からのよくある疑問／質問を解決します
Thymeleaf（タイムリーフ）で日付の形式を変換するには、どのメソッドを使えば良いですか？
JavaのテンプレートエンジンであるThymeleafで日付を特定の形式にフォーマットしたい場合は、ユーティリティオブジェクトの「#dates.format」メソッドを使用します。このメソッドを使うことで、JavaのDateオブジェクトをブラウザ上で表示する際に、年、月、日、曜日などを自由自在なレイアウトで出力することが可能になります。初心者の方でも、ダブルクォーテーションで囲ったフォーマットパターンを指定するだけで簡単に実装できる便利な機能です。
日付を「2025-01-28」のようにハイフン区切りで表示する具体的な設定方法を教えてください。
日付をハイフン区切りの形式で表示するには、#dates.formatの第2引数に「'yyyy-MM-dd'」という文字列を指定します。ここで使用する「yyyy」は西暦の4桁、「MM」は月の2桁、「dd」は日の2桁を意味しています。Spring Bootなどのコントローラーから渡された日付変数がtodayであれば、th:text属性の中でこのメソッドを呼び出すことで、プログラミング初心者でも迷わずに標準的な日付形式を出力することができます。
ChatGPTなどの生成AIをこれから学びたい方に向けて、AIスキルアカデミーの口コミ・評判、料金、無料セミナーの内容を詳しくまとめています。
AIスキルアカデミーの口コミ・評判を詳しく見る【職業訓練講師が直接指導】
社会人向けThymeleaf入門セミナー｜Java Web画面を自在に操るテンプレートエンジンの極意
Java入門からSpring Boot実務まで。現場で絶賛される「設計の型」を最短距離で習得。
技術記事の内容を、自分の「スキル」へ変える。
職業訓練講師が最短攻略！社会人向けThymeleaf実践。Javaエンジニアのための「プロ基準」画面構築術。
Java Web開発の現場で標準採用されているThymeleaf（タイムリーフ）。本セミナーでは、HTMLの構造を壊さず開発できる「ナチュラルテンプレート」の利点を最大限に引き出し、動的表示とロジックの分離を60分で濃縮習得する、社会人のためのThymeleaf特化型講座です。
60分集中・Thymeleaf画面設計ワークショップ
【つくるもの】
「実務型データ一覧・更新画面」を構築。リストの反復表示（th:each）、条件判定（th:if）、フォームとの双方向データバインド（th:object）など、商用開発で毎日使うコア機能を、スタースクール流の最短距離でマスターします。
【開発環境】
Spring Boot 3.x環境を使用。ブラウザでそのまま確認できるThymeleafの特性を活かし、デザイナーとの協業やデバッグ効率を劇的に高める「プロの画面構築フロー」を職業訓練講師が直接伝授します。
この60分で得られる3つの革新スキル
classの動的切り替えや属性制御を自在に操り、Java入門者でも「読みやすく修正しやすい」HTML構造を維持する技法を習得します。
th:fragmentを駆使し、ヘッダー・フッター・ボタン等を部品化。大規模開発でも一箇所直せば全画面に反映される「スケーラブルな設計」を学びます。
日付の整形やログイン状況に応じた表示切替など、周辺技術と「繋ぐ」ためのThymeleaf特有の記述ルール（#fieldsやsec:authorize等）を短時間で整理します。
※本講座は、Thymeleafを使いこなし「現場で重宝される画面構築力」を手に入れたい社会人向けの「フロント×バックエンド連携講座」です。スタースクールがあなたの即戦力化を全力でリードします。
累計120万PV超の技術メディアが監修。理論の丸暗記ではない、
実務10年PLが実践する「一生モノの設計力」を、60分の濃縮セミナーで伝授します。
