説明
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
関連
お勧め
個人データのエクスポートメール向けに追加された新フィルター（2020年4月2日 更新）
先週「WordPress 5.4 RC3」が公開され、正式リリースまであと1週間。ブロックエディターの機能強化が目立つわけですが、地味な変更点もちらほらと。今回はその中の1つ、「個人データのエクスポート」機能に関連するフィルターを紹介する。
決まった値を返すだけの関数群（2018年5月27日 更新）
WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。
サイドバーの初期化はwidgets_initアクションで（2011年7月14日 更新）
ウィジェットを使ってみたくなり新テーマ「Twenty Eleven」を覗いてみると、codexに記載されていた内容と少し違っている。これって「Twenty Ten」ですでに変更されていたんだね。Gutenbergでカスタムフィールドを使う（2018年8月10日 更新）
Gutenbergの新エディターではカスタムフィールドのウィジェットが表示されない。既存のカスタムフィールドのデータはなくなるわけでないので、新エディター上で編集・更新できないか調べてみた。
favicon.icoがWordPressロゴになる！？（2020年2月25日 更新）
先週「WordPress 5.4 Beta2」が公開され、来月末には正式リリース。タイミングよく三連休だったので、1つ前の「ニュース」で紹介されていた変更点から確認してみた。