date_parse_from_format
指定した書式でフォーマットされた日付についての情報を取得する
&reftitle.description;
arraydate_parse_from_format
stringformat
stringdatetime
指定した日付/時刻についての詳細情報を連想配列で返します。
&reftitle.parameters;
format
format の使い方に関するドキュメントは、
DateTimeImmutable::createFromFormat
のそれを参照ください。同じルールが適用されます。
datetime
日付/時刻をあらわす文字列。
&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 が追加されます。
warning_count と warnings
が配列に含まれます。
最初のフィールドは、警告が何個発生したかを示します。
warnings 配列は、
警告を説明する文字列と一緒に、指定された datetime
のどの場所で警告が発生したかの位置を示します。
下記の例で、警告の例を示します。
error_count,
errors フィールドも配列に含まれます。
最初のフィールドは、エラーが何個発生したかを示します。
errors 配列のキーは、
警告を説明する文字列と一緒に、指定された datetime
のどの場所でエラーが発生したかの位置を示します。
下記の例で、エラーの例を示します。
warnings と
errors に含まれる配列の要素数は、
同じ箇所でエラーや警告が発生した場合、
warning_count や error_count
よりも少なくなる可能性があります。
&reftitle.errors;
datetime に NULLバイトが含まれている場合は、
ValueError がスローされます。
&reftitle.changelog;
&Version;
&Description;
8.0.21, 8.1.8, 8.2.0
datetime に NULLバイトが含まれている場合は、
ValueError がスローされるようになりました。
これより前のバージョンでは、こうした値は静かに無視されていました。
7.2.0
返される配列の zone 要素が、
分ではなく秒を表すようになり、
符号が逆になりました。
たとえば、
-120 は 7200 を表すようになります。
&reftitle.examples;
date_parse_from_format の例
&example.outputs;
2009
[month] => 1
[day] => 6
[hour] => 13
[minute] => 0
[second] => 0
[fraction] => 0
[warning_count] => 0
[warnings] => Array
(
)
[error_count] => 0
[errors] => Array
(
)
[is_localtime] => 1
[zone_type] => 1
[zone] => 3600
[is_dst] =>
)
]]>
date_parse_from_format の結果に警告が含まれる例
$message) {
echo "\tOn position {$position}: {$message}\n";
}
]]>
&example.outputs;
date_parse_from_format の結果にエラーが含まれる例
$message) {
echo "\tOn position {$position}: {$message}\n";
}
]]>
&example.outputs;
&reftitle.seealso;
DateTimeImmutable::createFromFormat
checkdate