get_the_date() の使い方｜説明・引数・注意点

説明

基本構文

get_the_date( string $format = '', int|WP_Post $post = null ): string|int|false

引数

• $format：日付の書式（PHPの date() と同じ）
• $post：投稿IDまたはオブジェクト

戻り値

書式化した日付。失敗時は false。

使い方（サンプル）

echo esc_html( get_the_date( 'Y.m.d' ) );

注意点

• 書式を省略すると、管理画面の「日付形式」の設定が使われます。
• 更新日は get_the_modified_date() で取得します。

実務での使いどころ

• 投稿の公開日を、文字列として受け取って表示するとき。
• 日付の書式を変えて表示するとき（get_the_date( 'Y年n月j日' )）。

よくあるミスと対処

• the_date() と違い、同じ日の投稿でも、毎回日付が返る。the_date() は、同じ日の2件目以降では出力しない。
• 書式を省略すると、管理画面の「設定 > 一般」の日付形式が使われる。
• <time datetime> 用に、書式を c などで取得する場合と、表示用の書式を混同している。

NG例

the_date( 'Y年n月j日' ); // 同じ日の投稿が並ぶと、2件目以降は出ない

OK例

echo esc_html( get_the_date( 'Y年n月j日' ) );

使い分け早見表

関連項目

the_date()、get_the_modified_date()

公式リファレンス：get_the_date() | Function | WordPress Developer Resources