【PHP8.x】formatメソッドの使い方

Copy
1<?php
2
3// 現在の日時を取得
4$date = new DateTime();
5
6// フォーマットを指定して日付を文字列に変換
7$formattedDate = $date->format('Y-m-d H:i:s');
8
9// 結果を出力
10echo "現在の時刻: " . $formattedDate . PHP_EOL;
11
12// 別のフォーマットを試す
13$formattedDate2 = $date->format('D, M j, Y g:i a');
14
15// 結果を出力
16echo "別のフォーマット: " . $formattedDate2 . PHP_EOL;
17
18// タイムゾーンを指定して日付をフォーマット
19$tokyo = new DateTimeZone('Asia/Tokyo');
20$dateTokyo = new DateTime('now', $tokyo);
21
22//東京の現在時刻をフォーマット
23$formattedDateTokyo = $dateTokyo->format('Y年m月d日 H時i分s秒');
24
25// 結果を出力
26echo "東京の現在時刻: " . $formattedDateTokyo . PHP_EOL;

このPHPのサンプルコードは、DateTimeクラスのformatメソッドを使って、日付と時刻を指定された形式の文字列に変換する方法を示しています。

まず、new DateTime()で現在の日時を表すDateTimeオブジェクトを作成します。formatメソッドは、引数にフォーマット文字列を受け取り、それに基づいて日付を整形します。フォーマット文字列には、年、月、日、時間などを表すための特定の文字（例：Yは4桁の年、mは2桁の月）を使用します。

例えば、$date->format('Y-m-d H:i:s')は、日付をYYYY-MM-DD HH:MM:SSの形式で文字列に変換します。formatメソッドは、整形された日付文字列を返します。サンプルコードでは、複数の異なるフォーマットを指定して、日付の表示形式を柔軟に変更できることを示しています。

さらに、タイムゾーンを指定して日付をフォーマットする方法も示しています。DateTimeZoneクラスを使ってタイムゾーンを指定し、DateTimeオブジェクトを作成する際にそれを渡すことで、特定地域の現在時刻を取得し、フォーマットできます。例として、Asia/Tokyoタイムゾーンを指定して、東京の現在時刻をYYYY年MM月DD日 HH時ii分ss秒という形式で表示しています。

formatメソッドは、日付と時刻を様々な形式で表示する必要がある場合に非常に便利です。引数$formatに指定するフォーマット文字列によって、戻り値の文字列が変化します。

Copy
1<?php
2
3// 現在の日時を表す DateTime オブジェクトを作成します。
4$dateTime = new DateTime();
5
6// 'Y-m-d H:i:s' 形式で日時をフォーマットします。
7$formattedDateTime = $dateTime->format('Y-m-d H:i:s');
8
9// フォーマットされた日時を出力します。
10echo $formattedDateTime . PHP_EOL;
11
12// 異なる形式で日時をフォーマットします。
13$formattedDate = $dateTime->format('Y年m月d日');
14echo $formattedDate . PHP_EOL;
15
16// タイムゾーンを指定してフォーマット
17$tokyoDateTime = new DateTime('now', new DateTimeZone('Asia/Tokyo'));
18$formattedTokyoDateTime = $tokyoDateTime->format('Y-m-d H:i:s');
19echo $formattedTokyoDateTime . PHP_EOL;

PHPのDateTimeクラスのformatメソッドは、DateTimeオブジェクトが保持する日時を指定された形式の文字列に変換するために使用します。引数には、日付と時刻のフォーマットを指定する文字列 $format を渡します。このフォーマット文字列は、年、月、日、時間、分、秒などを表す特定の文字を含みます。例えば、'Y-m-d H:i:s' は、年-月-日 時:分:秒 の形式で日時を表示します。

サンプルコードでは、まず new DateTime() で現在の日時を表すDateTimeオブジェクトを作成しています。次に、format('Y-m-d H:i:s') を呼び出すことで、この日時を 'Y-m-d H:i:s' 形式の文字列に変換し、$formattedDateTime 変数に格納しています。echo でこのフォーマットされた日時を出力します。

別の例として、format('Y年m月d日') を使用すると、'Y年m月d日' という形式で日付を表示できます。このように、format メソッドに渡す文字列を変更することで、様々な形式で日時を表現できます。

さらに、タイムゾーンを指定してDateTimeオブジェクトを作成し、それをフォーマットすることも可能です。new DateTime('now', new DateTimeZone('Asia/Tokyo')) は、現在時刻をAsia/Tokyo（東京）のタイムゾーンでDateTimeオブジェクトとして生成します。その後、format('Y-m-d H:i:s') で東京の現在日時をフォーマットし、表示しています。

formatメソッドは文字列型 (string) の値を返し、これはフォーマットされた日時を表します。このメソッドを利用することで、アプリケーションの要件に合わせて柔軟に日時を表示できます。