WordPress 5.3 は１１月にリリース予定ですが、以下の様な記事を見つけました。

新しい日時の関数とフィルターが導入されるという事で、日時の関数とフィルターを多数使用している自分のプラグイン Wareki をベータ版でテストした所、動作しない箇所があったので修正しました。その際に、いろいろテストしたので一部の関数とフィルターを以下に紹介します。

Wareki

日付のフォーマット、投稿、コメント、アーカイブ、カレンダーに元号を含む日本の暦を追加します。

作者: Katsushi Kawamori

(3) 最終更新: 2日 前

200以上サイトで有効化中 検証済み: 7.0

ダウンロード: リリース: 2019-04-02

2026-03-31 09:30 時点の統計

関数

wp_date( $format, $timestamp = null, $timezone = null )

date_i18n 関数の後継だと思います。

• 第１引数 PHP の日時のフォーマット
• 第２引数 Unix タイムスタンプ
• 第３引数 タイムゾーン
• 返り値 書式化された日時の文字列もしくは False

第３引数がポイントでデフォルトではサイトで設定したタイムゾーンが入ってきます。使い方は以下の様に書きます。現在の日時を出すだけなら、第２引数・第３引数は省略します。

$date_ux = 1569422086;
$date = wp_date( 'Y-m-d H:i:s', $date_ux, new DateTimeZone( 'UTC' ) );

以前 data_i18n 関数では、前後のコード次第で９時間ずれたりして苦労した事があったのですが、この関数ではそのような事はなくなりました。

current_datetime()

以下の様な日時のオブジェクトを返します。

DateTimeImmutable Object ( [date] => 2019-09-25 23:34:46.584458 [timezone_type] => 3 [timezone] => Asia/Tokyo ) 

フィルター

apply_filters( 'wp_date', $date, $format, $timestamp, $timezone )

• 第１引数 書式化された日時の文字列
• 第２引数 PHP の日時のフォーマット
• 第３引数 Unix タイムスタンプ
• 第４引数 タイムゾーン返り値 日時の文字列もしくは False

新元号が「令和」に決まりました。「令和」がとても気に入ってしまったのと、ちょうど桜の花が綺麗で気分が高揚した勢いで「Wareki」という日付を和暦にするプラグインを作成してしまいました。

Wareki

日付のフォーマット、投稿、コメント、アーカイブ、カレンダーに元号を含む日本の暦を追加します。

作者: Katsushi Kawamori

(3) 最終更新: 2日 前

200以上サイトで有効化中 検証済み: 7.0

ダウンロード: リリース: 2019-04-02

2026-03-31 09:30 時点の統計

初めは、get_the_date、get_the_modified_date、get_the_comment_date、フィルターを利用して、日付を書き換えていたのですが、テーマによっては、これらのフィルターが使えずに、 get_the_time、get_the_modified_time、フィルターを利用する事になりました。フィルターが多くなり過ぎて、面倒になり、設定->一般->日付のフォーマットに和暦のフォーマットを追加する事を思いつきました。functions.php の date_i18n関数 を見たらフィルターを提供しているようなので使用してみました。

コード

/* ==================================================
 * Construct
 * @since	1.00
 */
public function __construct() {

	// 日付のフォーマット
	add_filter( 'date_formats', array( $this, 'wareki_date_formats' ), 10, 1 );
	// 時刻フォーマット
	add_filter( 'time_formats', array( $this, 'wareki_time_formats' ), 10, 1 );
	// date_i18n フィルター
	add_filter( 'date_i18n', array( $this, 'wareki_date_i18n' ), 10, 4 );

}

/* ==================================================
 * Date Format Hook
 * @param	array	$date_array
 * @since	1.10
 */
public function wareki_date_formats( $date_array ) {

	// 元号を K とし、元号の略号を k とする
	$add_array = array( "K年n月j日", "k年n月j日" );

 	return array_merge($date_array, $add_array);

}

/* ==================================================
 * Time Format Hook
 * @param	array	$time_array
 * @since	1.10
 */
public function wareki_time_formats( $time_array ) {

	// 午前午後を E とする
	$add_array = array( "Eg時i分" );

 	return array_merge($time_array, $add_array);

}

/* ==================================================
 * Wareki date_i18n Hook
 * @param	string	$j
 * @param	string	$req_format
 * @param	int	$i
 * @param	bool	$gmt
 * @return	string	$j
 * @since	1.10
 */
public function wareki_date_i18n( $j, $req_format, $i, $gmt ) {

	// それぞれのフォーマット文字が見つかったら、
	// タイムスタンプ $i、文字 $j などを関数に送り、
	// 変更した文字を返す。
	if ( strpos($req_format, 'K') !== false ) {
		$j = $this->gengo_date_i18n( $i, $j, 'K' );
	}

	if ( strpos($req_format, 'k') !== false ) {
		$j = $this->gengo_date_i18n( $i, $j, 'k' );
	}

	if ( strpos($req_format, 'E') !== false ) {
		$j = $this->ampm_date_i18n( $i, $j);
	}

	return $j;

}

/* ==================================================
 * Gengo date_i18n
 * @param	int	$timestamp
 * @param	string	$j
 * @param	string	$k
 * @return	string	$j
 * @since	1.10
 */
private function gengo_date_i18n( $timestamp, $j, $k ) {

	// タイムスタンプを受け取り判断
	// とりあえず令和と平成のみ

	$reiwa = 1556636400;
	$year = intval(date_i18n('Y', $timestamp));

	if ( $reiwa <= $timestamp ) {
		$y = $year - 2019 + 1;
		if ( $y == 1 ) $y = "元";
		if ( $k == 'K' ) {
			$gengo = "令和";
		} else if ( $k == 'k' ) {
			$gengo = "R";
		}
		$j = str_replace($k, $gengo.$y, $j);
	} else {
		$y = $year - 1989 + 1;
		if ( $y == 1 ) $y = "元";
		if ( $k == 'K' ) {
			$gengo = "平成";
		} else if ( $k == 'k' ) {
			$gengo = "H";
		}
		$j = str_replace($k, $gengo.$y, $j);
	}

	return $j;

}

/* ==================================================
 * AM PM date_i18n
 * @param	int	$timestamp
 * @param	string	$j
 * @return	string	$j
 * @since	1.10
 */
private function ampm_date_i18n( $timestamp, $j) {

	// タイムスタンプを受け取り判断
	// 午前か午後を返す

	$ampm = date_i18n('a', $timestamp);
	if ( $ampm == 'am') {
		$e = "午前";
	} else {
		$e = "午後";
	}

	$j = str_replace("E", $e, $j);

	return $j;

}

各種画面

設定

投稿

プラグイン（Legacy Google Calendar Events 2.4 ）のイベント画面

おわりに

get_the_date、get_the_modified_date、get_the_comment_date、get_the_time、get_the_modified_time フィルターが不要になりました。

なお、年別、月別、日別、アーカイブとウィジェットにはこの方法は使用できません。