【PHP8.x】date関数の使い方

Copy
1<?php
2
3/**
4 * 現在の日時を指定されたフォーマットで表示する
5 *
6 * @param string $format PHP の date() 関数で利用可能なフォーマット文字列
7 * @return string フォーマットされた現在の日時
8 */
9function displayCurrentDate(string $format): string
10{
11    // 現在のタイムスタンプを取得
12    $timestamp = time();
13
14    // タイムスタンプをフォーマットして返す
15    return date($format, $timestamp);
16}
17
18// 例：現在の日時を YYYY-MM-DD HH:MM:SS 形式で表示
19$formattedDate = displayCurrentDate("Y-m-d H:i:s");
20echo "現在の日時: " . $formattedDate . PHP_EOL;
21
22// 例：現在の日付を 年/月/日 形式で表示
23$formattedDate = displayCurrentDate("Y/m/d");
24echo "現在の日付: " . $formattedDate . PHP_EOL;

PHPのdate関数は、指定されたタイムスタンプを、指定されたフォーマットで文字列として返します。この関数を使うことで、日付や時刻を様々な形式で表示することができます。

引数は2つあります。1つ目の引数 $format は必須で、日付や時刻のフォーマットを指定する文字列です。例えば、"Y-m-d H:i:s" は「年-月-日 時:分:秒」という形式で表示することを意味します。PHPの公式ドキュメントには、利用可能なフォーマット文字が詳細に記載されています。

2つ目の引数 $timestamp は省略可能です。これは日付をフォーマットする対象となるタイムスタンプを指定します。タイムスタンプとは、1970年1月1日午前0時0分0秒（UTC）からの経過秒数を表す数値です。time()関数を使うと、現在のタイムスタンプを取得できます。$timestampを省略した場合、date関数は現在のタイムスタンプを使用します。

サンプルコードでは、displayCurrentDateという関数を作成し、date関数を使って現在の日時を指定されたフォーマットで表示しています。この関数は、フォーマット文字列を受け取り、現在のタイムスタンプをdate関数に渡して、フォーマットされた日付文字列を返します。

例えば、displayCurrentDate("Y-m-d H:i:s")と呼び出すと、現在の日時が「年-月-日 時:分:秒」の形式で表示されます。また、displayCurrentDate("Y/m/d")と呼び出すと、現在の日付が「年/月/日」の形式で表示されます。date関数とフォーマット文字列を組み合わせることで、様々な形式で日付や時刻を扱うことが可能です。

Copy
1<?php
2
3/**
4 * 現在の日時を指定されたフォーマットで表示する
5 *
6 * @return string フォーマットされた日時
7 */
8function displayCurrentDate(): string
9{
10    // フォーマットを指定 (例: 年-月-日 時:分:秒)
11    $format = 'Y-m-d H:i:s';
12
13    // 現在のタイムスタンプを取得
14    $timestamp = time();
15
16    // date()関数を使用して日時をフォーマット
17    $formattedDate = date($format, $timestamp);
18
19    return $formattedDate;
20}
21
22// 関数を実行して結果を表示
23echo displayCurrentDate();
24// 出力例: 2024-10-27 10:00:00 (実行時の日時に依存)
25
26?>

PHPのdate関数は、指定されたタイムスタンプを基に、指定されたフォーマットで日付と時刻を文字列として返す関数です。この関数を利用することで、日付や時刻の表示形式を柔軟に制御できます。

引数は2つあります。必須の引数である$formatは、日付と時刻のフォーマットを指定する文字列です。例えば、'Y-m-d H:i:s'というフォーマット文字列は、年（4桁）、月、日、時、分、秒をそれぞれハイフンやコロンで区切って表示することを意味します。PHPが解釈できる様々なフォーマット文字が利用可能です。

オプションの引数$timestampは、フォーマットするタイムスタンプを指定します。タイムスタンプは、Unixエポック（1970年1月1日 00:00:00 UTC）からの経過秒数を示す整数値です。$timestampを省略した場合、time()関数によって返される現在のタイムスタンプが使用されます。

戻り値は、フォーマットされた日付と時刻を表す文字列です。サンプルコードでは、displayCurrentDate()関数内でdate()関数を使用し、現在のタイムスタンプを基に'Y-m-d H:i:s'形式で日付と時刻をフォーマットしています。echo displayCurrentDate();で関数を実行すると、現在の日時が指定されたフォーマットで表示されます。この関数を使用することで、アプリケーション内で日付や時刻を様々な形式で表示することができます。

