PHPで日時をMySQLデータベースに挿入・取得する方法を徹底解説

PHPとMySQLを使用した日時のデータ操作は、多くのWebアプリケーションにおいて重要なスキルです。例えば、ブログの投稿日時や予約システムのスケジュール管理など、日時情報を正確に扱うことが必要な場面が多くあります。本記事では、MySQLデータベースに日時を挿入したり取得したりする方法を、基本から応用まで段階的に解説します。PHPでの日時フォーマットの方法や、MySQLのデータ型についても詳しく取り上げ、実践的なスキルを身につけることができる内容を目指します。

MySQLでの日時データ型
PHPでの日時のフォーマットと変換
MySQLへの日時データの挿入方法
タイムゾーンの設定と考慮
MySQLからの日時データの取得方法
日時の比較と範囲検索
UNIXタイムスタンプの利用
日時操作のベストプラクティス
エラーハンドリングとトラブルシューティング
実践例：予約システムの実装
まとめ

MySQLでの日時データ型

MySQLでは、日時を表すためにいくつかのデータ型が用意されています。主なものとして、DATETIME型とTIMESTAMP型があります。それぞれの違いと特徴を理解することが、適切なデータ型の選択に繋がります。

DATETIME型

DATETIME型は、’YYYY-MM-DD HH:MM:SS’の形式で日時を保存します。この形式は、幅広い範囲の日時（1000年から9999年）を扱えるため、過去や未来の日時を記録する場合に便利です。DATETIME型はタイムゾーンの影響を受けず、保存されるデータはそのままの形式で維持されます。

TIMESTAMP型

TIMESTAMP型も’YYYY-MM-DD HH:MM:SS’形式で日時を保存しますが、1970年1月1日からの経過秒数（UNIXタイムスタンプ）を基にしており、2038年までの範囲に制限があります。TIMESTAMP型は、タイムゾーンに応じて自動的に変換されるため、サーバー間で異なるタイムゾーンを扱う際に役立ちます。

DATE型とTIME型

DATE型は日付のみ（’YYYY-MM-DD’）を、TIME型は時刻のみ（’HH:MM:SS’）を扱うデータ型です。日時全体ではなく、特定の日付や時刻のみを記録したい場合に使用します。

これらのデータ型の違いを理解し、用途に応じて適切な型を選択することが、効率的なデータベース設計に繋がります。

PHPでの日時のフォーマットと変換

PHPでは、日時の操作を行うために様々な関数やクラスが用意されています。最も一般的な方法として、date()関数やDateTimeクラスを使用して日時のフォーマットや変換を行います。

date()関数による日時のフォーマット

date()関数は、指定したフォーマットで現在の日時を取得するために使用します。例えば、以下のようにして’YYYY-MM-DD HH:MM:SS’形式で日時を取得することができます。

$currentDateTime = date('Y-m-d H:i:s');
echo $currentDateTime; // 例: 2024-10-24 12:34:56

フォーマット文字は多岐にわたり、Yは4桁の年、mは2桁の月、dは2桁の日を表します。H:i:sはそれぞれ時、分、秒を表します。

DateTimeクラスの利用

DateTimeクラスは、より高度な日時操作が可能です。DateTimeオブジェクトを作成し、format()メソッドでフォーマットを指定することで日時を取得します。

$dateTime = new DateTime();
echo $dateTime->format('Y-m-d H:i:s'); // 例: 2024-10-24 12:34:56

また、文字列から日時をパースしてDateTimeオブジェクトを生成することも可能です。

$dateString = '2024-10-24 15:30:00';
$dateTime = new DateTime($dateString);
echo $dateTime->format('Y-m-d H:i:s'); // 2024-10-24 15:30:00

タイムゾーンの設定

DateTimeクラスではタイムゾーンの設定も簡単に行えます。タイムゾーンを指定することで、異なる地域の時間を扱うことができます。

$dateTime = new DateTime('now', new DateTimeZone('Asia/Tokyo'));
echo $dateTime->format('Y-m-d H:i:s'); // 日本時間での日時を表示

PHPの日時フォーマット機能を活用することで、日時データの表示や保存を柔軟に管理することが可能です。

MySQLへの日時データの挿入方法

