date_parse 指定した日付/時刻の詳細な情報を連想配列で返す &reftitle.description; arraydate_parse stringdatetime date_parse は、 strtotime や DateTimeImmutable::__construct と同じルールに従って datetime をパースします。 Unixタイムスタンプ (strtotime の場合) や DateTimeImmutable (DateTimeImmutable::__construct の場合) を返す代わりに、指定した datetime から検知できた情報を連想配列として返します。 あるグループの要素に関する情報が見つからなかった場合、 そうした情報は &false; に設定されたり、存在しない状態になります。 datetime に指定する文字列から、 同等のタイムスタンプや DateTimeImmutable オブジェクトを構築する必要がある場合、 より多くのフィールドを &false; でない値に設定できます。 そうしたことが起こる場合については、 以下に示す例を参照ください。 &reftitle.parameters; datetime DateTimeImmutable::__construct が理解できる書式の日付/時刻。 &reftitle.returnvalues; パースした日付/時刻情報を含む配列を返します。 返される配列は、 year, month, day, hour, minute, second, fraction, is_localtime というキーを持ちます。 is_localtime が存在する場合、 zone_type がタイムゾーンのタイプを示します。 タイプ 1 (UTC オフセット) の場合、 zone と is_dst フィールドが追加されます。 タイプ 2 (省略形) の場合、 tz_abbr と is_dst フィールドが追加されます。 タイプ 3 (タイムゾーン識別子) の場合、 tz_abbr, tz_id が追加されます。 +3 days のような、 相対時刻の文字列が datetime に存在する場合、返される配列には、relative をキーとしたネストされた配列が含まれます。 この配列には、year, month, day, hour, minute, second が含まれ、 渡される文字列に応じて、必要があれば weekday, weekdays も含まれます。 warning_count と warnings が配列に含まれます。 最初のフィールドは、警告が何個発生したかを示します。 warnings 配列は、 警告を説明する文字列と一緒に、指定された datetime のどの場所で警告が発生したかの位置を示します。 error_count, errors フィールドも配列に含まれます。 最初のフィールドは、エラーが何個発生したかを示します。 errors 配列は、 警告を説明する文字列と一緒に、指定された datetime のどの場所でエラーが発生したかの位置を示します。 warnings と errors に含まれる配列の要素数は、 同じ箇所でエラーや警告が発生した場合、 warning_count や error_count よりも少なくなる可能性があります。 &reftitle.errors; 日付/時刻フォーマットにエラーがある場合は、 'errors' 要素にエラーメッセージが格納されます。 &reftitle.changelog; &Version; &Description; 7.2.0 返される配列の zone 要素が、 分ではなく秒を表すようになり、 符号が逆になりました。 たとえば、 -120 は 7200 を表すようになります。 &reftitle.examples; &example.outputs; int(2006) ["month"]=> int(12) ["day"]=> int(12) ["hour"]=> int(10) ["minute"]=> int(0) ["second"]=> int(0) ["fraction"]=> float(0.5) ["warning_count"]=> int(0) ["warnings"]=> array(0) { } ["error_count"]=> int(0) ["errors"]=> array(0) { } ["is_localtime"]=> bool(false) } ]]> 指定された datetime にタイムゾーン情報が含まれた場合にのみ、 タイムゾーンの要素が現れるようになります。 この場合、zone_type 要素が常に存在し、 値によっては少し多くの要素が含まれます。 &example.outputs; int(2022) ["month"]=> int(6) ["day"]=> int(2) ["hour"]=> int(10) ["minute"]=> int(28) ["second"]=> int(17) ["fraction"]=> float(0) ["warning_count"]=> int(0) ["warnings"]=> array(0) { } ["error_count"]=> int(0) ["errors"]=> array(0) { } ["is_localtime"]=> bool(true) ["zone_type"]=> int(2) ["zone"]=> int(0) ["is_dst"]=> bool(true) ["tz_abbr"]=> string(3) "BST" } ]]> &example.outputs; int(2022) ["month"]=> int(6) ["day"]=> int(2) ["hour"]=> int(10) ["minute"]=> int(28) ["second"]=> int(17) ["fraction"]=> float(0) ["warning_count"]=> int(0) ["warnings"]=> array(0) { } ["error_count"]=> int(0) ["errors"]=> array(0) { } ["is_localtime"]=> bool(true) ["zone_type"]=> int(3) ["tz_id"]=> string(13) "Europe/London" } ]]> さらに最低限の文字列を datetime に与えてパースさせた場合、 情報量はさらに少なくなります。以下の例では、 全ての時刻に関する情報が &false; になります。 &example.outputs; int(2022) ["month"]=> int(6) ["day"]=> int(2) ["hour"]=> bool(false) ["minute"]=> bool(false) ["second"]=> bool(false) ["fraction"]=> bool(false) ["warning_count"]=> int(0) ["warnings"]=> array(0) { } ["error_count"]=> int(0) ["errors"]=> array(0) { } ["is_localtime"]=> bool(false) } ]]> 相対的な書式 は 絶対的な書式のパース結果に影響を及ぼさず、別途 "relative" 要素にまとめられます。 &example.outputs; int(2006) ["month"]=> int(12) ["day"]=> int(12) ["hour"]=> int(10) ["minute"]=> int(0) ["second"]=> int(0) ["fraction"]=> float(0.5) ["warning_count"]=> int(0) ["warnings"]=> array(0) { } ["error_count"]=> int(0) ["errors"]=> array(0) { } ["is_localtime"]=> bool(false) ["relative"]=> array(6) { ["year"]=> int(0) ["month"]=> int(0) ["day"]=> int(7) ["hour"]=> int(1) ["minute"]=> int(0) ["second"]=> int(0) } } ]]> Thursday のように、 語句によっては、文字列の時刻の部分に 0 を設定するものがあります。 Thursday を DateTimeImmutable::__construct に与えた場合、hour, minute, second は 0 に設定されます。 以下の例では、year の要素は &false; に設定されます。 &example.outputs; bool(false) ["month"]=> int(6) ["day"]=> int(2) ["hour"]=> int(0) ["minute"]=> int(0) ["second"]=> int(0) ["fraction"]=> float(0) ["warning_count"]=> int(0) ["warnings"]=> array(0) { } ["error_count"]=> int(0) ["errors"]=> array(0) { } ["is_localtime"]=> bool(false) ["relative"]=> array(7) { ["year"]=> int(0) ["month"]=> int(0) ["day"]=> int(0) ["hour"]=> int(0) ["minute"]=> int(0) ["second"]=> int(0) ["weekday"]=> int(4) } } ]]> &reftitle.seealso; 指定されたフォーマットに従って datetime をパースする DateTimeImmutable::parseFromFormat checkdate getdate