MySQLのSELECT文でタイムスタンプの日付範囲を取得する方法

MySQLでは、SELECT文にWHERE句と比較演算子を組み合わせることで、特定の期間内にあるタイムスタンプデータを効率的に抽出できます。この記事では、基本的な構文から実際のサンプルテーブルを使った動作確認まで、具体的な手順を解説します。

タイムスタンプの日付範囲を取得する基本構文

日付範囲を指定してデータを取得するには、以下のような構文を使用します。

SELECT * FROM yourTableName
WHERE yourDataTimeField >= anyDateRange
AND yourDataTimeField < anyDateRange

ポイントは、開始日に対しては「以上（>=）」、終了日に対しては「未満（<）」を使用することです。こうすることで、終了日の00:00:00以降のレコードも漏れなく含めることができます。

サンプルテーブルの作成

それでは、実際にテーブルを作成して動作を確認してみましょう。まずはタイムスタンプ型のカラムを持つテーブルを作成します。

mysql> create table DateRange
   -> (
   -> DueTime timestamp
   -> );
Query OK, 0 rows affected (1.34 sec)

テストデータの挿入

次に、INSERT文を使って複数のレコードを挿入します。異なる年月日のデータを用意することで、範囲検索の結果が分かりやすくなります。

mysql> insert into DateRange values('2016-11-13');
Query OK, 1 row affected (0.51 sec)

mysql> insert into DateRange values('2016-10-14');
Query OK, 1 row affected (0.23 sec)

mysql> insert into DateRange values('2017-01-23');
Query OK, 1 row affected (0.10 sec)

mysql> insert into DateRange values('2017-05-14');
Query OK, 1 row affected (0.19 sec)

mysql> insert into DateRange values('2017-08-25');
Query OK, 1 row affected (0.17 sec)

mysql> insert into DateRange values('2018-09-28');
Query OK, 1 row affected (0.18 sec)

mysql> insert into DateRange values('2018-11-17');
Query OK, 1 row affected (0.47 sec)

mysql> insert into DateRange values('2018-12-13');
Query OK, 1 row affected (0.17 sec)

mysql> insert into DateRange values('2018-12-16');
Query OK, 1 row affected (0.27 sec)

登録済みレコードの確認

SELECT文ですべてのレコードを表示してみましょう。

mysql> select *from DateRange;

実行結果は以下の通りです。

+---------------------+
| DueTime             |
+---------------------+
| 2016-11-13 00:00:00 |
| 2016-10-14 00:00:00 |
| 2017-01-23 00:00:00 |
| 2017-05-14 00:00:00 |
| 2017-08-25 00:00:00 |
| 2018-09-28 00:00:00 |
| 2018-11-17 00:00:00 |
| 2018-12-13 00:00:00 |
| 2018-12-16 00:00:00 |
+---------------------+
9 rows in set (0.00 sec)

日付範囲を指定した検索の実行

ここで、2017年5月14日から2018年12月16日までのデータを取得するクエリを実行してみます。終了日は翌日の2018年12月17日を指定し、「未満」で比較している点に注目してください。

mysql> select *from DateRange
   -> where DueTime >= '2017-05-14'
   -> and DueTime < '2018-12-17';

実行すると、指定した範囲内の6件のレコードが取得できます。

+---------------------+
| DueTime             |
+---------------------+
| 2017-05-14 00:00:00 |
| 2017-08-25 00:00:00 |
| 2018-09-28 00:00:00 |
| 2018-11-17 00:00:00 |
| 2018-12-13 00:00:00 |
| 2018-12-16 00:00:00 |
+---------------------+
6 rows in set (0.00 sec)

UNIXタイムスタンプの場合の対処法

カラムに格納されているのがUNIXタイムスタンプ形式（エポック秒）である場合は、MySQLの組み込み関数unix_timestamp()を使って検索値を変換します。

select * from yourTableName
where yourColumnName >= unix_timestamp('anyDateValue')
and yourColumnName < unix_timestamp('anyDateValue')

unix_timestamp()は、引数として渡した日時文字列をエポック秒に変換する関数です。これにより、数値として保存されたタイムスタンプとも正しく比較できるようになります。

まとめ

MySQLでタイムスタンプの日付範囲を取得する際は、開始日に>=、終了日に<を使うのが安全で確実な方法です。終了日を「以下（<=）」で指定すると、当日の時間部分まで考慮できずデータが漏れる可能性があるため注意しましょう。また、UNIXタイムスタンプ形式のカラムに対してはunix_timestamp()関数を活用することで、同じ考え方で範囲検索が行えます。