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 год сохраняет смысл интервала длиннее года.

См. документацию Oracle: MONTHS_BETWEEN.