mysql2date() の使い方｜説明・引数・注意点

説明

基本構文

mysql2date( string $format, string $date, bool $translate = true ): string|int|false

引数

• $format：書式
• $date：MySQL形式の日時
• $translate：翻訳するか

戻り値

書式化した日付。

使い方（サンプル）

echo esc_html( mysql2date( 'Y/m/d', '2026-10-03 12:00:00' ) );

注意点

• 投稿の post_date の整形によく使います。

実務での使いどころ

• データベースの日時の文字列（Y-m-d H:i:s）を、書式を指定して、整形するとき。

よくあるミスと対処

• post_date（サイトの時刻）と post_date_gmt（GMT）を、取り違えて渡し、時刻がずれる。
• 書式の指定を、間違えている。
• 整形した値を、エスケープせずに、出力している。

NG例

echo mysql2date( 'Y年n月j日', $post->post_date_gmt ); // GMTの日時を、サイトの時刻として扱っている

OK例

echo esc_html( mysql2date( 'Y年n月j日', $post->post_date ) );

使い分け早見表

関連項目

wp_date()、get_the_date()

公式リファレンス：mysql2date() | Function | WordPress Developer Resources