【PHP8.x】DATE_ISO8601定数の使い方

Copy
1<?php
2
3/**
4 * 現在の日付と時刻をISO 8601形式で取得する関数。
5 *
6 * DATE_ISO8601 定数を使用して、日付と時刻を標準的なISO 8601形式の文字列としてフォーマットします。
7 * この形式は、異なるシステム間での日付情報の交換によく用いられます。
8 *
9 * @return string ISO 8601形式でフォーマットされた現在の日付と時刻の文字列。
10 */
11function getCurrentIso8601Date(): string
12{
13    // 現在のUNIXタイムスタンプを取得します。
14    // time() 関数は現在時刻のUNIXタイムスタンプを返します。
15    $currentTimestamp = time();
16
17    // date() 関数を使用して、UNIXタイムスタンプをISO 8601形式の文字列に変換します。
18    // 第一引数にフォーマット文字列として DATE_ISO8601 定数を指定します。
19    // 第二引数にはフォーマット対象のUNIXタイムスタンプを指定します。
20    return date(DATE_ISO8601, $currentTimestamp);
21}
22
23// 上記関数を呼び出し、結果を出力して確認します。
24echo "現在のISO 8601形式の日付と時刻: " . getCurrentIso8601Date() . PHP_EOL;
25
26?>

このPHPコードは、現在の日付と時刻をISO 8601という国際標準形式で取得し、表示するものです。

中心となるのは、DATE_ISO8601という定数です。これは、date()関数に渡すことで、日付と時刻を「YYYY-MM-DDTHH:MM:SS+ZZZZ」のような形式（例: 2023-10-27T10:30:00+0900）でフォーマットするよう指示します。このISO 8601形式は、異なるシステムや国との間で日付情報を正確にやり取りする際によく利用されます。

コードでは、まずtime()関数を使って現在のUNIXタイムスタンプ（1970年1月1日からの経過秒数を表す数値）を取得しています。time()関数は引数なしで、現在のタイムスタンプを整数で返します。次に、このタイムスタンプとDATE_ISO8601定数をdate()関数に渡しています。date()関数は、第一引数に指定されたフォーマット（今回の場合はISO 8601）に従って、第二引数に与えられたUNIXタイムスタンプを読みやすい日付と時刻の文字列に変換します。この関数の戻り値は、フォーマットされた日付と時刻を表す文字列です。

最終的に、getCurrentIso8601Date()関数が呼び出され、現在の日付と時刻がISO 8601形式の文字列として返され、echo文によって画面に出力されます。これにより、プログラムの実行時点での正確なISO 8601形式の日時を確認できます。

Copy
1<?php
2
3/**
4 * 現在の日時を ISO 8601 フォーマットで取得し、出力する関数。
5 *
6 * DATE_ISO8601 定数は、ISO 8601 (例: 2004-02-12T15:19:21+00:00) フォーマットを表す文字列です。
7 * これは date() 関数のフォーマット引数として使用することで、日付をこの標準形式で出力できます。
8 */
9function displayCurrentIso8601Date(): void
10{
11    // date() 関数と DATE_ISO8601 定数を使用して、現在の日時を ISO 8601 フォーマットで取得
12    $iso8601Date = date(DATE_ISO8601);
13
14    echo "現在の日時 (ISO 8601 フォーマット): " . $iso8601Date . PHP_EOL;
15}
16
17// 関数の実行
18displayCurrentIso8601Date();
19
20?>

PHP 8で利用できるDATE_ISO8601は、日付と時刻を国際標準化機構が定めたISO 8601形式で表現するための定数です。この定数自体に引数はなく、その値はISO 8601フォーマットを表す特定の文字列（例: 2004-02-12T15:19:21+00:00）そのものです。

ISO 8601形式は、異なるシステム間で日時情報を正確に交換する際の国際的な標準として広く利用されています。PHPでは、このDATE_ISO8601定数をdate()関数の第一引数（フォーマット文字列）として使用することで、現在の日時を簡単にこの標準形式で取得できます。

サンプルコードでは、date(DATE_ISO8601)と記述することにより、現在の日時がISO 8601形式の文字列として取得され、$iso8601Date変数に格納された後、画面に出力されます。このように、DATE_ISO8601定数を利用することで、日付のフォーマットを詳細に記述する手間を省き、国際的に通用する形式で日時を扱えるため、システム連携を伴う開発において非常に便利です。