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

<?php

/**
 * Demonstrates a common "bug" or unexpected behavior of strtotime
 * when parsing two-digit years, which can lead to incorrect date interpretations.
 *
 * PHP's strtotime function interprets two-digit years (YY) based on a 70-year window
 * relative to the current century. Specifically:
 * - Years from 00-69 are typically interpreted as 20xx (e.g., '60' becomes 2060).
 * - Years from 70-99 are typically interpreted as 19xx (e.g., '70' becomes 1970).
 *
 * This behavior can cause issues if the intended century differs from strtotime's assumption.
 */
function demonstrateStrtotimeTwoDigitYearParsingBug(): void
{
    echo "--- strtotime Two-Digit Year Parsing Bug Demonstration ---\n\n";

    // Example 1: Year '60' (often intended as 1960, but parsed as 2060 by strtotime)
    $dateString1 = "01/01/60";
    $timestamp1 = strtotime($dateString1);

    if ($timestamp1 === false) {
        echo "Error: Could not parse '{$dateString1}'\n";
    } else {
        echo "Input: '{$dateString1}'\n";
        echo "Parsed Full Date: " . date('Y-m-d', $timestamp1) . "\n";
        echo "  (Unexpectedly parsed as 2060, not 1960)\n\n";
    }

    // Example 2: Year '70' (often intended as 2070, but parsed as 1970 by strtotime)
    $dateString2 = "12-25-70";
    $timestamp2 = strtotime($dateString2);

    if ($timestamp2 === false) {
        echo "Error: Could not parse '{$dateString2}'\n";
    } else {
        echo "Input: '{$dateString2}'\n";
        echo "Parsed Full Date: " . date('Y-m-d', $timestamp2) . "\n";
        echo "  (Parsed as 1970, which might be intended, or unintended if 2070 was expected)\n\n";
    }

    // Example 3: Year '23' (commonly intended as 2023, and parsed as 2023)
    $dateString3 = "2023-03-23"; // Using 4-digit year for clarity, but demonstrating 2-digit implication
    $timestamp3 = strtotime($dateString3);

    if ($timestamp3 === false) {
        echo "Error: Could not parse '{$dateString3}'\n";
    } else {
        echo "Input: '{$dateString3}'\n";
        echo "Parsed Full Date: " . date('Y-m-d', $timestamp3) . "\n";
        echo "  (When '23' is used with another format like '03/23', it's still 2023)\n\n";
    }

    echo "--- Key Takeaway for System Engineers ---\n";
    echo "To avoid ambiguity and potential bugs with strtotime's two-digit year parsing,\n";
    echo "ALWAYS use four-digit years (YYYY) in your date strings when possible.\n";
    echo "Alternatively, for strict parsing of specific formats, consider using the DateTime::createFromFormat() method.\n";
}

// Execute the demonstration function to see the output
demonstrateStrtotimeTwoDigitYearParsingBug();

PHPのstrtotime関数は、人間が読みやすいさまざまな形式の日付文字列を、コンピュータが扱いやすいUNIXタイムスタンプ（1970年1月1日00:00:00 UTCからの秒数）に変換する便利な関数です。引数$datetimeに日付文字列を渡して利用し、オプションで基準となるUNIXタイムスタンプ$baseTimestampを指定することも可能です。変換に成功した場合はタイムスタンプを整数で返し、失敗した場合はfalseを返します。

この関数は柔軟性が高い一方で、二桁の年（YY）を解釈する際に注意が必要な挙動があります。strtotimeは、二桁年を現在の世紀を基準とした70年間の窓で自動判別します。具体的には、「00」から「69」までの年は20xx年（例: '60'は2060年）として解釈され、「70」から「99」までの年は19xx年（例: '70'は1970年）として解釈されます。

この自動判別は、開発者の意図と異なる日付の解釈を引き起こすことがあり、「バグ」として認識されることがあります。例えば、サンプルコードで示されるように、「01/01/60」は1960年を意図しても2060年と解析されてしまいます。逆に「12-25-70」は1970年と解析され、2070年を意図していた場合には誤解釈となります。

このような曖昧さや意図しない日付の解釈を避けるためには、日付文字列には常に四桁の年（YYYY）を使用することが強く推奨されます。また、特定の厳密なフォーマットで日付を解析したい場合は、DateTime::createFromFormat()メソッドの利用を検討してください。これにより、予期せぬ問題を防ぎ、堅牢なシステムを構築できます。

<?php

/**
 * strtotime関数を使って、現在時刻から1日前をUNIXタイムスタンプで取得するサンプルコード。
 */
function getYesterdayTimestamp(): int|false
{
  // 現在時刻を基準に1日前を表す文字列をstrtotimeに渡す。
  $yesterday = strtotime("1 day ago");

  // 取得できなかった場合はfalseを返す。
  return $yesterday;
}

// 関数を実行して結果を表示する。
$yesterdayTimestamp = getYesterdayTimestamp();

if ($yesterdayTimestamp !== false) {
  echo "昨日のUNIXタイムスタンプ: " . $yesterdayTimestamp . PHP_EOL;
  echo "昨日の日付: " . date("Y-m-d H:i:s", $yesterdayTimestamp) . PHP_EOL;
} else {
  echo "日付の取得に失敗しました。" . PHP_EOL;
}

