PHP date_create_immutable_from_format() ファンクションの用法と例

PHP Date & Time ファンクションマニュアル

date_create_immutable_from_format()関数は指定されたフォーマットで時間文字列を解析します

定義と用法

date_create_immutable_from_format()関数はDateTimeImmutable::createFromFormat()の別名です。この関数は時間文字列とフォーマット文字列を引数に取り、指定されたフォーマットで時間文字列を解析し、DateTimeImmutableオブジェクトを返します。

文法

date_create_immutable_from_format($date,　$time　[,$timezone])

パラメータ

返り値

date_create_immutable_from_format()関数はDateTimeオブジェクトを表す文字列を返します。失敗した場合、この関数は布尔値を返しますfalse。

PHPバージョン

この関数は最初にPHPバージョン5.5PHPバージョン5.3.0で導入され、すべてのより高いバージョンで使用できます。

オンライン例

以下の例では、date_create_immutable_from_format()関数の使い方-

<?php
　　　//DateTimeオブジェクトを作成する
　　　$date　=　"1989-08-25";
　　　$format　=　"Y-m-d";
　　　$res　=　date_create_immutable_from_format($format,　$date);
　　　print("Date:　".date_format($res,　"Y-m-d"));
?>

出力結果

Date:　1989-08-25

オンライン例

今、オプションのtimezoneパラメータを渡してみましょう-

<?php
　　　//DateTimeオブジェクトを作成する
　　　$date　=　"1989-08-25";
　　　$format　=　"Y-m-d";
　　　$tz　=　new　DateTimeZone('Asia/Shanghai');　　
　　　$res　=　date_create_immutable_from_format($format,　$date,　$tz);
　　　print　date_format($res,　"Y-m-d");
?>

出力結果

1989-08-25

オンライン例

以下の例では、異なるフォーマットを持つdate_create_immutable_from_format()を示しています-

<?php
　　　$res1　=　date_create_immutable_from_format("j.n.Y",　"25.8.2014");
　　　print(date_format($res1,　"Y-m-d"));
　　　print("\n");
　　　$res2　=　date_create_immutable_from_format('Y-d-m　H:i:s',　'2014-25-08　12:20:25');
　　　print(date_format($res2,　"Y-m-d　H:i:s"));　　
?>

以下の結果が生成されます-

2014-08-25
2014-08-25　12:20:25