MONTHS_BETWEEN
📖 Описание
Функция Oracle/PLSQL MONTHS_BETWEEN возвращает количество месяцев между date1 и date2.
🧩 Синтаксис
MONTHS_BETWEEN(date1, date2)
⚙️ Параметры и аргументы
date1 и date2 — даты для расчёта. Результат имеет тип NUMBER: положительный, если date1 позже date2, отрицательный — если раньше.
Примечание
- При одинаковых номерах дня месяца или если обе даты являются последними днями своих месяцев результат целый.
- В остальных случаях дробная часть вычисляется по условному 31-дневному месяцу с учётом времени суток.
- Месяцы и их последние дни определяет NLS_CALENDAR; ниже используется GREGORIAN.
💻 Примеры
SELECT ROUND(MONTHS_BETWEEN(DATE '2026-02-09', DATE '2026-04-17'), 8)
FROM dual;
-- Результат: -2.25806452
SELECT MONTHS_BETWEEN(DATE '2026-07-12', DATE '2026-07-12') FROM dual;
-- Результат: 0
SELECT MONTHS_BETWEEN(DATE '2026-10-12', DATE '2026-07-12') FROM dual;
-- Результат: 3
Часто задаваемые вопросы
Как выразить число дней в годах, месяцах и днях?
Нужна начальная дата: календарные месяцы имеют разную длину. Ниже 480 дней отсчитываются от 10 февраля 2026 года; конечная дата — 5 июня 2027 года. Выберем максимальное число месяцев, которое можно добавить через ADD_MONTHS, не выходя за конечную дату, и посчитаем остаток дней.
WITH start_point AS (
SELECT DATE '2026-02-10' AS start_date, 480 AS day_count FROM dual
), date_bounds AS (
SELECT start_date, start_date + day_count AS end_date
FROM start_point
), candidate AS (
SELECT start_date, end_date,
MONTHS_BETWEEN(TRUNC(end_date, 'MM'),
TRUNC(start_date, 'MM')) AS months_guess
FROM date_bounds
), full_months AS (
SELECT start_date, end_date,
months_guess - CASE
WHEN ADD_MONTHS(start_date, months_guess) > end_date THEN 1
ELSE 0
END AS month_count
FROM candidate
)
SELECT FLOOR(month_count / 12) AS years_part,
MOD(month_count, 12) AS months_part,
end_date - ADD_MONTHS(start_date, month_count) AS days_part
FROM full_months;
| YEARS_PART | MONTHS_PART | DAYS_PART |
|---|---|---|
| 1 | 3 | 26 |
15 месяцев приводят к 10 мая 2027 года, после чего остаётся 26 дней. Поправка проверяет фактический результат ADD_MONTHS, включая особые правила конца месяца. Запрос рассчитан на даты без времени, end_date ≥ start_date и григорианский календарь; иные правила расчёта стажа нужно задавать отдельно.
Используются TRUNC, FLOOR и MOD. Переход в 2027 год сохраняет смысл интервала длиннее года.