PHPを使用して、MySQLデータベースに日時データを挿入する方法を解説します。通常、INSERT文を用いてデータを挿入しますが、日時データの扱いにはいくつかの注意点があります。ここでは、DATETIME型やTIMESTAMP型を対象に、適切な方法で日時をデータベースに保存する手順を紹介します。

基本的な挿入方法

まず、PHPで現在の日時を取得し、MySQLのDATETIMEフィールドに挿入する基本的な方法を見てみましょう。以下のコードでは、date()関数を用いて現在の日時を取得し、データベースに挿入します。

// データベース接続の設定
$servername = "localhost";
$username = "root";
$password = "password";
$dbname = "mydatabase";

$conn = new mysqli($servername, $username, $password, $dbname);
if ($conn->connect_error) {
    die("接続失敗: " . $conn->connect_error);
}

// 現在の日時を取得
$currentDateTime = date('Y-m-d H:i:s');

// SQLクエリを作成
$sql = "INSERT INTO my_table (event_name, event_date) VALUES ('テストイベント', '$currentDateTime')";

// クエリを実行
if ($conn->query($sql) === TRUE) {
    echo "データが正常に挿入されました。";
} else {
    echo "エラー: " . $sql . "<br>" . $conn->error;
}

// 接続を閉じる
$conn->close();

この例では、my_tableテーブルにあるevent_dateフィールドに現在の日時が挿入されます。

プリペアドステートメントを用いた挿入

セキュリティの観点から、プリペアドステートメントを使用してSQLインジェクションのリスクを軽減することが推奨されます。以下はその実装例です。

$stmt = $conn->prepare("INSERT INTO my_table (event_name, event_date) VALUES (?, ?)");
$stmt->bind_param("ss", $eventName, $eventDate);

// 値を設定
$eventName = "セキュアイベント";
$eventDate = date('Y-m-d H:i:s');

// クエリを実行
$stmt->execute();

echo "データが安全に挿入されました。";

// ステートメントを閉じる
$stmt->close();
$conn->close();

MySQLのNOW()関数を利用する方法

PHPで日時を指定せず、MySQLのNOW()関数を使用してデータベース側で現在の日時を自動挿入することも可能です。

$sql = "INSERT INTO my_table (event_name, event_date) VALUES ('イベント名', NOW())";

この方法では、データベースのタイムゾーン設定に基づいて日時が挿入されるため、タイムゾーンに注意が必要です。

以上の方法を活用することで、PHPからMySQLに日時データを適切に挿入することができます。

タイムゾーンの設定と考慮

日時データを扱う際、タイムゾーンの設定は非常に重要です。PHPとMySQLの両方でタイムゾーンを適切に設定しないと、異なる地域で運用する際に日時データがずれることがあります。ここでは、タイムゾーンの設定方法と、タイムゾーンを考慮した日時データの扱い方について解説します。

PHPのタイムゾーン設定

PHPでの日時操作を行う前に、タイムゾーンを正しく設定しておくことが推奨されます。タイムゾーンの設定は、date_default_timezone_set()関数を使って行います。以下の例では、日本時間（Asia/Tokyo）を設定しています。

date_default_timezone_set('Asia/Tokyo');
$currentDateTime = date('Y-m-d H:i:s');
echo $currentDateTime; // 現在の日本時間を表示

PHPのデフォルトタイムゾーンをphp.iniファイルで設定することも可能です。

; php.iniファイル
date.timezone = "Asia/Tokyo"

MySQLのタイムゾーン設定

MySQLサーバーのタイムゾーン設定も、日時データを正しく扱うために重要です。サーバーのタイムゾーンを確認するには、以下のコマンドを使用します。

SELECT @@global.time_zone, @@session.time_zone;

MySQLのタイムゾーンを設定するには、SET TIME_ZONEコマンドを使います。

SET time_zone = 'Asia/Tokyo';

タイムゾーンをグローバルに設定する場合は、my.cnfファイルを編集します。

[mysqld]
default-time-zone = 'Asia/Tokyo'

UTCの使用を推奨する理由

システム全体で一貫したタイムゾーンを維持するために、UTC（協定世界時）を使用することが一般的に推奨されます。UTCを使うことで、異なる地域にまたがるユーザーに対しても正確な日時管理が可能になります。PHPでUTCを設定する例は以下の通りです。

date_default_timezone_set('UTC');

