« DateTime::__construct
DateTime::createFromImmutable »

DateTime::createFromFormat

date_create_from_format

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

DateTime::createFromFormat -- date_create_from_format — 指定した書式で時刻文字列をパースする

説明

オブジェクト指向型

public static function DateTime::createFromFormat(string $format, string $datetime, ?DateTimeZone $timezone = null): DateTime|false

手続き型

function date_create_from_format(string $format, string $datetime, ?DateTimeZone $timezone = null): DateTime|false

新しい DateTime オブジェクトを返します。 このオブジェクトは、datetime で指定した文字列を format で指定した書式に沿って解釈した時刻を表します。

DateTimeImmutable::createFromFormat() や date_create_immutable_from_format() と似ていますが、 DateTime オブジェクトを生成します。

このメソッドドキュメントは、パラメータや使用例、注意点も含めて DateTimeImmutable::createFromFormat のページにあります。

パラメータ

DateTimeImmutable::createFromFormat も参照ください。

戻り値

新しい DateTime のインスタンスを返します。失敗した場合に false を返します。

エラー / 例外

datetime に NULLバイトが含まれている場合は、 ValueError がスローされます。

変更履歴

バージョン 説明
8.0.21, 8.1.8, 8.2.0 datetime に NULLバイトが含まれている場合は、 ValueError がスローされるようになりました。 これより前のバージョンでは、こうした値は静かに無視されていました。

例

豊富な例が、DateTimeImmutable::createFromFormat のページにあるので参照ください。

参考

関連キーワード:
DateTime   createFromFormat   format   時刻   datetime   DateTimeImmutable   書式   パース   date   create   DateTimeZone   timezone   バイト   ValueError   construct   createFromImmutable   オブジェクト指向   static   手続き   解釈   immutable   ドキュメント   注意点   インスタンス   履歴
関連する関数・ページ:
function.date-create   function.date-create-from-format   datetime.construct   function.date-create-immutable-from-format   ref.datetime   datetime.createfromimmutable