WEB制作のための情報サイト / unazuki Library

the_date()

基本構文と使い方(引数・戻り値)

基本構文

現在の記事(投稿や固定ページ)の公開日を表示します。

the_date($format,$before,$after,$display);

ただし、記事一覧ページ等で、複数の記事の公開日が同一の場合、最新の記事のみ公開日を表示します。公開日が同一の記事においてもすべて公開日を表示したい場合は(それが一般的だと思いますが)、get_the_date()を使うことができます。

引数

引数必須/任意引数に指定するもの
第1引数
$format
任意日付の表示形式(2026年1月1日や2026.01.01などの表示形式)
例1:Y.m.d → 2026.01.01
例2:Y.n.j → 2026.1.1
初期値設定→一般の日付形式
第2引数
$before
任意日付の前に表示する文字列を指定可。
初期値''(空の文字列)
第3引数
$after
任意日付の後に表示する文字列を指定可。
初期値''(空の文字列)
第4引数
$display
任意表示する場合はtrue、取得する場合はfalse
初期値true

実行結果

現在の記事(投稿や固定ページ)の公開日を表示します。

例1.記事の公開日を表示する

下記の場合、引数の指定がないため、WordPressの管理画面→設定→一般の日付形式で指定した日付フォーマットで表示されます。

the_data();

例2.4桁2桁2桁(2026.01.01)の形式で日付を表示する

the_date('Y.m.d')

※WordPressの管理画面側の設定とはあえて異なる日付フォーマットにしたい場合に使えます。

例3.日付の前後に文字列を追加する

the_date('Y-m-d','【公開日:','】')

結果例:【公開日:2026-01-01】

学習者向け補足情報

【引数とは】
テンプレートタグ(=関数)を実行する際に、引数を渡すことができるテンプレートタグがあります。引数は、関数の中で使われるので、渡す引数の値によって実行結果が変わってきます。何を処理したいのか、どのようなデータを取得したいのかによって渡す引数が変わります。

【引数について】

  • 指定できる引数の数はテンプレートタグによって異なります。(引数なしもあり)
  • 引数ごとに必須 / 任意が決まっています。(必須は必ず指定、任意は指定しなければ初期値)
  • 引数名(例:$post)は仕様の便宜上の名前と考えてください。(この名前自体はテンプレートタグ実行に関係しません。各引数に何を指定するのかを理解していればOKです。)

※当サイトでは初期値とデフォルト値の言葉の定義を区別せず、原則統一して初期値を採用しています。

関連するテンプレートタグ

テンプレートタグ 説明
post_class() 投稿に関するclass名を表示する。
the_author() 現在の記事の投稿者の名前を表示します。
get_the_author() 現在の記事の投稿者の名前を返します。
the_ID() 現在の記事のIDを表示します。
get_the_ID() 現在の記事のIDを取得します。
get_post_meta() カスタムフィールドの値を取得します。
the_permalink() 記事のパーマリンク(URL)を表示します。
get_permalink() 記事のパーマリンク(URL)を表示します。
the_post_thumbnail() 記事にアイキャッチ画像がある場合は、アイキャッチ画像を表示する。
get_the_post_thumbnail() 記事にアイキャッチ画像がある場合は、アイキャッチ画像を含むimg要素を返す。
has_post_thumbnail() 投稿にアイキャッチ画像があるかないかを判定した結果、真偽値(true / false)を返す。
the_content() 記事本文を表示します。moreタグ(続きを読むタグ)を使っている場合は、引数の指定次第で記事の一部を表示します。
get_the_content() 記事本文のHTMLを取得します。moreタグ(続きを読むタグ)を使っている場合は、引数の指定次第で記事の一部を取得します。
the_excerpt() 記事の抜粋分を表示します。抜粋の長さはデフォルトで110文字(日本語)。
get_the_excerpt() 記事の抜粋分を取得します。抜粋の長さはデフォルトで110文字(日本語)。
the_time() 記事の公開時刻を表示します。
get_the_time() 記事の公開時刻を取得します。
get_the_date() 記事(投稿や固定ページ)の公開日を取得する。
the_title() 記事のタイトルを表示します。
get_the_title() 記事のタイトルを取得します。