MySQLでも同様に、UTCを設定することで日時データの一貫性を確保できます。

SET time_zone = '+00:00';

日時データの表示時にローカルタイムに変換する方法

データベースに保存されている日時がUTCの場合、表示する際にユーザーのローカルタイムに変換する必要があります。PHPのDateTimeクラスを使って、タイムゾーンを指定して変換できます。

$utcDateTime = new DateTime('2024-10-24 12:34:56', new DateTimeZone('UTC'));
$utcDateTime->setTimezone(new DateTimeZone('Asia/Tokyo'));
echo $utcDateTime->format('Y-m-d H:i:s'); // 日本時間に変換して表示

タイムゾーンを正しく設定し、UTCを基準に日時を管理することで、異なる地域間でも正確な日時操作が可能になります。

MySQLからの日時データの取得方法

PHPを使用してMySQLデータベースから日時データを取得し、適切に表示する方法について解説します。日時データのフォーマットやタイムゾーンの変換を考慮しながら、データを表示する実践的な手法を紹介します。

基本的な日時データの取得

MySQLから日時データを取得するためには、SELECT文を使用します。例えば、event_dateフィールドに保存されている日時データを取得するSQLクエリは以下のようになります。

// データベース接続の設定
$servername = "localhost";
$username = "root";
$password = "password";
$dbname = "mydatabase";

$conn = new mysqli($servername, $username, $password, $dbname);
if ($conn->connect_error) {
    die("接続失敗: " . $conn->connect_error);
}

// SQLクエリを実行して日時データを取得
$sql = "SELECT event_name, event_date FROM my_table";
$result = $conn->query($sql);

if ($result->num_rows > 0) {
    // データを出力
    while($row = $result->fetch_assoc()) {
        echo "イベント名: " . $row["event_name"] . " - 日時: " . $row["event_date"] . "<br>";
    }
} else {
    echo "データが見つかりません。";
}

// 接続を閉じる
$conn->close();

この例では、event_dateフィールドの日時データがそのままのフォーマットで表示されます。

日時データのフォーマット変更

MySQLのDATE_FORMAT()関数を使用すると、日時データのフォーマットを変更して取得することができます。例えば、’YYYY-MM-DD’形式で日付を表示する場合は、次のようにします。

$sql = "SELECT event_name, DATE_FORMAT(event_date, '%Y-%m-%d') as formatted_date FROM my_table";

PHP側でもDateTimeクラスを使用してフォーマットを変更できます。

$dateTime = new DateTime($row["event_date"]);
echo $dateTime->format('Y年m月d日 H:i:s'); // 日本語形式で表示

タイムゾーンの変換

UTCで保存されている日時データをローカルタイムに変換して表示するには、DateTimeクラスでタイムゾーンを設定します。

$dateTime = new DateTime($row["event_date"], new DateTimeZone('UTC'));
$dateTime->setTimezone(new DateTimeZone('Asia/Tokyo'));
echo $dateTime->format('Y-m-d H:i:s'); // 日本時間に変換して表示

日時フィルタを使用したデータの取得

特定の日時範囲内のデータを取得したい場合、WHERE句でフィルタをかけることができます。

$sql = "SELECT event_name, event_date FROM my_table WHERE event_date BETWEEN '2024-10-01 00:00:00' AND '2024-10-31 23:59:59'";

このクエリは、2024年10月中に発生したイベントを取得します。

MySQLから日時データを取得し、適切なフォーマットで表示するためには、データベースとPHPの両方での設定が重要です。

日時の比較と範囲検索

MySQLでは、日時データを利用して特定の期間のデータを抽出したり、日時の比較を行うことができます。ここでは、日時の比較方法や範囲検索の実装手法について説明します。

日時の比較

日時を比較する場合、<、>、<=、>=といった比較演算子を使用します。例えば、指定した日時よりも後に発生したイベントを取得するクエリは以下の通りです。

$sql = "SELECT event_name, event_date FROM my_table WHERE event_date > '2024-10-01 00:00:00'";

このクエリは、2024年10月1日以降のイベントを抽出します。

特定期間内の日時の範囲検索

日時データの範囲検索には、BETWEEN句を使用するのが一般的です。BETWEENは、指定された開始日と終了日の間にあるデータを取得します。

