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()関数でもエラーになります。
　
　

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

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

: CakePHP4、5のnewEmptyEntityで作成したオブジェクトは空なのか、確認してみた

CakePHPでレコードを新規登録をする際にnewEmptyEntity()を使って空のEntityを作成するが、これのempty、is_nullなどのでの判定結果がtrueかfalseか確認してみた。

: CakePHP3のタイムゾーンを協定世界時UTCから日本標準時間JSTにずれを変更する方法

CakePHP3の標準設定のタイムゾーンは「UTC（協定世界時）」に設定されている。これを日本標準時に変更する方法（app.php、bootstrap.phpの変更方法）の解説。

: CakePHP3にOGPをfetch、asignを利用してテンプレートごとに指定する方法を解説

CakePHP3でOGPを設定する方法を解説。fetch、assignを使用しレイアウトファイルに編集した変数にテンプレートファイルから値を指定する。これを利用してOGPを編集する。

: CakePHP3のInsert On Duplicate Key Update（upsert）構文を解説・バルク処理も

CakePHP3で Insert … On Duplicate Key Update構文（upsert）を実行する方法を解説。バルク処理の方法も用意されているため大量処理の場合も対応可能。

: CakePHP3の検索プラグイン「friendsofcake/search」の様々な検索の仕方の実装方法

CakePHP3で検索をするプラグイン「friendsofcake/search」の検索条件のカスタマイズ方法の解説。検索項目を増やしたり、以上、以下での検索や、チェックボックスによる検索の方法などを解説。