説明
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最終更新 : 2023年12月12日 12:03
関連
お勧め
meta_compare_key使ってみた(2019年3月19日 更新)
ブロックエディターの登場により、標準のカスタムフィールドを使う機会はかなり減った気がする。そんな中、5.1.0で追加されたのが、カスタムフィールド名(メタキー)に含まれる文字列を指定する'meta_compare_key'キーだ。
WP_List_Tableクラスの「一括操作」フォームを使ってみた(2018年5月27日 更新)
今回は「WP_List_Tableクラスを使ってみた」の続き。投稿一覧やプラグインページなどにある「一括操作」(Bulkアクション)フォーム対応に関するメモである。
テーマから投稿画像のサイズを指定する(2012年3月15日 更新)
投稿記事に挿入する画像サイズは、サムネイル(150×150)、中サイズ(300×300)、大サイズ(1024×1024)がデフォルトだが、テーマによっては別のサイズを指定したい場合はある。基本的には、「設定」-「メディア」の「メディア設定」ページで指定できるが、テーマ内のfunctions.phpで設定しておくとちょっと便利かもしれない。ログインページを変える(2014年9月12日 更新)
WordPressの標準的な不正ログイン対策としては、ログインIDは'admin'を避けるパスワードはユニークで長くする、場合によってはアクセスできるIPアドレスを制限する、といった具合だろう。これらの他に何かできないものだろうかと、ちょっと考えてみた。新規投稿時の本文プレースホルダーテキストを変える(2021年9月9日 更新)
ブロックエディターに影響を与えるフィルターは多数存在する。今回紹介するフィルターはその1つで、新規投稿時の本文ブロックのプレースホルダーテキストを変更するものだ。