【Django】テンプレート：日付の表示形式を変更（フォーマット）する（dateフィルタ）

Djangoには、初めからテンプレート上で使用できる組み込みフィルタが存在します。

組み込みフィルタを使用することで、views.pyからテンプレートに送られた変数を操作することができます。

組み込みフィルタはテンプレートファイル（htmlファイル）内で次のように使用します。

組み込みフィルタには様々な種類があります。
変数に値を加算するものや、変数から文字列を削除するものなど様々です。

本記事では日付データを指定した形式にフォーマットする組み込みフィルタを解説しています。

Webアプリケーションに組み込みフィルタdateを使った例を以下に記します。

まずはviews.pyでデータベース（モデル）からデータを取得し、それをテンプレートに渡します。

# views.py
def data_list(request):
    datas = Data.objects.all()
    context = {'datas':datas, }
    return render(request, 'data_list.html', context)

上記ではDataモデルからすべてのデータを取得し、変数datasに格納してテンプレートdata_list.htmlに渡しています。

次にテンプレートで受け取ったdatasから、created_at（保存した日付）を表示してみます。

# data_list.html
{% for data in datas %}
    {{ data.created_at }}
{% endfor %}

このままでも日付データを表示することができますが、組み込みフィルタdateを使って書式フォーマットを変更してみます。

{{ data.created_at|date:"Y M d D" }}

上記では出力が2021 Jul 21 Monとなります。

時間も含めた表記にしたいときは次のようにします。

{{ data.created_at|date:"y/n/j H:i:s" }}

上記では出力が21/6/21 15:54:54となります。

ご存じの通り、Webアプリケーションのタイムゾーンはsettings.pyで設定されています。

# settings.py
TIME_ZONE = 'Asia/Tokyo'

日本で使うWebアプリケーションでは上記の設定を記載して、JST（日本標準時刻）にしているはずです。

このタイムゾーンをテンプレートで表示する日時に対してUTC（協定世界時）に変更したい場合は、下記のようにlocaltimeを使います。

{% localtime off %}
    {{ data.created_at|date:"y/n/j H:i:s" }}
{% endlocaltime %}}

本記事「【Django】テンプレート：日付の表示形式を変更（フォーマット）する（dateフィルタ）」はいかがでしたか。

今回はDjangoのテンプレートで頻繁に使用する組み込みフィルタのうちdateについて解説しました。

dateフィルタを使いこなして、テンプレートに表示する日時を自在にフォーマットしてみてください。