CakePHP3、CakePHP4のdatetime型カラムの日時の扱い。秒まで表示する方法

2019/07/27 2022/07/16

CakePHP3、CakePHP4の datetime型カラムを秒まで正しく表示したい！そんなときの対処方法

　
CakePHP3、CakePHP4で datetimeのカラムの年月日、時分秒を表示させたい場合は「i18nFormat()」を使用し、下記の様に記述します。
　

echo $users->created->i18nFormat('yyyy年MM月dd日 HH:mm:ss');

1	echo $users->created->i18nFormat('yyyy年MM月dd日 HH:mm:ss');

　
※Usersテーブルの createdカラムの日時を表示する想定です。
※「yyyy」は小文字で指定します。大文字だと違う値を取得してしまいます。
　
　
CakePHP3　Cookbook　日付と時刻・フォーマットする
https://book.cakephp.org/3.0/ja/core-libraries/time.html#id3
　
CakePHP4　Cookbook　日付と時刻・フォーマットする
https://book.cakephp.org/4/ja/core-libraries/time.html#id3
　
フォーマットの指定方法については以下を参照
https://www.php.net/manual/ja/class.intldateformatter.php
http://www.icu-project.org/apiref/icu4c/classSimpleDateFormat.html#details
　
　
※この記事は、CakePHP3向けの記事として書いたものですが、CakePHP4でも全く同様に動作することを確認しました。
　
　
　

　
CakePHP3、CakePHP4で Bakeを実行すると、datetime型の createdカラムのデフォルトで出力される表記は下記のようになります。
　

echo h($users->created);

1	echo h($users->created);

　
表示されるのは「1/1/19, 1:01 AM」のようになります。
　
　

　
これを「**年**月**日 **:**:**」形式で表示したい場合は、CakePHP3、CakePHP4であっても datetime型のカラムですので、普通の PHPの関数で日時を表示することも可能です。
　

echo date("Y年m月d日 H:i:s", strtotime(h($users->created);

1	echo date("Y年m月d日 H:i:s", strtotime(h($users->created);

　
表示されるのは「2019年01月01日 01:01:00」のようになります。
　
ですが、よくよく見ると「秒」の表示が常に「00」なのです。
　
　

　
これを正しく表示させる方法が、CakePHP3、CakePHP4には用意されています。
その方法が最初に紹介した下記の方法です。
　

echo $users->created->i18nFormat('yyyy年MM月dd日 HH:mm:ss');

1	echo $users->created->i18nFormat('yyyy年MM月dd日 HH:mm:ss');

　
表示されるのは「2019年01月01日 01:01:01」のようになります。
　
　
ちなみに、CakePHP3、CakePHP4では datetime型のカラムのデータを下記のようなオブジェクトとして保持しています。
　

Cake\I18n\FrozenTime Object
(
    [time] => 2019-01-01T01:01:01+00:00
    [timezone] => UTC
    [fixedNowTime] => 
)

Cake\I18n\FrozenTime Object

(

[time] => 2019-01-01T01:01:01+00:00

[timezone] => UTC

[fixedNowTime] =>

)

　
そのため、それを取り出すときは「i18nFormat()」でフォーマットを指定して取り出す、という仕様のようです。
　
　

　
ちなみに、createdや modifiedなどは必ず入力があるかと思いますが、deleted（削除日時カラム）などの入力がない可能性があるカラムの場合は、下記の様に入力がない場合の対処が必要です。
値がない場合はエラーとなりますので。
　

echo $users->deleted ? $users->deleted->i18nFormat('yyyy年MM月dd日 HH:mm:ss') : "";

1	echo $users->deleted ? $users->deleted->i18nFormat('yyyy年MM月dd日 HH:mm:ss') : "";

　
「i18nFormat()」の時だけに限らず、strtotime()関数でもエラーになります。
　
　

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

※入力いただいたコメントは管理者の承認後に掲載されます。

: CakePHP 2.3　Search Pluginで検索処理　その４前方一致検索、後方一致検索、不等号による検索、between句による範囲検索

CakePHPの検索プラグイン Search Pluginの検索処理の中で前方一致検索、後方一致検索、不等号による検索、between句による範囲検索の解説です。

: CakePHP3のUpload Plugin 3.0をバリデーションなど実運用向けのカスタマイズ方法解説・その２

CakePHP3でファイル、画像をアップロードするプラグイン、upload plugin 3を導入する手順を解説した記事。3部作のその2でバリデーションなどの実用的なカスタマイズ方法を解説。

: CakePHP3でcomposerを利用してライブラリ・プラグインをインストールする方法

CakePHP3でcomposerを使ってパッケージ（ライブラリ、プラグイン）をインストールする方法の解説。PHPを使うのはCakePHP3が初めてというような方への使い方から解説。

: CakePHP 2.3でファイルのアップロード処理を作る

CakePHPでプラグインを使わないファイルアップロード処理を解説します。簡単です。DBにファイルを格納する方法も。

: CakePHP3の画像、ファイルアップロードプラグインUpload Plugin 3.0の設置解説・その１

CakePHP3でファイル、画像をアップロードするプラグイン、upload plugin 3を導入する手順を解説した記事。3部作のその1で基本的な導入方法の解説で読みながら簡単に導入が可能。

: CakePHP 2.3　Search Pluginで検索処理　その３入力エリア一つで複数の項目を同時に検索する方法

CakePHPの検索プラグイン Search Pluginの検索処理の中で入力エリア一つで複数の項目を同時に検索する方法を解説。

: CakePHP 2.3　連携先のテーブルの項目で条件抽出する場合

アソシエーション（連携）している先のテーブルの項目で条件抽出する際の考え方と注意点をサンプルソースを用いて説明しています。

: CakePHP3でテーブルにカラム（項目）を追加したときに変更するポイントのまとめ

CakePHP3でシステム開発をする際、途中でカラムを追加した場合に何を変更すればいいかを確認。カラムを追加する前後で Bakeした結果を比較し、変更になった点をリストアップした。

: CakePHP4の定数定義ファイルを環境変数によって本番と開発を振り分ける方法解説

CakePHP4で開発環境と本番環境とで違う設定ファイルを読み込ませて環境ごとに定数を切り替える方法を解説。Apacheのhttpd.confに環境変数を設定しそれを読み込み判別する。

: CakePHP3でassociatedを使って関連データをまとめて保存する方法（hasOne、hasMany、belongsTo）

CakePHP3で関連データをまとめて保存する方法。hasOne、hasMany、belongsTo等の関連データはassociatedを追加することでまとめて保存することができます。