コンテンツ(投稿記事/固定ページ)の公開日を出力/取得
コンテンツ(投稿記事/固定ページ)の公開日を出力または取得するには、the_date
関数を使用します。
同じ機能にget_the_date
関数がありますが、get_the_date
関数は戻り値に日付を返し、かつ1ページに対して複数の実行を行うのに対し、the_date
関数はecho
として出力され(第四引数の指定した内容による)、かつ1ページに対して1回しか実行できません。
- ※ サブループ内でのみ取得可能です。
構文
引数名 | 型 | 初期値 | 説明 | |
---|---|---|---|---|
第一引数 | 書式 | string | '' | 日付の書式。 書式はPHPのDateTime::formatの書式を用いる。 PHP:DateTime::format 初期値は一般設定の"日付形式"の選択した書式が反映される。 |
第二引数 | 接頭辞 | string | '' | 取得した公開日の前に付ける文字。 HTMLでも問題ない。 |
第三引数 | 接尾辞 | string | '' | 取得した公開日の後に付ける文字。 HTMLでも問題ない。 |
第四引数 | 出力 | boolean | true | echoで出力するかどうか。true ... echoで出力false ... returnで返す |
戻り値
第三引数がfalseの場合は取得した公開日を返し、第三引数がtrueの場合は何も返しません。
サンプルコード
時間を取得したい場合は、コンテンツ(投稿記事/固定ページ)の公開時間を取得ページをご覧ください。