この記事では、Oracleデータベースにおける日時関連のファンクションである ADD_MONTHS, MONTHS_BETWEEN, NEXT_DAY, LAST_DAY, SYSDATE について、より具体的な使用例と注意点を含めて詳しく解説します。これらのファンクションは、データを処理する上で役立つ基本の機能を提供します。
1. ADD_MONTHS
**ADD_MONTHS(date, n)**は、指定した日付からnヶ月前または後の日付を返します。nが負の値の場合は過去の日付、正の値の場合は未来の日付を計算します。
使用例
移動前の日付: 2024-01-15
SELECT ADD_MONTHS(TO_DATE('2024-01-15', 'YYYY-MM-DD'), 3) AS result FROM dual;
-- 結果: 2024-04-15
SELECT ADD_MONTHS(TO_DATE('2024-01-15', 'YYYY-MM-DD'), -2) AS result FROM dual;
-- 結果: 2023-11-15注意点
- 入力した日付が月末の場合、移動先の日付も月末に調整されます。
SELECT ADD_MONTHS(TO_DATE('2024-02-29', 'YYYY-MM-DD'), 1) AS result FROM dual;
-- 結果: 2024-03-31実践例
例えば、顧客のサブスクリプション期間を計算する際に使用できます。
SELECT customer_id, ADD_MONTHS(subscription_start_date, 12) AS subscription_end_date
FROM customers;2. MONTHS_BETWEEN
**MONTHS_BETWEEN(date1, date2)**は、二つの日付の間の月数を返します。結果は実数で返され、小数部は日数の差を基に計算されます。
使用例
SELECT MONTHS_BETWEEN(TO_DATE('2024-04-15', 'YYYY-MM-DD'), TO_DATE('2024-01-15', 'YYYY-MM-DD')) AS result FROM dual;
-- 結果: 3
SELECT MONTHS_BETWEEN(TO_DATE('2024-01-15', 'YYYY-MM-DD'), TO_DATE('2024-04-15', 'YYYY-MM-DD')) AS result FROM dual;
-- 結果: -3注意点
- 年と月が同じで日が異なる場合、日数の違いが小数部に反映されます。
SELECT MONTHS_BETWEEN(TO_DATE('2024-01-31', 'YYYY-MM-DD'), TO_DATE('2024-01-01', 'YYYY-MM-DD')) AS result FROM dual;
-- 結果: 約1 (30日分が加算されます)応用例
例えば、ローン返済の期間を計算する際に使用します。
SELECT loan_id, MONTHS_BETWEEN(payment_due_date, loan_start_date) AS repayment_period
FROM loans;3. NEXT_DAY
**NEXT_DAY(date, weekday)**は、指定した日付から次の指定の曜日の日付を返します。曜日は文字列で指定します。
使用例
移動前の日付: 2024-01-15 (月曜日)
SELECT NEXT_DAY(TO_DATE('2024-01-15', 'YYYY-MM-DD'), '金') AS result FROM dual;
-- 結果: 2024-01-19 (金曜日)注意点
- 曜日指定はデータベースの言語設定に依存します。
- 英語環境の場合、使用可能な曜日: ‘SUNDAY’, ‘MONDAY’, ‘TUESDAY’, ‘WEDNESDAY’, ‘THURSDAY’, ‘FRIDAY’, ‘SATURDAY’
実践例
次回の支払い日を計算する際に役立ちます。
SELECT customer_id, NEXT_DAY(payment_date, '金') AS next_payment_date
FROM payments;4. LAST_DAY
**LAST_DAY(date)**は、指定した日付が含まれる月の最後の日付を返します。
使用例
SELECT LAST_DAY(TO_DATE('2024-01-15', 'YYYY-MM-DD')) AS result FROM dual;
-- 結果: 2024-01-31
SELECT LAST_DAY(TO_DATE('2024-02-10', 'YYYY-MM-DD')) AS result FROM dual;
-- 結果: 2024-02-29注意点
- 入力日付が閏年の2月に該当する場合、正しい最後の日付を計算します。
応用例
例えば、月末の締め処理を計算する際に使用します。
SELECT employee_id, LAST_DAY(payment_date) AS payroll_cutoff_date
FROM payroll;5. SYSDATE
SYSDATEは、クエリー実行時点のデータベースサーバーの現在の日時を返します。
使用例
SELECT SYSDATE AS result FROM dual;
-- 結果: 現在日時 (2024-12-30 10:00:00 のような形式)
SELECT SYSDATE + 7 AS next_week FROM dual;
-- 結果: 現在日時から一週間後注意点
- SYSDATEの結果はデータベースサーバーのタイムゾーンに基づきます。
- クライアントのタイムゾーンと異なる場合があるため、注意が必要です。
応用例
例えば、今日の日付を基準にしたプロモーション期間の設定。
SELECT SYSDATE AS today, SYSDATE + 30 AS promotion_end_date
FROM dual;FAQ
Q: NEXT_DAYで無効な曜日を指定した場合どうなりますか？
A: エラーが発生します。曜日はデータベースの言語設定に依存するため、設定を確認してください。
Q: ADD_MONTHSで負の値を指定した場合の動作は？
A: 負の値を指定すると過去の日付が計算されます。月末調整も適用されます。
まとめ
これらのファンクションは日時情報の処理に対して強力なツールです。各ファンクションのロジックを理解して、実際のビジネスシーンに引き添えてみてください。また、使用時にはタイムゾーンやデータベースの言語設定などの環境依存要素に注意することが重要です。視覚的な表現や実践例を通じて、さらなる活用を目指してください。
[参考]
Oracle Database SQL言語リファレンス 19c
コメント