$sql = "SELECT event_name, event_date FROM my_table WHERE event_date BETWEEN '2024-10-01 00:00:00' AND '2024-10-31 23:59:59'";

この例では、2024年10月1日から10月31日までのイベントが取得されます。BETWEEN句は、境界を含むことに注意してください。

日時の範囲検索におけるインデックスの利用

日時フィールドにインデックスを設定しておくと、範囲検索のパフォーマンスが向上します。大規模なデータベースで日時検索を行う際には、インデックスを使用することでクエリの実行速度を最適化できます。

CREATE INDEX idx_event_date ON my_table(event_date);

このようにインデックスを作成しておくと、WHERE句でevent_dateを使った検索のパフォーマンスが向上します。

複数条件での日時フィルタリング

日時の範囲検索と他の条件を組み合わせることも可能です。例えば、特定の期間内のイベントで特定のカテゴリーに属するものだけを取得する場合は、次のように記述します。

$sql = "SELECT event_name, event_date FROM my_table WHERE event_date BETWEEN '2024-10-01 00:00:00' AND '2024-10-31 23:59:59' AND category = '会議'";

このクエリは、2024年10月中に行われた会議カテゴリーのイベントを取得します。

日時データの丸め処理

日時の比較や範囲検索を行う前に、日時を日単位や月単位で丸めることが必要な場合があります。DATE()関数を使用して日単位に切り捨てることができます。

$sql = "SELECT event_name, event_date FROM my_table WHERE DATE(event_date) = '2024-10-24'";

このクエリは、2024年10月24日に行われたイベントを取得します。

日時の比較や範囲検索を行うことで、特定の条件に合致するデータを効率的に抽出することが可能です。適切なクエリの設計により、精度の高いデータ検索を実現できます。

UNIXタイムスタンプの利用

UNIXタイムスタンプは、1970年1月1日からの経過秒数で日時を表現する方法で、PHPやMySQLでの日時操作に広く使用されています。UNIXタイムスタンプを利用することで、日時データの比較や計算がシンプルに行えるため、特に利便性が高いです。ここでは、UNIXタイムスタンプを使った日時操作の方法を解説します。

PHPでのUNIXタイムスタンプの取得と操作

PHPでは、time()関数を使って現在のUNIXタイムスタンプを取得できます。

$currentTimestamp = time();
echo $currentTimestamp; // 例: 1735132800

また、特定の日時をUNIXタイムスタンプに変換するには、strtotime()関数を使用します。

$timestamp = strtotime('2024-10-24 12:00:00');
echo $timestamp; // 例: 1735132800

取得したタイムスタンプを使って日時を計算することも可能です。例えば、1日後のタイムスタンプを計算するには次のようにします。

$tomorrowTimestamp = $currentTimestamp + (24 * 60 * 60);

MySQLでのUNIXタイムスタンプの利用

MySQLでもUNIXタイムスタンプを使用して日時を管理することができます。UNIX_TIMESTAMP()関数で日時をタイムスタンプ形式に変換したり、FROM_UNIXTIME()関数でタイムスタンプを日時に変換したりできます。

-- 現在の日時をUNIXタイムスタンプとして取得
SELECT UNIX_TIMESTAMP();

-- UNIXタイムスタンプを日時形式に変換
SELECT FROM_UNIXTIME(1735132800);

UNIXタイムスタンプを使うことで、MySQLにおける日時の比較や計算が容易になります。

UNIXタイムスタンプを使った日時の比較

UNIXタイムスタンプを使用すると、日時の比較がシンプルになります。タイムスタンプ同士の大小を比較することで、日時の先後関係を判定できます。

$eventTimestamp = strtotime('2024-10-24 12:00:00');
$currentTimestamp = time();

if ($currentTimestamp > $eventTimestamp) {
    echo "このイベントはすでに終了しています。";
} else {
    echo "このイベントはまだ開催されていません。";
}

タイムスタンプの保存と取得

日時データをUNIXタイムスタンプとしてMySQLに保存する場合、INT型のカラムを使用するのが一般的です。以下のようにevent_timeカラムにUNIXタイムスタンプを挿入します。

$sql = "INSERT INTO my_table (event_name, event_time) VALUES ('テストイベント', " . time() . ")";

