get_post_datetime

説明

DateTimeImmutable | false get_post_datetime( [ int | WP_Post $post = null [ , string $field = 'date' [ , string $source = 'local' ] ] ] )
投稿時間・更新時間を取得する。

パラメータ

  • $post
    投稿情報または投稿IDを指定(省略時はnull)。
  • $field
    'date' または'modified'を指定(省略時は'date')。
  • $source
    'local'または'gmt'を指定(省略時は'local')。

返り値

パラメータ$postが有効な場合はパラメータ$field$sourceで指定された投稿時間または更新時間から生成したDateTimeImmutableオブジェクトを返す。無効な場合はfalseを返す。


注意

投稿情報は、サイトのタイムゾーンとUTCそれぞれの投稿時間と更新時間を保存しており、本関数は次の表で示すパラメータ$field$sourceの組み合わせで対象を決める。

取得する時間投稿情報のプロパティ$field$source
投稿時間(サイト)post_date'date''local'
投稿時間(UTC)post_date_gmt'date''gmt'
更新時間(サイト)post_modified'modified''local'
更新時間(UTC)post_modified_gmt'modified''gmt'

パラメータ$fieldは、'modified'以外は'date'とみなされる。

パラメータ$sourceは、'gmt'以外は'local'とみなされる。


使用例

  • 現在の投稿情報の投稿時間を取得する。
    <?php $datetime = get_post_datetime() ?>
  • パラメータ$postで指定された投稿情報の更新時間(UTC)を取得する。
    <?php $datetime = get_post_datetime( $post, 'modified', 'gmt' ) ?>

フィルター

直接実行するフィルターはありません。

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/general-template.php

最終更新 : 2019年11月15日 09:48



お勧め

子カテゴリのアーカイブページを親カテゴリ用のテンプレートファイルで表示しよう(2011年12月8日 更新)

少し前に投稿した「適切なテンプレートファイルを用意してテンプレート内の振り分け処理を無くす」で説明した通り、特定のカテゴリ専用のテンプレートとしてcategory-○○.phpを用意することで、category.phpやarchive.php内で振り分けを行う必要がなくなる。ただ、すべてのカテゴリ分を用意するのは効率的ではないし、特に子カテゴリについては親カテゴリと共通内容になるケースが多いのではないだろうか。ここでは、子カテゴリの個別テンプレートファイルを作らず、親カテゴリのテンプレートを利用する方法を紹介する。

管理画面の'アイキャッチ画像'を'写真'に変える(2013年1月23日 更新)

クライアント向けに専用のテーマを提供する際、稀に管理画面内の用語の変更を依頼されることがある。今回は、'アイキャッチ画像'だとわかりにくいので'写真'に変えてほしいということだった。

5.7の機能拡張:投稿一覧画面向けのフィルター(2021年2月18日 更新)

昨日、予定通り公開された「WordPress 5.7 Beta 3(以降Beta 3)」。WordPressはバージョンアップ毎にアクションやフィルターが追加されており、今回のバージョンアップでは投稿一覧画面に影響を与えるフィルターが追加されていた。

Login rebuilder 2.6.0の新機能紹介(2019年4月22日 更新)

今回追加したものは、REST API / Usersの使用をログイン時のみ使用できるように制限する機能である。この機能を有効にすることで、管理者情報が漏洩するリスクを低減させる効果が期待できる。

タイトルのみをキーワード検索する(2014年4月3日 更新)

WordPressのキーワード検索は、投稿タイトルと本文のどちらかに指定したキーワードが含まれているかを調べるわけだが、時々タイトルだけとか、逆に本文だけ検索したいケースがある。