date_i18n

(0.71以降)
date_i18n - 日付／時刻を書式化した文字列を取得する

説明

string date_i18n( string $dateformatstring, mixed $unixtimestamp = false, bool $gmt = false )
日付／時刻を書式化した文字列を取得する

パラメータ

  • $dateformatstring
    日時フォーマットの文字列を指定
  • $unixtimestamp
    UNIXタイムスタンプ（秒）を指定（省略時はfalse）
  • $gmt
    タイムゾーンGMTを有効にする場合はtrueを、現在のロケールの場合はfalseを指定（省略時はfalse）

返り値

日時を書式化した文字列を返す。

注意

PHPのdate関数は、タイムゾーンがUTCになっているため日本（JST）の書式化したテキストを取得できないため、このdate_i18n関数を使用すると便利。フォーマットはPHPのdate関数とほぼ同じである。

使用例

  • 現在の日付／時刻を書式化した文字列を取得する。
    <?php $text = date_i18n( 'Y-m-d H:i' ); ?>

フィルター

書式化した文字列を返す直前に'date_i18n'フィルターを呼び出す。パラメータ$jには返す直前の書式化した文字列は、$req_formatが書式フォーマットが、$iにはタイムスタンプが格納される。 
$j = apply_filters( 'date_i18n', $j, $req_format, $i, $gmt );

アクション

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

ソースファイル

/wp-includes/functions.php

関連

  • human_time_diff - 時間差を感覚的な表現で取得する
  • mysql2date - MySQLの日時情報を変換する
  • number_format_i18n - 数値を1000位毎にグループ化して国際化対応にフォーマットする

参考

Code Reference: date_i18n

お勧めコンテンツ

開発環境（Windows 8）にimagickを入れる（2012年12月23日 登録）

WordPress 3.5のイメージエディタ（WP_Image_Editor）は、GDだけでなく、imagick（ImageMagick）にも対応している。そんなわけでWindows 8の開発環境にimagickをインストールしてみた。

投稿日の検索が自由自在に（2013年10月30日 登録）

WordPress 3.7.0ではWP_Date_Queryクラスが追加され、WP_Queryクラス（もちろんquery_posts関数でも）で利用できるようになった。このWP_Date_Queryにより、○年○月○日以前や以降の投稿情報を取得したり、○年○月○日から○年○月○日の範囲の投稿情報を取得したりといったことが、容易に行えるようになった。

Post-tag automaton：プラグイン作ってみました（2012年7月3日 登録）

みなさんは投稿をポストする際に投稿タグを付け忘れたことはないでしょうか。このプラグインは、投稿をポストする際にタイトルと記事に投稿タグが含まれていないか調べ、含まれていた場合はその投稿タグを追加します。

プラグインで注意が必要な関数（2013年11月27日 登録）

先日「Login rebuilder」という自作プラグインをアップデートした際、ユーザーさんからエラーになると連絡をいただいた。標準環境では問題なく、どうやら何らかのプラグインが影響しているらしい。

4.2.3でちょっと変わったショートコード（2015年7月25日 登録）

4.3のリリースまであと少しなわけですが、4.2.3が緊急リリースされました。4.2.2とソースコードを比較すると、ざっくりTinyMCE絡みが多い印象を受けたのですが、ショートコード関連も少し変わっていたので簡単にまとめてみました。

最終更新日時 : 2014-02-05 12:39