WindowsのXAMPPのPHPではstrptimeは使用不可。代替はdate_parse_from_formatを使う

2024/08/03 2024/08/10

Windowsの PHPには strptimeは未実装。代替は date_parse_from_format

　
Linuxで動作していたシステムのメンテナンスを行うため、Windowsに XAMPP環境を構築し、そこで動作をさせてみました。
　
そうしたところ、「strptime()」でエラーが出ました。
エラーメッセージは、以下の通りでした。
　
Fatal error: Uncaught Error: Call to undefined function strptime() in C:\xampp\htdocs\test.php:999 Stack trace: #0 {main} thrown in C:\xampp\htdocs\test.php on line 999
　
「『strptime』はないよぅ」という内容です。
　
　
ちなみに、「strptime()」は、与えられた文字列が、指定した日時のフォーマットに沿っているか、その日時が存在する日時か、をチェックする関数です。
日時を引数として受け取る祭に、プログラム内で使用する前に正しい日時のフォーマットであることを確認するような場面で使用します。
　
　

PHPのマニュアルに Windowsの PHPに strptimeは未実装と書いてある

　
https://www.php.net/manual/ja/function.strptime.php
　
PHPの標準的なコマンドだと思っていましたが、いろいろ調べてみた結果、マニュアルにしっかりと書かれていました。
　

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

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

　
　
改めて、手元にある XAMPP環境で確認したところ、下記のいずれにも入っていませんでしたので、バージョンの問題でもないようです。
　PHP5.6.24
　PHP7.3.2
　PHP8.1.4
　
　
https://www.php.net/manual/ja/function.strptime.php
また、上記のマニュアルの最初の方に下記のように書いてあります。
　

警告：この関数は PHP 8.1.0 で 非推奨になります。この関数に頼らないことを強く推奨します。

1	警告：この関数は PHP 8.1.0 で非推奨になります。この関数に頼らないことを強く推奨します。

　
つまりは、「まだ実装されていません」の「まだ」は、「まだ」と言いつつ、非推奨になることを期待して放置したのではないか、と疑問に感じるところです。
　
　

「strptime()」と「date_parse_from_format()」の違いと実装方法

　
それはさておき、Windows環境の XAMPPでは「strptime()」は使えませんので、代替の関数として用意されている「date_parse_from_format()」を使うとよさそうです。
https://www.php.net/manual/ja/function.date-parse-from-format.php
　
ただ、「strptime()」と「date_parse_from_format()」とでは少し挙動が異なりますので、単純に「strptime」を「date_parse_from_format」に置き換えるだけ、というわけにはいかないようです。
　
では、詳しく確認していきましょう。
　
　

「strptime()」と「date_parse_from_format()」の違い：実装の方法

　
「strptime()」と「date_parse_from_format()」を使用して、年月日が正しいかどうかをチェックする処理を行います。
　

<?php
$datetime = '2024-08-03';

echo "<br>■strptime<br><ｐｒｅ>";
var_export(strptime($datetime, '%Y-%m-%d'));
echo "</ｐｒｅ>";
if(strptime($datetime, '%Y-%m-%d')){
  echo "true:strptime";
} else {
  echo "false:strptime";
}
echo "　<br>";

echo "<br>■date_parse_from_format<br><ｐｒｅ>";
var_export(date_parse_from_format('Y-m-d', $datetime));
echo "</ｐｒｅ>";
if(date_parse_from_format('Y-m-d', $datetime)){
  echo "true:date_parse_from_format";
} else {
  echo "false:date_parse_from_format";
}

<?php

$datetime = '2024-08-03';

echo " ■strptime <ｐｒｅ>";

var_export(strptime($datetime, '%Y-%m-%d'));

echo "</ｐｒｅ>";

if(strptime($datetime, '%Y-%m-%d')){

echo "true:strptime";

} else {

echo "false:strptime";

}

echo "　 ";

echo " ■date_parse_from_format <ｐｒｅ>";

var_export(date_parse_from_format('Y-m-d', $datetime));

echo "</ｐｒｅ>";