strtotime関数は、日付を表す文字列をUnixタイムスタンプ（1970年1月1日午前0時0分0秒からの経過秒数）に変換するPHPの組み込み関数です。引数には、変換したい日付文字列 $datetime を指定します。オプションとして、基準となるUnixタイムスタンプ $baseTimestamp を指定することも可能です。$baseTimestamp を省略した場合、現在の時刻が基準となります。

このサンプルコードでは、strtotime("1 day ago") を使用して、現在時刻から1日前のUnixタイムスタンプを取得しています。"1 day ago" は「1日前」を意味する日付文字列です。strtotime関数は、変換に成功した場合はUnixタイムスタンプを整数値で返し、失敗した場合は false を返します。

サンプルコードでは、getYesterdayTimestamp 関数内で strtotime 関数を呼び出し、その結果を $yesterday 変数に格納しています。そして、$yesterday が false でないことを確認してから、Unixタイムスタンプと、date関数を使ってフォーマットした日付文字列を表示します。date 関数は、Unixタイムスタンプを指定したフォーマットの日付文字列に変換する関数です。strtotime関数とdate関数を組み合わせることで、日付計算や表示形式の変更が容易になります。

<?php

/**
 * strtotime関数を使用して日付や時刻を加算する様々な例を示します。
 *
 * strtotimeは日付/時刻の文字列をUnixタイムスタンプに変換しますが、
 * 相対的な日時表現を用いることで、日付の加算（または減算）を簡単に行うことができます。
 */
function demonstrateStrtotimeAddition(): void
{
    // 現在のUnixタイムスタンプと、それが表す日時を表示
    $currentTimestamp = time();
    echo "現在のUnixタイムスタンプ: " . $currentTimestamp . "\n";
    echo "現在の日時: " . date('Y-m-d H:i:s', $currentTimestamp) . "\n\n";

    // --- 例1: 現在の日付から1日後を計算 ---
    // strtotimeの第一引数に相対的な日付表現を指定し、第二引数を省略すると、現在時刻が基準となります。
    $oneDayLaterTimestamp = strtotime('+1 day');
    if ($oneDayLaterTimestamp !== false) {
        echo "1日後のUnixタイムスタンプ: " . $oneDayLaterTimestamp . "\n";
        echo "1日後の日時: " . date('Y-m-d H:i:s', $oneDayLaterTimestamp) . "\n\n";
    } else {
        echo "1日後の計算に失敗しました。\n\n";
    }

    // --- 例2: 特定の日付から3ヶ月後を計算 ---
    // 第二引数に基準となるタイムスタンプを指定することで、特定の日付からの加算が可能です。
    $baseDateString = '2023-04-15 10:00:00';
    $baseTimestamp = strtotime($baseDateString);

    if ($baseTimestamp === false) {
        echo "基準日 ('" . $baseDateString . "') の解析に失敗しました。\n\n";
        return; // 解析失敗時はこれ以上処理を進めない
    }

    echo "基準となる日時: " . date('Y-m-d H:i:s', $baseTimestamp) . "\n";
    $threeMonthsLaterTimestamp = strtotime('+3 months', $baseTimestamp);

    if ($threeMonthsLaterTimestamp !== false) {
        echo "基準日から3ヶ月後のUnixタイムスタンプ: " . $threeMonthsLaterTimestamp . "\n";
        echo "基準日から3ヶ月後の日時: " . date('Y-m-d H:i:s', $threeMonthsLaterTimestamp) . "\n\n";
    } else {
        echo "3ヶ月後の計算に失敗しました。\n\n";
    }

    // --- 例3: 現在の時刻から1時間30分後を計算 ---
    // 時間単位での加算も可能です。
    $oneHourThirtyMinutesLaterTimestamp = strtotime('+1 hour 30 minutes');
    if ($oneHourThirtyMinutesLaterTimestamp !== false) {
        echo "1時間30分後のUnixタイムスタンプ: " . $oneHourThirtyMinutesLaterTimestamp . "\n";
        echo "1時間30分後の日時: " . date('Y-m-d H:i:s', $oneHourThirtyMinutesLaterTimestamp) . "\n\n";
    } else {
        echo "1時間30分後の計算に失敗しました。\n\n";
    }
}

// 関数を実行し、日付加算の例を出力
demonstrateStrtotimeAddition();

PHPのstrtotime関数は、人間が読みやすい日付や時刻の文字列を、コンピューターが扱いやすいUnixタイムスタンプ（1970年1月1日 00:00:00 UTCからの秒数）に変換する際に使用されます。この関数の強力な機能の一つとして、日付や時刻の加算（または減算）を簡単に行うことができます。

第一引数$datetimeには、日付や時刻の文字列を指定します。ここで「+1 day」や「+3 months」「+1 hour 30 minutes」といった相対的な日時表現を使用することで、指定された期間の日時を加算（または減算）できます。第二引数$baseTimestampはオプションで、加算の基準となるUnixタイムスタンプを指定します。この引数を省略した場合、現在時刻が基準となります。

関数が成功すると、加算後の日付や時刻を表すUnixタイムスタンプ（整数値）が返されます。もし指定された文字列を解析できなかった場合は、falseが返されるため、戻り値がfalseでないかを確認することが重要です。

サンプルコードでは、現在の日時から「1日後」や「1時間30分後」を計算する例を示しています。また、特定の日時（例: '2023-04-15 10:00:00'）を基準として「3ヶ月後」を計算するために、第二引数にその基準となるタイムスタンプを渡す方法も示しています。これにより、様々な要件に応じた柔軟な日付計算が可能です。