Copy
1<?php
2
3/**
4 * PHPのdate()関数を使用して、現在時刻と指定したタイムスタンプを
5 * さまざまなフォーマットで表示するサンプルコードです。
6 *
7 * date()関数は、UNIXタイムスタンプを、指定されたフォーマットの日付文字列に変換します。
8 * 第2引数のタイムスタンプを省略した場合、現在のローカル時刻が使用されます。
9 */
10function displayDateExamples(): void
11{
12    echo "--- 現在の日付と時刻の表示 ---\n";
13
14    // 現在の日付と時刻を一般的なフォーマットで表示
15    // Y: 年 (4桁), m: 月 (2桁), d: 日 (2桁)
16    // H: 時 (24時間形式, 2桁), i: 分 (2桁), s: 秒 (2桁)
17    echo "現在時刻: " . date("Y-m-d H:i:s") . "\n";
18
19    // 現在の日付を読みやすい形式で表示
20    // l: 曜日 (完全な名前), F: 月 (完全な名前), j: 日 (先行ゼロなし), Y: 年 (4桁)
21    echo "今日の曜日と日付: " . date("l, F j, Y") . "\n";
22
23    // 現在のUNIXタイムスタンプを表示
24    // U: UNIXタイムスタンプ (1970年1月1日 00:00:00 GMT からの秒数)
25    echo "現在のUNIXタイムスタンプ: " . date("U") . "\n";
26
27    echo "\n--- 特定のタイムスタンプの日付と時刻の表示 ---\n";
28
29    // 特定のUNIXタイムスタンプを生成 (例: 2023年1月1日 12:30:00)
30    // strtotime()関数は、日付/時刻の英語表記文字列をUNIXタイムスタンプに変換します。
31    $specificTimestamp = strtotime("2023-01-01 12:30:00");
32    echo "指定したタイムスタンプ: " . $specificTimestamp . "\n";
33
34    // 生成したタイムスタンプを一般的なフォーマットで表示
35    echo "その日時の表示: " . date("Y-m-d H:i:s", $specificTimestamp) . "\n";
36
37    // 今から1年後の日付のタイムスタンプを生成
38    $futureTimestamp = strtotime("+1 year");
39    echo "1年後の日付: " . date("Y-m-d", $futureTimestamp) . "\n";
40
41    echo "\n--- その他のフォーマット例 ---\n";
42    // 月を3文字の略語で表示 (Jan, Febなど)
43    echo "月 (短縮形): " . date("M") . "\n";
44    // 時間を12時間形式で表示 (先行ゼロなし) と午前/午後
45    echo "時間 (12時間形式): " . date("g A") . "\n";
46}
47
48// 関数を実行して、日付と時刻の例を表示します。
49displayDateExamples();
50

PHPのdate()関数は、指定されたフォーマットで日付と時刻の文字列を生成するために使用されます。第一引数 $format は、日付と時刻のフォーマットを指定する文字列です。例えば、"Y-m-d H:i:s" は、年-月-日 時:分:秒 の形式で表示されます。"l, F j, Y" は、曜日、月、日、年の形式で表示されます。

第二引数 $timestamp は、オプションの引数で、日付をフォーマットする対象となるUNIXタイムスタンプを指定します。UNIXタイムスタンプは、1970年1月1日00:00:00 UTCからの経過秒数です。もし $timestamp が省略された場合、date()関数は現在のローカル時刻を使用します。

strtotime()関数を使うと、日付や時刻を表す文字列をUNIXタイムスタンプに変換できます。例えば、strtotime("2023-01-01 12:30:00") は、2023年1月1日12時30分のUNIXタイムスタンプを返します。また、strtotime("+1 year") は、現在時刻から1年後のUNIXタイムスタンプを返します。

date()関数は、フォーマットされた日付と時刻の文字列を返します。この関数を使うことで、日付や時刻を様々な形式で表示したり、計算したりすることが可能です。

Copy
1<?php
2
3/**
4 * 現在の日時を指定されたフォーマットで表示する
5 *
6 * @param string $format PHP date() 関数で利用可能なフォーマット文字列
7 * @return string フォーマットされた現在の日時
8 */
9function getCurrentFormattedDate(string $format): string
10{
11  return date($format);
12}
13
14// 例：現在の日時を YYYY-MM-DD HH:MM:SS 形式で表示
15$currentDateTime = getCurrentFormattedDate('Y-m-d H:i:s');
16echo "現在の日時: " . $currentDateTime . PHP_EOL;
17
18// 例：現在の日付を 年/月/日 形式で表示
19$currentDate = getCurrentFormattedDate('Y/m/d');
20echo "現在の日付: " . $currentDate . PHP_EOL;
21
22// 例：現在時刻を 時:分:秒 形式で表示
23$currentTime = getCurrentFormattedDate('H:i:s');
24echo "現在時刻: " . $currentTime . PHP_EOL;

PHPのdate関数は、指定されたフォーマットに基づいて日付や時刻を文字列として取得するために使用されます。第一引数$formatは必須で、どのような形式で日付や時刻を表示するかを定義する文字列です。'Y-m-d H:i:s'のように、年、月、日、時、分、秒などを組み合わせて指定できます。PHPが提供する様々なフォーマット指定子を利用することで、様々な形式で日付や時刻を表現できます。

第二引数$timestampは省略可能で、タイムスタンプを指定します。タイムスタンプとは、1970年1月1日0時0分0秒（UTC）からの経過秒数を表す数値です。$timestampを省略した場合、現在の時刻が使用されます。

このサンプルコードでは、getCurrentFormattedDateという関数を定義し、date関数を使って現在の日時を指定されたフォーマットで取得しています。getCurrentFormattedDate関数は、フォーマット文字列を引数として受け取り、date関数に渡して結果を返します。

サンプルコードでは、'Y-m-d H:i:s'、'Y/m/d'、'H:i:s'といった様々なフォーマット文字列を使用し、それぞれ現在の日時、日付、時刻を表示しています。PHP_EOLは改行コードを表し、出力結果を見やすくするために使用しています。date関数は文字列を返すため、echo文でそのまま出力できます。date関数は、日付や時刻に関する処理を行う上で非常に重要な関数です。