タイムスタンプを取得して人間が読める形式に変換するには、FROM_UNIXTIME()関数を使用します。

SELECT event_name, FROM_UNIXTIME(event_time) as event_date FROM my_table;

UNIXタイムスタンプのメリットと注意点

UNIXタイムスタンプはタイムゾーンに依存せず、日時計算がシンプルになるという利点があります。一方で、2038年問題のように、32ビットシステムでは2038年以降の日時を扱えなくなるという制約もあります。この点に注意して、システムの要件に合わせて使用することが重要です。

UNIXタイムスタンプを活用することで、日時操作が効率的に行えるようになります。特に比較や計算を頻繁に行うアプリケーションでは、その利便性が大いに発揮されます。

日時操作のベストプラクティス

日時データを扱う際には、適切な方法を選択しないと不整合が発生し、システムの信頼性が損なわれる可能性があります。ここでは、日時操作におけるベストプラクティスを紹介し、正確で一貫性のある日時管理を実現するためのポイントを解説します。

1. 一貫したタイムゾーンの使用

日時データを管理する際には、タイムゾーンの一貫性を確保することが重要です。サーバー、データベース、アプリケーション全体で同じタイムゾーンを使用することで、日時のずれや混乱を防止できます。
通常は、UTCを標準としてデータベースに保存し、表示時にローカルタイムに変換するのが推奨されます。

// PHPでUTCを設定
date_default_timezone_set('UTC');

// MySQLでUTCを設定
SET time_zone = '+00:00';

2. 日時フォーマットの標準化

日時のフォーマットを統一することも重要です。ISO 8601形式（YYYY-MM-DDTHH:MM:SS）は、広くサポートされている標準フォーマットであり、他のシステムとの互換性を確保できます。PHPでは、DateTimeクラスのformat()メソッドを使ってISO 8601形式で日時を出力できます。

$dateTime = new DateTime();
echo $dateTime->format(DateTime::ATOM); // 例: 2024-10-24T12:34:56+00:00

3. 日時データの厳格なバリデーション

日時データを入力する際には、厳格なバリデーションを行うことで、不正な値の混入を防ぐ必要があります。特にユーザー入力から日時を取得する場合、strtotime()で変換できない値が渡されることがあるため、必ずバリデーションを実施しましょう。

$dateString = '2024-10-24 12:34:56';
if (strtotime($dateString) === false) {
    echo "無効な日時フォーマットです。";
} else {
    echo "日時が有効です。";
}

4. 日時操作にはDateTimeクラスを活用

PHPのDateTimeクラスを使うと、日時操作をオブジェクト指向で扱うことができ、可読性とメンテナンス性が向上します。例えば、日時の加算や減算を行う際も、DateTimeクラスのmodify()メソッドが便利です。

$dateTime = new DateTime('2024-10-24 12:00:00');
$dateTime->modify('+1 day');
echo $dateTime->format('Y-m-d H:i:s'); // 2024-10-25 12:00:00

5. データベース内の日時インデックスの設定

日時フィールドにインデックスを設定することで、クエリのパフォーマンスを向上させることができます。特に、日時を使った検索やソートが頻繁に行われる場合には有効です。

CREATE INDEX idx_event_date ON my_table(event_date);

6. 日時の曖昧さを避ける

日付だけを扱う場合や、時間だけを扱う場合には、適切なデータ型を使用することが重要です。MySQLのDATE型やTIME型を使うことで、誤解を防ぎます。また、サマータイムの切り替えによる時間の重複や欠落に注意する必要があります。

7. 将来の2038年問題に備える

32ビットシステムでは、UNIXタイムスタンプの範囲が2038年で切れてしまう問題があります。将来的な拡張性を考慮して、64ビット環境を前提としたシステム設計を行い、日付データ型やフォーマットに制約を持たせないようにしましょう。

これらのベストプラクティスを採用することで、日時操作の信頼性と一貫性が向上し、アプリケーション全体の品質が高まります。

エラーハンドリングとトラブルシューティング

日時データを扱う際に発生しがちなエラーや問題を正しく対処するためには、エラーハンドリングとトラブルシューティングが不可欠です。ここでは、PHPとMySQLでの日時操作に関連する一般的なエラーの対処方法や、発生する可能性のある問題について解説します。

1. 無効な日時フォーマットの処理

