説明
string human_time_diff( int $from [ , int $to = '' ] )
時間差を'5分'や'2日'のような感覚的な表現で取得する。
パラメータ
- $from比較する時刻（GMT秒）を指定。
- $to比較するもう1つの時刻（GMT秒）を指定（省略時は''）。
返り値
時間差を示す文字列を返す。注意
パラメータ$toが省略された（''の）場合は、呼び出し時点の時刻が適用される。パラメータ$fromと$toの差のみを評価し、前後の判定は行わない。
出力される文字列は次の形式となる（言語設定によって変わる）。
| 時間差 | 日本語環境 | 英語環境 |
|---|---|---|
| 1分未満* | n秒 | n second または n seconds |
| 1時間未満 | n分 | n min または n mins |
| 1時間以上24時間未満 | n時間 | n hour または n hours |
| 24時間以上7日未満 | n日 | n day または n days |
| 7日以上30日未満 | n週 | n week または n weeks |
| 30日以上365日未満 | nか月 | n month または n months |
| 365日以上 | n年 | n year または n years |
*[5.3.0]時間差が1分未満の場合に秒単位で表示するようになった。
使用例
- 投稿情報$postがいつ投稿されたのかを取得する。<?php $diff = human_time_diff( $post->post_date ); ?>
フィルター
[4.0.0]時差を示す文字列を返す直前で'human_time_diff'フィルターを呼び出す。パラメータ$sinceは時差を示す文字列、$diffは時差の秒数、$fromと$toは本関数が受け取った値となる。return apply_filters( 'human_time_diff', $since, $diff, $from, $to );
アクション
直接実行するアクションはありません。ソースファイル
/wp-includes/formatting.php最終更新 : 2019年11月18日 14:48
関連
お勧め
固定ページを投稿ページ用テンプレートファイル（single.php）で表示する（2013年7月31日 更新）
固定ページと投稿ページのデザインが共通の場合、同じ内容のsingle.phpとpage.phpを用意すれば事足りるが、デザインの修正時は二度手間になってしまう。そこで、固定ページをsingle.phpで表示するようにできないか考えてみた。
タイトルが一致する投稿を検索する（2014年2月20日 更新）
WordPressが提供する投稿ページの文字列検索機能の実現には、 query_posts関数（WP_Queryクラス）が大きな役割を担っている。ここで紹介するのは、高機能ゆえに使いこなすのが難しいquery_posts関数（WP_Queryクラス）の使用法の一例である。
フォーム内のエスケープ処理を考える（2018年10月19日 更新）
WordPressにはエスケープ処理を行う esc_html関数と esc_attr関数がある。HTML要素（タグ）の属性値ならesc_attr関数を、それ以外はesc_html関数を使うことがほとんどだが、今回esc_html関数が適していないと思われるケースに遭遇した。
ダッシュボードのフィードボックスをカスタマイズ（2011年7月8日 更新）
管理者ページのトップページ「ダッシュボード」には、「WordPress 開発者ブログ」と「WordPress フォーラム」という2つのフィードボックスが表示されている。自分のような開発者には有益な情報をもたらしているが、一般の方には必要のない情報かもしれない。今回はこのフィードボックスをカスタマイズする方法を紹介する（管理者権限）。classic editorプラグインを試してみた（2018年12月10日 更新）
WordPress 5.0 beta1のリリースにあわせて旧エディター環境を実現できる「classic editor」（バージョン0.5.0）が公開された。自分が公開しているプラグインの一部が旧エディター環境に依存していることもあり、さっそく試してみた。WordPress 5.0正式リリースに合わせてclassic editorも1.0がリリースされたので、それについて追記しました。