if(date_parse_from_format('Y-m-d', $datetime)){

echo "true:date_parse_from_format";

} else {

echo "false:date_parse_from_format";

}

「strptime()」と「date_parse_from_format()」の違い・引数の順番が違う

　
実装方法の 1つめの違いは、「strptime()」と「date_parse_from_format()」とで引数の、チェックする対象の変数と、日時のフォーマットの順番が逆になっています。
　
チェック対象の変数が、「strptime()」は第一引数なのに対し、「date_parse_from_format()」は第二引数になっています。
　
　

「strptime()」と「date_parse_from_format()」の違い・日時のフォーマットの指定形式が違う

　
実装方法の 2つ目の違いは、日時をチェックするためのフォーマットの指定形式が異なります。
　
「2024-08-03」をチェックするにあたって、「strptime()」では「%Y-%m-%d」と指定しますが、「date_parse_from_format()」では「Y-m-d」となります。
　
　
各項目のフォーマットに関しては、下記の PHPのマニュアルを参照してください。
　
PHPマニュアル　DateTimeImmutable::createFromFormat
https://www.php.net/manual/ja/datetimeimmutable.createfromformat.php
　
　

「strptime()」と「date_parse_from_format()」の違い：実行結果

　
「strptime()」と「date_parse_from_format()」とでは、実装方法も異なりますが、実行結果（レスポンス）も異なります。
　
前項のサンプルプログラムを実行した結果が下記になります。
　

■strptime
array (
  'tm_sec' => 0,
  'tm_min' => 0,
  'tm_hour' => 0,
  'tm_mday' => 3,
  'tm_mon' => 7,
  'tm_year' => 124,
  'tm_wday' => 6,
  'tm_yday' => 215,
  'unparsed' => '',
)

true:strptime　

■date_parse_from_format
array (
  'year' => 2024,
  'month' => 8,
  'day' => 3,
  'hour' => false,
  'minute' => false,
  'second' => false,
  'fraction' => false,
  'warning_count' => 0,
  'warnings' => 
  array (
  ),
  'error_count' => 0,
  'errors' => 
  array (
  ),
  'is_localtime' => false,
)

true:date_parse_from_format

■strptime

array (

'tm_sec' => 0,

'tm_min' => 0,

'tm_hour' => 0,

'tm_mday' => 3,

'tm_mon' => 7,

'tm_year' => 124,

'tm_wday' => 6,

'tm_yday' => 215,

'unparsed' => '',

)

true:strptime　

■date_parse_from_format