ユーザーからの入力が無効な日時フォーマットである場合、エラーが発生する可能性があります。strtotime()関数やDateTimeクラスを用いて、無効な日時を検出する方法を紹介します。

$dateString = '2024-13-45 25:61:00'; // 無効な日時
if (strtotime($dateString) === false) {
    echo "無効な日時フォーマットです。";
} else {
    echo "日時が有効です。";
}

DateTimeクラスを使用する場合も例外をキャッチして処理します。

try {
    $dateTime = new DateTime('2024-13-45 25:61:00');
} catch (Exception $e) {
    echo "日時のパースに失敗しました: " . $e->getMessage();
}

2. タイムゾーンの不一致によるエラー

タイムゾーンの設定が異なる場合、日時の表示や計算に不整合が生じることがあります。サーバーとデータベース、アプリケーション全体でタイムゾーンが一致していることを確認しましょう。

PHPでのタイムゾーン設定を確認する:

echo date_default_timezone_get(); // 現在のタイムゾーンを取得

MySQLでのタイムゾーン設定を確認する:

SELECT @@global.time_zone, @@session.time_zone;

タイムゾーンが一致しない場合は、適切な設定を行って修正します。

3. NULL値や空の日時フィールドの処理

日時フィールドがNULLまたは空の場合に対処することも重要です。特に、データベースから日時データを取得する際に、予期しないNULL値が含まれているとエラーの原因になります。

if (empty($row['event_date']) || $row['event_date'] === '0000-00-00 00:00:00') {
    echo "日時データが存在しません。";
} else {
    echo "日時: " . $row['event_date'];
}

4. 日時の丸めによるデータの誤差

日時の丸め処理を行う際に、想定外の誤差が生じる場合があります。DATE()やTIME()関数を使用する際には、切り捨てや切り上げの影響を考慮しましょう。

SELECT DATE(event_date) FROM my_table; -- 日付のみ取得（時間は切り捨て）

このように、データの丸めが原因で特定の条件に合致しない場合がありますので、必要に応じてタイムスタンプを使用するなど、精度を保つ方法を検討しましょう。

5. UNIXタイムスタンプの範囲外エラー

UNIXタイムスタンプが有効な範囲は1970年1月1日から2038年1月19日まで（32ビットシステムの場合）です。この範囲を超える日時を扱おうとするとエラーが発生します。64ビットシステムを使用するか、別の日時フォーマットを採用することで対処可能です。

$timestamp = strtotime('1969-12-31 23:59:59'); // 32ビットシステムではエラー
if ($timestamp === false) {
    echo "範囲外の日時です。";
}

6. 日時データの整合性チェック

複数の日時フィールドがある場合、それらの整合性を確認する必要があります。例えば、開始日時が終了日時よりも後になっていないかをチェックします。

$startDate = strtotime('2024-10-24 12:00:00');
$endDate = strtotime('2024-10-23 15:00:00');

if ($startDate > $endDate) {
    echo "終了日時は開始日時より後でなければなりません。";
}

7. ログとデバッグ情報の活用

日時操作のエラーが発生した場合、ログを活用して問題の特定を行います。PHPのエラーログやMySQLのエラーログに出力される情報をもとに、原因を突き止めましょう。

// PHPエラーログの設定
ini_set('log_errors', 1);
ini_set('error_log', '/path/to/error.log');

これらのエラーハンドリングとトラブルシューティングを実践することで、日時操作に関する問題を早期に発見し、適切に対処することができます。

実践例：予約システムの実装

PHPとMySQLを使用したシンプルな予約システムの実装を通して、日時データの操作方法を学びます。この例では、予約の登録、表示、重複チェックなど、実際のアプリケーションで必要となる機能を解説します。

1. データベース設計

まず、予約情報を管理するためのテーブルを設計します。テーブルには、予約ID、予約者の名前、予約日時、作成日時などのフィールドを含めます。

