【PHP8.x】PM_STR定数の使い方

PM_STR定数の使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2026年03月13日

基本的な使い方

PM_STR定数は、プログラムの実行中に値が変わることのない、固定の値を表す定数です。PHPにおいて定数は、特定の数値や文字列、真偽値といった不変のデータを、分かりやすい名前で管理するために使用されます。一度定義された定数の値は、プログラムのどこからでもアクセス可能ですが、その値を後から変更することはできません。

これは、プログラムの特定の部分で共通して利用される重要な情報、例えば、アプリケーションのバージョン番号、システムで利用される状態コード、計算における円周率のような数学的な定数などを安全に扱うために非常に有効です。PM_STR定数も、PHPの拡張機能によって提供される定数の一つとして、特定の機能や動作を定義するための特定の値を保持しています。

定数を利用することで、コードの意図が明確になり、可読性が向上します。また、もし定数が保持する値に変更が必要になった場合でも、プログラム全体を探し回るのではなく、定数が定義されている一箇所を修正するだけで良いため、コードの保守性が高まります。これにより、エラーの発生リスクを低減し、より堅牢なシステムを構築する手助けとなります。システムエンジニアにとって、このように固定の値を効率的かつ安全に管理する定数の利用は、プログラミングの基本的ながらも非常に重要な要素です。

構文(syntax)


1<?php
2echo PM_STR;
3?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

int|string|float|bool|array

PM_STRは、PHPの定義済み定数です。その戻り値は、定義された値によってint（整数）、string（文字列）、float（浮動小数点数）、bool（真偽値）、array（配列）のいずれかになります。

サンプルコード

PHP strtotime am pm 解析する


1<?php
2
3/**
4 * strtotime() 関数が 'am' と 'pm' 表記の時刻文字列をどのように解析するかを示すサンプルです。
5 *
6 * この関数は、システムエンジニアを目指す初心者が日付と時刻の文字列処理、
7 * 特に12時間制の表記（AM/PM）を PHP がどのように扱うかを理解するのに役立ちます。
8 *
9 * @return void
10 */
11function demonstrateStrtotimeAmPm(): void
12{
13    // 'am' と 'pm' を含む複数の時刻文字列を定義します。
14    $timeStrings = [
15        "10:30 am",           // 午前10時30分
16        "3:15 pm",            // 午後3時15分
17        "12:00 pm",           // 正午 (午後12時)
18        "12:00 am",           // 真夜中 (午前12時)
19        "9 am tomorrow",      // 明日の午前9時
20        "5:30 PM last Friday" // 先週金曜日の午後5時30分
21    ];
22
23    echo "--- strtotime() with AM/PM Demonstration ---\n\n";
24
25    foreach ($timeStrings as $timeString) {
26        // strtotime() 関数を使用して、人間が読みやすい時刻文字列をUNIXタイムスタンプに変換します。
27        // strtotime() は 'am' や 'pm' の表記を正確に解析できます。
28        $timestamp = strtotime($timeString);
29
30        if ($timestamp === false) {
31            // パースに失敗した場合の処理
32            echo "エラー: '{$timeString}' の解析に失敗しました。\n\n";
33        } else {
34            // date() 関数でUNIXタイムスタンプを再び人間が読みやすい形式に変換します。
35            // 'Y-m-d H:i:s A' フォーマットは、年-月-日 時:分:秒 AM/PM を表示します。
36            // 'A' は大文字のAMまたはPMを表示します。
37            // 'h' は12時間形式の時間を表します。
38            $formattedTime = date('Y-m-d h:i:s A', $timestamp);
39
40            echo "元の文字列:      '{$timeString}'\n";
41            echo "UNIXタイムスタンプ: {$timestamp}\n";
42            echo "フォーマットされた日時: {$formattedTime}\n\n";
43        }
44    }
45
46    echo "--- Demonstration End ---\n";
47}
48
49// 関数を実行します。
50demonstrateStrtotimeAmPm();

このサンプルコードは、PHPのstrtotime()関数が「am」や「pm」といった12時間表記を含む時刻文字列をどのように解析し、日付と時刻を扱うかを示しています。システムエンジニアを目指す方が、日付や時刻の文字列をPHPで処理する際の基礎を理解するのに役立ちます。

strtotime()関数は、人間が読みやすい形式の時刻文字列（例：「10:30 am」、「5:30 PM last Friday」など）をUNIXタイムスタンプという整数値に変換します。この関数は、引数として解析したい時刻文字列を受け取ります。変換に成功すると、1970年1月1日00:00:00 UTCからの秒数を示すUNIXタイムスタンプ（整数）を返します。解析に失敗した場合はfalseを返します。サンプルコードでは、様々なAM/PM表記の時刻文字列がstrtotime()によって正確に解釈され、UNIXタイムスタンプに変換されていることを確認できます。

取得したUNIXタイムスタンプは、date()関数と組み合わせて使用することで、再び人間が理解しやすい日付と時刻の形式に変換できます。date()関数は、最初の引数にフォーマット文字列、2番目の引数にUNIXタイムスタンプを受け取り、フォーマットされた文字列を返します。例えば、フォーマット文字列「Y-m-d h:i:s A」は、「年-月-日 12時間形式の時:分:秒 AM/PM」として表示します。特に「h」は12時間形式の時間、「A」は大文字のAMまたはPMを示します。

このように、strtotime()とdate()関数を組み合わせることで、PHPで日付と時刻の文字列を柔軟に処理し、表示することが可能です。これは実務で頻繁に利用される基本的な機能の一つです。

strtotime()関数は、さまざまな形式の日時文字列を解析できる便利な関数ですが、解析に失敗した場合はfalseを返すため、必ず戻り値をチェックし、適切なエラーハンドリングを行うようにしてください。特に「12:00 am」は真夜中、「12:00 pm」は正午と解釈されますので、12時間制表記の境界に注意が必要です。PHPの実行環境におけるタイムゾーン設定（date.timezone）が結果に影響を与えるため、意図しない時刻になることを避けるためにも、適切なタイムゾーンが設定されているか確認することが重要です。この関数は柔軟ですが、入力される文字列のバリエーションが多岐にわたる場合、予期せぬ結果を防ぐために、入力値の形式をある程度制限または検証することを検討すると、より安全に利用できます。