array (

'year' => 2024,

'month' => 8,

'day' => 3,

'hour' => false,

'minute' => false,

'second' => false,

'fraction' => false,

'warning_count' => 0,

'warnings' =>

array (

'error_count' => 0,

'errors' =>

array (

'is_localtime' => false,

)

true:date_parse_from_format

　
年、月、日などの値が入っている配列のキー名称も異なりますが、値がない場合の結果の表記も異なります。
　
　

「strptime()」と「date_parse_from_format()」の違い・正しくない日時のレスポンスが全く違う

正しくない「`2024-08-33`」を日時として与えた場合

　
前項では、正しい年月日が入力された場合の処理ですが、ここでは、正しくない「2024-08-33」を日時として与えた場合の確認をしてみます。
　

$datetime = '2024-08-33';

echo "<br>■strptime<br><ｐｒｅ>";
var_export(strptime($datetime, '%Y-%m-%d'));
echo "</ｐｒｅ>";
if(strptime($datetime, '%Y-%m-%d')){
  echo "true:strptime";
} else {
  echo "false:strptime";
}
echo "　<br>";

echo "■date_parse_from_format<br><ｐｒｅ>";
var_export(date_parse_from_format('Y-m-d', $datetime));
echo "</ｐｒｅ>";
if(date_parse_from_format('Y-m-d', $datetime)){
  echo "true:date_parse_from_format";
} else {
  echo "false:date_parse_from_format";
}

$datetime = '2024-08-33';

echo " ■strptime <ｐｒｅ>";

var_export(strptime($datetime, '%Y-%m-%d'));

echo "</ｐｒｅ>";

if(strptime($datetime, '%Y-%m-%d')){

echo "true:strptime";

} else {

echo "false:strptime";

}

echo "　 ";

echo "■date_parse_from_format <ｐｒｅ>";

var_export(date_parse_from_format('Y-m-d', $datetime));

echo "</ｐｒｅ>";

if(date_parse_from_format('Y-m-d', $datetime)){

echo "true:date_parse_from_format";

} else {

echo "false:date_parse_from_format";

}

　
　
以下が、上記の結果となります。
　

■strptime

false

false:strptime　
■date_parse_from_format

array (
  'year' => 2024,
  'month' => 8,
  'day' => 33,
  'hour' => false,
  'minute' => false,
  'second' => false,
  'fraction' => false,
  'warning_count' => 1,
  'warnings' => 
  array (
    10 => 'The parsed date was invalid',
  ),
  'error_count' => 0,
  'errors' => 
  array (
  ),
  'is_localtime' => false,
)

true:date_parse_from_format

■strptime

false

false:strptime　

■date_parse_from_format

array (

'year' => 2024,

'month' => 8,

'day' => 33,

'hour' => false,

'minute' => false,

'second' => false,

'fraction' => false,

'warning_count' => 1,

'warnings' =>

array (

10 => 'The parsed date was invalid',

'error_count' => 0,

'errors' =>

array (

'is_localtime' => false,

)

true:date_parse_from_format

　
上記を確認すると明らかな違いがあります。
　
「strptime()」では「false」を返して終了です。
　
ですが、「date_parse_from_format()」は情報を返してくれます。
また、「'warning_count' => 1」「'warnings' => array(10 => 'The parsed date was invalid',)」のように、不具合がある内容を返してくれます。
　
　

正しくない「`2024-a-03`」を日時として与えた場合

　
次に、「2024-a-03」を入力した場合の結果を確認します。
　

array (
  'year' => 2024,
  'month' => 3,
  'day' => false,
  'hour' => false,
  'minute' => false,
  'second' => false,
  'fraction' => false,
  'warning_count' => 0,
  'warnings' => 
  array (
  ),
  'error_count' => 2,
  'errors' => 
  array (
    5 => 'Unexpected data found.',
    9 => 'Not enough data available to satisfy format',
  ),
  'is_localtime' => false,
)

array (

'year' => 2024,

'month' => 3,

'day' => false,

'hour' => false,

'minute' => false,

'second' => false,

'fraction' => false,

'warning_count' => 0,

'warnings' =>

array (

'error_count' => 2,

'errors' =>

array (

5 => 'Unexpected data found.',

9 => 'Not enough data available to satisfy format',

'is_localtime' => false,

)

　
「月」に「a」を入れていますので「'error_count' => 2」となり、エラー内容が返ってきています。
　
　
ちなみに「2024-08-33」の時のワーニングメッセージは「The parsed date was invalid」で「date」ですが、「2024-a-03」のエラーメッセージは「Unexpected data found.」で「data」ですね。
　
「2024-08-33」は日時として認識できますが、「2024-a-03」は日時としては認識できません、ということかも知れないですね。
　
　

「strptime()」と「date_parse_from_format()」を使った日時チェックの記述方法

　
これまでの確認した内容から、「strptime()」と「date_parse_from_format()」を使用して、日付のフォーマットが正しいか否かをチェックする処理はそれぞれ下記のようになります。
　

// strptime を使用する場合
if(strptime($datetime, '%Y-%m-%d')){
//  正しい時の処理
} else {
//  正しくない時の処理
}

// strptime を使用する場合

if(strptime($datetime, '%Y-%m-%d')){

// 正しい時の処理

} else {

// 正しくない時の処理

}

// date_parse_from_format を使用する場合
$dateParseFromFormat = date_parse_from_format('Y-m-d', $datetime);
if(!$dateParseFromFormat["warning_count"] && !$dateParseFromFormat["error_count"]){
//  正しい時の処理
} else {
//  正しくない時の処理
}

// date_parse_from_format を使用する場合

$dateParseFromFormat = date_parse_from_format('Y-m-d', $datetime);

if(!$dateParseFromFormat["warning_count"] && !$dateParseFromFormat["error_count"]){

// 正しい時の処理

} else {

// 正しくない時の処理

}

　
「date_parse_from_format()」を使用する場合は、ワーニングとエラーの数が「0」である場合に「正しい」と判断する処理になりますね。
　
　
日時のフォーマットが正しくない場合「strptime()」では「false」になりますが、「date_parse_from_format()」ではフォーマットが正しい、正しくないに関わらずレスポンスはありますので、「date_parse_from_format()」では、レスポンスの有無で判定はできないということになります。
　
　

「strptime()」は環境によって挙動が異なる

　
「strptime()」についてさらなる追い討ちが！
　
https://www.php.net/manual/ja/function.strptime.php
「strptime()」については、マニュアルに下記のようにも書かれています。
　

注意：内部では、この関数はシステムの C ライブラリ関数 strptime() をコールしています。 このライブラリ関数は、OS によって挙動が異なることがあります。

1	注意：内部では、この関数はシステムの C ライブラリ関数 strptime() をコールしています。このライブラリ関数は、OS によって挙動が異なることがあります。

　
https://qiita.com/YujiSoftware/items/1b65591efda79933fc79
上記の記事では挙動の違いを実際に試した結果を紹介してあります。
つまりは、「strptime()」は Linuxと Macで挙動が異なり、Windowsには実装されていない．．．ということになるわけです。
　
そんな関数は安心して使えないので、PHP8.1での非推奨勧告と関係なく、「date_parse_from_format()」を使う方がいいんでしょうね。

- PHP・Smarty・ECCUBE xampp

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: PHPのソースで見慣れない記号が出てきた・アロー演算子（->）、ダブルアロー演算子（=>）

PHPのプログラムソースには見慣れない記号が出てきます。その意味や調べ方です。

: JSON形式の値を配列形式に変換・PHPでは json_decode()、json_encode()

JSONとは「JavaScript Object Notation」の略でテキストベースのデータフォーマット。JSONの値をPHPで配列に変換するWebツールの紹介とその処理「json_encode()」「json_decode()」関数の解説。

: PHPで配列の値をダブルクオーテーションで囲んでimplodeでカンマ区切りにする方法

PHPで配列の値を、preg_replace関数でクォーテーションで囲み、implode関数で「,（カンマ）」で区切ってテキスト化する方法。この方法であれば配列が空でも分岐の処理は必要なし！

: PHP　range関数を使って階乗と重複組み合わせを計算

PHPの range関数を使って階乗と重複組み合わせを計算し、それを元に乱数発生器を作成しました。

: 配列の値をテキスト表示する際に「、」でつなげるときの処理方法の一例

配列の値を「、」でつないで出力する際、単純にforeachで繰り返し処理をすると「イヌ、サル、キジ、」となるが文字列最後の「、」を出力しない方法を3つ解説している。

: 数値文字参照コード変換ツール（HTML特殊文字コード変換ツール）

テキストを数値文字参照コード（特殊文字コード）に変換するツール。テキストを数値文字参照コードに簡単変換。数値文字参照、文字実体参照、特殊文字などの違いも解説。

: Smartyのテンプレート内の処理で計算、加工をする方法

Smartyのテンプレート上で変数を計算する、加工する方法を解説します。

: ECCUBEでテンプレートファイルのファイルサイズは10MB以下のものを使用してくださいのエラーが出た場合

テンプレートをアップロードする際にファイルサイズが大きすぎてエラーが表示される際の対処方法解説。パラメータ設定で設定する制限について解説を行っています。

: 路線・駅検索のために緯度経度からPHPで2点間の距離を計算する処理解説

路線・駅検索の仕組みの構築は大変。それを簡易に実装するために緯度経度を元に距離計算をする仕組みを考案。まずは2点間の距離を計算する仕組みを解説し、距離計算にまつわる関連技術も紹介。

: ECCUBEの新規追加ページがInternal Server Error・Not Foundに

ECCUBEで新規追加したページがInternal Server Errorに！原因はファイルのパーミッションの場合が多くその対処方法とプログラムの修正ポイントを解説。Not Foundも解説。

PREV: CakePHP4から外部のデータベースにアクセスする方法解説
NEXT: cURLを利用する際の注意点「&」があるURLは「”」で囲む

購読する

日	月	火	水	木	金	土
		1	2	3	4	5
6	7	8	9	10	11	12
13	14	15	16	17	18	19
20	21	22	23	24	25	26
27	28	29	30	31

WindowsのXAMPPのPHPではstrptimeは使用不可。代替はdate_parse_from_formatを使う

Windowsの PHPには strptimeは未実装。代替は date_parse_from_format

PHPのマニュアルに Windowsの PHPに strptimeは未実装と書いてある

「strptime()」と「date_parse_from_format()」の違いと実装方法

「strptime()」と「date_parse_from_format()」の違い：実装の方法

「strptime()」と「date_parse_from_format()」の違い・引数の順番が違う

「strptime()」と「date_parse_from_format()」の違い・日時のフォーマットの指定形式が違う

「strptime()」と「date_parse_from_format()」の違い：実行結果

「strptime()」と「date_parse_from_format()」の違い・正しくない日時のレスポンスが全く違う

正しくない「`2024-08-33`」を日時として与えた場合

正しくない「`2024-a-03`」を日時として与えた場合

「strptime()」と「date_parse_from_format()」を使った日時チェックの記述方法

「strptime()」は環境によって挙動が異なる

GoogleAdwords

GoogleAdwords

Message コメントをキャンセル

関連記事

PHPのソースで見慣れない記号が出てきた・アロー演算子（->）、ダブルアロー演算子（=>）

JSON形式の値を配列形式に変換・PHPでは json_decode()、json_encode()

PHPで配列の値をダブルクオーテーションで囲んでimplodeでカンマ区切りにする方法

PHP　range関数を使って階乗と重複組み合わせを計算

配列の値をテキスト表示する際に「、」でつなげるときの処理方法の一例

数値文字参照コード変換ツール（HTML特殊文字コード変換ツール）

Smartyのテンプレート内の処理で計算、加工をする方法

ECCUBEでテンプレートファイルのファイルサイズは10MB以下のものを使用してくださいのエラーが出た場合

路線・駅検索のために緯度経度からPHPで2点間の距離を計算する処理解説

ECCUBEの新規追加ページがInternal Server Error・Not Foundに

WordPress投稿にPHPを記述するショートコードの使い方add_shortcode

コピーコンテンツ対策.htaccessで直リンク禁止しリダイレクトで対応

評価点投票プラグイン10個を比較！WordPressで口コミサイトを構築

BackWPupでバックアップ・リストア（復元）の具体的手順

コンパクトキーボード・KEK-EA9AU・FKB1420の魅力

WindowsのXAMPPのPHPではstrptimeは使用不可。代替はdate_parse_from_formatを使う

Windowsの PHPには strptimeは未実装。代替は date_parse_from_format

PHPのマニュアルに Windowsの PHPに strptimeは未実装と書いてある

「strptime()」と「date_parse_from_format()」の違いと実装方法

「strptime()」と「date_parse_from_format()」の違い：実装の方法

「strptime()」と「date_parse_from_format()」の違い・引数の順番が違う

「strptime()」と「date_parse_from_format()」の違い・日時のフォーマットの指定形式が違う

「strptime()」と「date_parse_from_format()」の違い：実行結果

「strptime()」と「date_parse_from_format()」の違い・正しくない日時のレスポンスが全く違う

正しくない「2024-08-33」を日時として与えた場合

正しくない「2024-a-03」を日時として与えた場合

「strptime()」と「date_parse_from_format()」を使った日時チェックの記述方法

「strptime()」は環境によって挙動が異なる

GoogleAdwords

GoogleAdwords

Message コメントをキャンセル

関連記事

正しくない「`2024-08-33`」を日時として与えた場合

正しくない「`2024-a-03`」を日時として与えた場合