CREATE TABLE reservations (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(255) NOT NULL,
    reservation_date DATETIME NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

このテーブルでは、reservation_dateフィールドに予約日時が保存されます。

2. 予約の登録機能

予約を登録するためのフォームと、PHPスクリプトを作成します。予約の日時はユーザーが入力し、PHPを使ってデータベースに保存します。

<!-- 予約フォーム -->
<form action="reserve.php" method="post">
    名前: <input type="text" name="name" required><br>
    予約日時: <input type="datetime-local" name="reservation_date" required><br>
    <input type="submit" value="予約する">
</form>

以下のreserve.phpスクリプトは、フォームから送信されたデータを受け取り、データベースに予約を挿入します。

// reserve.php
$servername = "localhost";
$username = "root";
$password = "password";
$dbname = "mydatabase";

$conn = new mysqli($servername, $username, $password, $dbname);
if ($conn->connect_error) {
    die("接続失敗: " . $conn->connect_error);
}

// フォームデータを取得
$name = $_POST['name'];
$reservationDate = $_POST['reservation_date'];

// 予約の重複チェック
$checkSql = "SELECT * FROM reservations WHERE reservation_date = ?";
$stmt = $conn->prepare($checkSql);
$stmt->bind_param("s", $reservationDate);
$stmt->execute();
$result = $stmt->get_result();

if ($result->num_rows > 0) {
    echo "この日時はすでに予約されています。別の日時を選んでください。";
} else {
    // 予約を挿入
    $sql = "INSERT INTO reservations (name, reservation_date) VALUES (?, ?)";
    $stmt = $conn->prepare($sql);
    $stmt->bind_param("ss", $name, $reservationDate);

    if ($stmt->execute()) {
        echo "予約が正常に登録されました。";
    } else {
        echo "エラー: " . $conn->error;
    }
}

$stmt->close();
$conn->close();

このスクリプトでは、重複した予約がないかチェックし、問題なければ予約をデータベースに保存します。

3. 予約一覧の表示

登録された予約を一覧表示するためのPHPコードを作成します。データベースから予約を取得し、日時順に表示します。

// reservations_list.php
$conn = new mysqli($servername, $username, $password, $dbname);
if ($conn->connect_error) {
    die("接続失敗: " . $conn->connect_error);
}

$sql = "SELECT * FROM reservations ORDER BY reservation_date ASC";
$result = $conn->query($sql);

if ($result->num_rows > 0) {
    echo "<table border='1'>
            <tr><th>ID</th><th>名前</th><th>予約日時</th><th>作成日時</th></tr>";
    while ($row = $result->fetch_assoc()) {
        echo "<tr>
                <td>" . $row['id'] . "</td>
                <td>" . $row['name'] . "</td>
                <td>" . $row['reservation_date'] . "</td>
                <td>" . $row['created_at'] . "</td>
              </tr>";
    }
    echo "</table>";
} else {
    echo "予約がありません。";
}

$conn->close();

このスクリプトは、予約データを取得してテーブル形式で表示します。

4. 予約の更新と削除

予約の更新や削除機能を追加することで、予約管理がより柔軟になります。更新機能は予約の日時や名前の変更を許可し、削除機能は不要な予約を取り除くことができます。

// 予約更新例
$updateSql = "UPDATE reservations SET reservation_date = ? WHERE id = ?";
$stmt = $conn->prepare($updateSql);
$stmt->bind_param("si", $newDate, $reservationId);
$stmt->execute();

// 予約削除例
$deleteSql = "DELETE FROM reservations WHERE id = ?";
$stmt = $conn->prepare($deleteSql);
$stmt->bind_param("i", $reservationId);
$stmt->execute();

これらの機能を実装することで、ユーザーが柔軟に予約を管理できるシステムが完成します。

5. 日時操作における注意点

予約システムでは、タイムゾーンの設定や日時フォーマットの統一が特に重要です。すべての日時操作において、サーバーとクライアントのタイムゾーンの違いに注意し、日時の一貫性を保つようにしましょう。

この実践例を通して、PHPとMySQLを用いた日時の取り扱い方を深く理解し、実用的な予約システムを構築できるようになります。

まとめ

本記事では、PHPとMySQLを使用した日時の操作方法について、基本から応用までを解説しました。日時データ型の選択、PHPでのフォーマットやタイムゾーンの設定、MySQLへの挿入と取得、エラーハンドリング、そして実践的な予約システムの構築例を通して、日時操作に関する多くのポイントをカバーしました。適切な日時の管理とエラー対策を行うことで、日時に依存するアプリケーションの信頼性を高めることができます。この記事を参考に、日時操作のスキルを実践に活かしてみてください。