get_lastpostmodified

説明

string get_lastpostmodified( [ string $timezone = 'server' [ , string $post_type = 'any' ] ] )
投稿記事の最終更新日時を取得する。

パラメータ

  • $timezone
    タイムゾーンとして'gmt'、'blog'、'server'の何れかを指定(省略時は'server')。
  • $post_type
    [4.4.0]投稿タイプを指定(省略時は'any')。

返り値

投稿記事の最終更新日時を文字列で返す。

注意

パラメータ$timezoneが'gmt'の場合は最終投稿記事のpost_modified_gmtの値が、'blog'の場合は最終投稿記事のpost_modifiedの値となる。'server'の場合は最終投稿記事のpost_modified_gmtの値をサーバーのタイムゾーンで調整した値となる。

パラメータ$post_typeが'any'の場合、投稿タイプ情報のプロパティpublicがtrueのものがすべて対象となる。具体的には、標準では投稿('post')、固定ページ('page')、メディア('attachment')となり、有効なカスタム投稿タイプがある場合はそれも含まれる。


使用例

  • 投稿記事の最終更新日時を取得する。
    <?php $lastmodified = get_lastpostmodified( 'blog' ); ?>
  • 投稿タイプが「投稿」の最終更新日時を取得する。
    <?php $lastmodified = get_lastpostmodified( 'server', 'post' ); ?>

フィルター

[4.4.0]本関数の冒頭で'pre_get_lastpostmodified'フィルターを呼び出す。パラメータ$lastpostmodifiedにはfalseが、$timezoneおよび$post_typeには本関数が受け取った内容が格納されている。
$lastpostmodified = apply_filters( 'pre_get_lastpostmodified', $lastpostmodified, $timezone, $post_type );
[2.3.0]値を返す直前で'get_lastpostmodified'フィルターを呼び出す。パラメータ$lastpostmodifiedには最終更新日時を示す文字列が、$timezoneには本関数が受け取った内容が格納されている。
return apply_filters( 'get_lastpostmodified', $lastpostmodified, $timezone );

アクション

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

ソースファイル

/wp-includes/post.php

最終更新 : 2019年09月03日 08:01



お勧め

リビジョンの仕組みを勘違いしてた(2018年9月17日 更新)

過去の投稿情報を記録するリビジョン機能をカスタム投稿タイプで利用しようと思い作りこみしていたが、思惑通りの動きにならなかった。リビジョン機能は投稿情報の更新前の内容を記録するものと勝手に思い込んでいたのだが、どうやらそれは間違いだった。

検索ワード「-10,000円」を検索できるようにしたい(2018年5月27日 更新)

とあるサイトで「-10,000円」をキーワードに検索した際、予想と異なるページが表示され、ちょっと驚いた。今回はその原因調査と対策についてまとめてみた。

使っていないか確認しないとね!(2017年11月18日 更新)

2003年に誕生したWordPress。その歴史の中には、廃止予定(deprecated)となっている関数がいくつも存在する。それらの関数をテーマやプラグインで使用するべきではないし、使用しているなら代替の関数に書き換えるべきである。ここでは3.24.9.0現在、廃止予定となっている関数をまとめて紹介する。

メディア(attachment)を拡張してより便利に活用する(2014年5月22日 更新)

「メディア(attachment)」は、標準ではカテゴリもタグもカスタムフィールドもない。投稿と親子関係を作って利用することが前提だからともいえるが、メディアをもっと便利に活用するために、それらの付加情報を絞り込みの材料として利用できないか調べてみた。

投稿内容のid属性などを保存するための対策(2012年6月15日 更新)

WordPress 3.4にアップデートしたとある環境で投稿記事を保存すると、divタグなどのid属性がクリアされて保存するようになった(id属性が保存できなくなった)。ここでは、その対策方法の1つを紹介しておく。