DateTimeImmutable::getLastErrors

    (PHP 5 >= 5.5.0, PHP 7, PHP 8)

    DateTimeImmutable::getLastErrors — 警告およびエラーを返す

    説明

    public static DateTimeImmutable::getLastErrors(): array|false

    日付/時刻文字列のパース時に見つかった警告やエラーの配列を返します。

    パラメータ

    この関数にはパラメータはありません。

    戻り値

    警告やエラーに関する情報を含む配列を返します。 警告やエラーがない場合は false を返します。

    変更履歴

    バージョン 説明
    8.2.0 PHP 8.2.0 より前のバージョンでは、 この関数は警告やエラーがない場合でも false を返しませんでした。 代わりに、例に示している、警告やエラーに関する情報を含む配列を常に返していました。

    例

    例1 DateTimeImmutable::getLastErrors() の例

    <?php
    try {
    $date = new DateTimeImmutable('asdfasdf');
    } catch (    Exception $e) {
    // 使用例を出したかっただけ...
    print_r(DateTimeImmutable::getLastErrors());

    // オブジェクト指向流にやるなら、本来は以下のように書くべき
    // echo $e->getMessage();
    }
    ?>

    上の例の出力は以下となります。

    Array
(
   [warning_count] => 1
   [warnings] => Array
       (
           [6] => Double timezone specification
       )

   [error_count] => 1
   [errors] => Array
       (
           [0] => The timezone could not be found in the database
       )

)

    この出力のインデックス 6 と 0 は、エラーが発生した文字列内での文字の位置を表します。

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    0
    _mittens
    1 year ago
    If you are curious as to when the internal array gets resetted (from https://onlinephp.io/c/3ee35):

    <?php

    $date0     = DateTimeImmutable::createFromFormat('!Y-m-d', '2020-31-31');
    var_dump($date0->format('c')); // 2022-07-31T00:00:00+00:00

    foreach(range(0,2) as $_)
    // The internal error won't reset
    var_dump( join(DateTimeImmutable::getLastErrors()['warnings']) ); // The parsed date was invalid

    $date1 = DateTimeImmutable::createFromFormat('!Y-m-d', '2020-12-31');
    var_dump($date1->format('c')); // 2020-12-31T00:00:00+00:00

    // The internal error did reset
    var_dump( empty(DateTimeImmutable::getLastErrors()['warnings']) ); // true

    $date2 = DateTimeImmutable::createFromFormat('!Y-m-d', '2020-31-31');
    var_dump( join(DateTimeImmutable::getLastErrors()['warnings']) ); // The parsed date was invalid
    $date3 = new DateTimeImmutable('2023-12-31T00:00:00.000000Z');

    // The internal error did reset
    var_dump( empty(DateTimeImmutable::getLastErrors()['warnings']) ); // true
    ?>

    Output:
    string(25) "2022-07-31T00:00:00+00:00"
    string(27) "The parsed date was invalid"
    string(27) "The parsed date was invalid"
    string(27) "The parsed date was invalid"
    string(25) "2020-12-31T00:00:00+00:00"
    bool(true)
    string(27) "The parsed date was invalid"
    bool(true)
    ＋add a note
    To Top