トップページ　→関数リファレンス　→日付および時刻関連　→Date/Time　→日付・時刻関数

関数・クラス解説

strptime

version:PHP 5 >= 5.1.0, PHP 7 (公式)

strftime() が生成した日付/時刻をパースする

公式リファレンス

書式

strptime ( string $date , string $format ) : array|false

説明

strptime() は date をパースした結果を配列で返します。エラー時には FALSE を返します。

月名や曜日、そしてその他の言語依存な文字列は setlocale() (LC_TIME) で設定された現在のロケールを考慮して返します。

パラメータ

date (string): パースする文字列（例: strftime() の返り値）。
format (string): date で使用されているフォーマット（例: strftime() で使用されていたものと同じ）。 strftime() で使えるオプションの中には、 strptime() では何の影響を及ぼさないものがあることに注意しましょう。実際にサポートする範囲がどのようになるのかは、使っている OS と C ライブラリに依存します。フォーマットオプションについての詳細は strftime() のページを参照ください。

返値

成功した場合は配列、失敗した場合に FALSE を返します。

配列で返されるパラメータ
パラメータ	説明
"tm_sec"	分未満の秒数 (0-61)
"tm_min"	時間未満の分数 (0-59)
"tm_hour"	0 時以降の時間数 (0-23)
"tm_mday"	月内の日数 (1-31)
"tm_mon"	1 月から数えた月数 (0-11)
"tm_year"	1900 年以降の年
"tm_wday"	日曜日からの日数 (0-6)
"tm_yday"	1 月 1 日からの日数 (0-365)
"unparsed"	date の中で、指定された format で判断できなかった部分

注意

注意: この関数は Windows 環境にはまだ実装されていません。

注意: 内部では、この関数はシステムの C ライブラリ関数 strptime() をコールしています。このライブラリ関数は、OS によって挙動が異なることがあります。 date_parse_from_format() はこの問題の影響を受けないので、PHP 5.3.0 以降ではこちらの関数を使うことを推奨します。

注意: "tm_sec" には、うるう秒も組み込まれています (現在は、年間 2 秒まで)。うるう秒についての詳細な情報は » Wikipedia の記事を参照ください。

注意: PHP 5.2.0 より前のバージョンでは、この関数が未定義の挙動をすることがありました。特に "tm_sec"、"tm_min" および "tm_hour" が未定義の値になることがありました。

サンプル

例1 strptime() の例 

$format = '%d/%m/%Y %H:%M:%S';
$strf = strftime($format);

echo "$strf\n";

print_r(strptime($strf, $format));

 上の例の出力は、たとえば以下のようになります。 
03/10/2004 15:54:19

Array
(
    [tm_sec] => 19
    [tm_min] => 54
    [tm_hour] => 15
    [tm_mday] => 3
    [tm_mon] => 9
    [tm_year] => 104
    [tm_wday] => 0
    [tm_yday] => 276
    [unparsed] =>
)

参考

checkdate() - グレゴリオ暦の日付/時刻の妥当性を確認します

strftime() - ロケールの設定に基づいてローカルな日付・時間をフォーマットする

date_parse_from_format() - 指定した書式でフォーマットされた日付についての情報を取得する

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

ワード検索

※入力キーワードが、関数名・説明文・タグに含まれるものを検索

関数名アルファベット別

A	B	C	D	E	F	G	H	I	J
K	L	M	N	O	P	Q	R	S	T
U	V	W	X	Y	Z	_

最終更新一覧

●stristr
　大文字小文字を区別せず文字列を検索し、ヒット箇所以降（あるいは以前）の文字列を返却

●stripslashes
　バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

●stripos
　大文字小文字を区別せずに文字列が最初に現れる位置を取得する

●stripcslashes
　addcslashes() でクォートされた文字列をアンクォートする

●strip_tags
　文字列から HTML と PHP のタグを除去して返却

●strcspn
　指定した文字が最初に現れる位置を調べる

●strcoll
　ロケールに基づいて2つの文字列を比較し同じか（あるいは大小）を判定する

●strcmp
　2つの文字列を比較し同じか（あるいは大小）を判定する

●strchr
　strstr() のエイリアス

●strcasecmp
　2つの文字列を比較（大文字小文字を区別せず同じとみなす）

カテゴリー一覧

PHP の振る舞いの変更
 音声フォーマットの操作
 認証サービス
 コマンドライン関連
 圧縮およびアーカイブ
 暗号
 データベース関連
 日付および時刻関連
 ファイルシステム
 自然言語および文字エンコーディング
 画像処理および作成
 メール関連
 数学
 テキスト以外の MIME 型
 プロセス制御
 その他の基本モジュール
 その他のサービス
 検索エンジン用の拡張モジュール
 サーバー固有のモジュール
 セッション関連
 テキスト処理
 変数・データ型関連
 ウェブサービス
 Windows 用のモジュール
 XML 操作
 GUI用の拡張モジュール