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

説明

基本構文

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

引数

• $format：書式（省略すると、設定の時刻形式）
• $post：投稿のIDまたはオブジェクト（省略すると、現在の投稿）

戻り値

書式にしたがった日時の文字列。取得できないときは false。

使い方（サンプル）

echo esc_html( get_the_time( 'Y年n月j日 H:i' ) );

注意点

• 書式を省略すると、設定の時刻形式が使われ、日付が含まれません。日付を出すときは、書式を指定します。
• 出力ではなく、値を返します。出力する関数は the_time()。

実務での使いどころ

• 公開日時を、変数に入れて加工するとき。
• <time datetime> に、c 形式の日時を入れるとき。

よくあるミスと対処

• 書式を省略し、時刻だけが取得される。
• echo し忘れる。
• ループの外で、投稿を指定していない。

NG例

echo get_the_time(); // 時刻だけが出る場合がある

OK例

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

使い分け早見表

関連項目

the_time()、get_the_date()

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