get_the_modified_time

説明

string | int | false get_the_modified_time( [ string $format = '' [ , int | WP_Post $post = null ] ] )
パラメータ$formatで指定したフォーマットで投稿の更新時刻を取得する。

パラメータ

  • $format
    フォーマットを指定(省略時は'')。
  • $post
    [4.6.0]投稿IDまたは投稿情報を指定(省略時はnull)。

返り値

パラメータ$formatで指定したフォーマットで投稿の更新時刻を返す。投稿情報が無効の場合はfalseを返す。


注意

パラメータ$formatには'G'や'U'のほかPHPのdate関数のものが指定できる。$formatが空の場合、オプション'time_format'の内容が適用される。

[4.6.0]パラメータ$postが追加され、任意の投稿情報の更新時刻を取得できるようになった。


使用例

  • 現在の投稿情報の更新時刻を取得する
    $modified = get_the_modified_time();
  • 変数$postの更新日を取得する
    $modified = get_the_modified_time( 'Y.m.d', $post );

フィルター

[2.0.0]更新時刻を返す前に'get_the_modified_time'フィルターを呼び出す。パラメータ$the_timeには更新時刻が、$formatには本関数が受け取った内容が格納されている。[4.6.0]パラメータ$postには本関数が受け取った内容が格納されている。
return apply_filters( 'get_the_modified_time', $the_time, $format, $post );

アクション

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

ソースファイル

/wp-includes/general-template.php

最終更新 : 2023年09月20日 14:57



お勧め

the_date関数で投稿日を確実に表示する(2011年12月20日 更新)

投稿記事の投稿日時を表示する際、 the_date関数を使用することが多いだろう。このthe_date関数はphpのdate関数と同じパラメータを指定することで、好みの日時フォーマットで投稿日時を表示できるのだが、ある条件の場合に投稿日時を表示しない。最初にこの現象に遭遇したときは、ちょっと悩まされた。

canvasタグを投稿したい(2020年3月24日 更新)

以前「投稿内容のid属性などを保存するための対策」で取り上げたように、WordPressでは投稿に記述できるHTMLタグが制限されている。同コラムでこの制限を調整する対策を紹介しているが、3.5以降ではフィルター関数を登録して対応できるようだ。

get_postsとquery_postsを使い分け(2018年5月27日 更新)

get_postsと query_postsは、どちらも複数の投稿情報を取得することができる便利な関数である。パラメータとして指定できる内容も共通しているものが多く、query_postsがより詳細なパラメータを指定でき、高機能になっている。

コメントの「ウェブサイト」止めました(2014年4月15日 更新)

とあるサイトのスパムコメントが多く、その都度のスパム指定するのが面倒である。これまでいくつか対策を行ってきたが、そういった対応にもいい加減うんざりしてきたので、試験的に「ウェブサイト」を無効化しようと思った。

ブロックエディターをちょっとだけカスタマイズしてみる(2021年11月3日 更新)

ブロックエディターで投稿を編集していると「ここは〇〇だったらいいのにな」と思うところがある。今回は、そんな気になるところをいくつか(自分好みに)調整してみた。