Fundo
Temos contratos de serviço que podem começar e terminar em qualquer data arbitrária. Normalmente, porém, os contratos terminam em “X anos menos um dia”. Por exemplo, intervalos de datas típicos:
- Data de início = 08/01/2018, Data de término = 07/01/2023
- Data de início = 01/06/2021, Data de término = 31/05/2023
No entanto, alguns contratos abrangem intervalos de datas muito arbitrários. Alguns são muito curtos, mas também podem durar alguns anos:
- Data de início = 30/04/2024, Data de término = 16/07/2024
- Data de início = 07/10/2024, Data de término = 30/10/2024
- Data de início = 15/03/2021, Data de término = 25/12/2025
Requerimento
Calcule o número de meses que o contrato abrange, para determinar quantas faturas mensais serão criadas durante a vigência do contrato. Suponha que as faturas sejam geradas no último dia do mês, portanto, um contrato com data de início em 15 de abril teria sua primeira fatura gerada em 30 de abril para a "Fatura de abril".
Problema
Usar apenas DATEDIFF(MONTH, @Date1, @Date2) produz resultados que nem sempre estão alinhados com o requisito.
Quando digo abaixo "produz um resultado incorreto", não quero dizer que a
DATEDIFF()
função esteja errada, estou dizendo que não é o resultado que preciso para minha exigência.
PRINT DATEDIFF(MONTH, '2018-01-08', '2023-01-07')
produz um resultado correto de 60 meses.PRINT DATEDIFF(MONTH, '2021-06-01', '2023-05-31')
produz um resultado incorreto de 23 meses, onde preciso de um resultado de 24.PRINT DATEDIFF(MONTH, '2024-10-07', '2024-10-30')
produz um resultado incorreto de 0, onde preciso de um resultado de 1.PRINT DATEDIFF(MONTH, '2024-04-15', '2024-07-16')
produz um resultado incorreto de 3, onde preciso de um resultado de 4PRINT DATEDIFF(MONTH, '2024-10-07', '2024-10-30')
produz um resultado incorreto de 0, onde preciso de um resultado de 1.PRINT DATEDIFF(MONTH, '2024-09-15', '2024-10-15')
produz um resultado incorreto de 1, onde preciso de um resultado de 2.
Portanto, não posso apenas + 1
o DATEDIFF()
resultado para todos os casos. Quando um contrato começa e termina no mesmo mês do mesmo ano, DATEDIFF()
produz um in
Solução atual
Esta é a minha solução atual:
PRINT CASE
WHEN MONTH(@StartDate) = MONTH(@EndDate) AND YEAR(@StartDate) = YEAR(@EndDate)
-- Special case when a contract starts and ends in the same month and year.
THEN DATEDIFF(MONTH, @StartDate, @EndDate) + 1
WHEN MONTH(@StartDate) = MONTH(@EndDate)
THEN DATEDIFF(MONTH, @StartDate, @EndDate)
ELSE
DATEDIFF(MONTH, @StartDate, @EndDate) + 1
END
Esta é minha solução atual na forma de 5 testes de diferentes períodos:
DECLARE @StartDate AS DATE = '2018-01-08'
DECLARE @EndDate AS DATE = '2023-01-07'
PRINT '-------------------------------------------------------'
PRINT 'Test #1: @StartDate = 2018-01-08, @EndDate = 2023-01-07'
PRINT '-------------------------------------------------------'
PRINT ''
IF MONTH(@StartDate) = MONTH(@EndDate) AND YEAR(@StartDate) = YEAR(@EndDate)
PRINT 'The dates contain the same month and year. We are adding 1 to the DATEDIFF() result.'
ELSE IF
MONTH(@StartDate) = MONTH(@EndDate)
PRINT 'The dates contain the same months. We are NOT adding 1 to the DATEDIFF() result.'
ELSE
PRINT 'The dates contain the different months. We are adding 1 to the DATEDIFF() result.'
PRINT CASE
WHEN MONTH(@StartDate) = MONTH(@EndDate) AND YEAR(@StartDate) = YEAR(@EndDate)
-- Special case when a contract starts and ends in the same month and year.
THEN DATEDIFF(MONTH, @StartDate, @EndDate) + 1
WHEN MONTH(@StartDate) = MONTH(@EndDate)
THEN DATEDIFF(MONTH, @StartDate, @EndDate)
ELSE
DATEDIFF(MONTH, @StartDate, @EndDate) + 1
END
PRINT ''
PRINT '-------------------------------------------------------'
PRINT 'Test #2: @StartDate = 2021-06-01, @EndDate = 2023-05-31'
PRINT '-------------------------------------------------------'
PRINT ''
SET @StartDate = '2021-06-01'
SET @EndDate = '2023-05-31'
IF MONTH(@StartDate) = MONTH(@EndDate) AND YEAR(@StartDate) = YEAR(@EndDate)
PRINT 'The dates contain the same month and year. We are adding 1 to the DATEDIFF() result.'
ELSE IF
MONTH(@StartDate) = MONTH(@EndDate)
PRINT 'The dates contain the same months. We are NOT adding 1 to the DATEDIFF() result.'
ELSE
PRINT 'The dates contain the different months. We are adding 1 to the DATEDIFF() result.'
PRINT CASE
WHEN MONTH(@StartDate) = MONTH(@EndDate) AND YEAR(@StartDate) = YEAR(@EndDate)
-- Special case when a contract starts and ends in the same month and year.
THEN DATEDIFF(MONTH, @StartDate, @EndDate) + 1
WHEN MONTH(@StartDate) = MONTH(@EndDate)
THEN DATEDIFF(MONTH, @StartDate, @EndDate)
ELSE
DATEDIFF(MONTH, @StartDate, @EndDate) + 1
END
PRINT ''
PRINT '-------------------------------------------------------'
PRINT 'Test #3: @StartDate = 2024-04-30, @EndDate = 2024-07-16'
PRINT '-------------------------------------------------------'
PRINT ''
SET @StartDate = '2024-04-30'
SET @EndDate = '2024-07-16'
IF MONTH(@StartDate) = MONTH(@EndDate) AND YEAR(@StartDate) = YEAR(@EndDate)
PRINT 'The dates contain the same month and year. We are adding 1 to the DATEDIFF() result.'
ELSE IF
MONTH(@StartDate) = MONTH(@EndDate)
PRINT 'The dates contain the same months. We are NOT adding 1 to the DATEDIFF() result.'
ELSE
PRINT 'The dates contain the different months. We are adding 1 to the DATEDIFF() result.'
PRINT CASE
WHEN MONTH(@StartDate) = MONTH(@EndDate) AND YEAR(@StartDate) = YEAR(@EndDate)
-- Special case when a contract starts and ends in the same month and year.
THEN DATEDIFF(MONTH, @StartDate, @EndDate) + 1
WHEN MONTH(@StartDate) = MONTH(@EndDate)
THEN DATEDIFF(MONTH, @StartDate, @EndDate)
ELSE
DATEDIFF(MONTH, @StartDate, @EndDate) + 1
END
PRINT ''
PRINT '-------------------------------------------------------'
PRINT 'Test #4: @StartDate = 2024-10-07, @EndDate = 2024-10-30'
PRINT '-------------------------------------------------------'
PRINT ''
SET @StartDate = '2024-10-07'
SET @EndDate = '2024-10-30'
IF MONTH(@StartDate) = MONTH(@EndDate) AND YEAR(@StartDate) = YEAR(@EndDate)
PRINT 'The dates contain the same month and year. We are adding 1 to the DATEDIFF() result.'
ELSE IF
MONTH(@StartDate) = MONTH(@EndDate)
PRINT 'The dates contain the same months. We are NOT adding 1 to the DATEDIFF() result.'
ELSE
PRINT 'The dates contain the different months. We are adding 1 to the DATEDIFF() result.'
PRINT CASE
WHEN MONTH(@StartDate) = MONTH(@EndDate) AND YEAR(@StartDate) = YEAR(@EndDate)
-- Special case when a contract starts and ends in the same month and year.
THEN DATEDIFF(MONTH, @StartDate, @EndDate) + 1
WHEN MONTH(@StartDate) = MONTH(@EndDate)
THEN DATEDIFF(MONTH, @StartDate, @EndDate)
ELSE
DATEDIFF(MONTH, @StartDate, @EndDate) + 1
END
PRINT ''
PRINT '-------------------------------------------------------'
PRINT 'Test #5: @StartDate = 2024-09-15, @EndDate = 2024-10-15'
PRINT '-------------------------------------------------------'
PRINT ''
SET @StartDate = '2024-09-15'
SET @EndDate = '2024-10-15'
IF MONTH(@StartDate) = MONTH(@EndDate) AND YEAR(@StartDate) = YEAR(@EndDate)
PRINT 'The dates contain the same month and year. We are adding 1 to the DATEDIFF() result.'
ELSE IF
MONTH(@StartDate) = MONTH(@EndDate)
PRINT 'The dates contain the same months. We are NOT adding 1 to the DATEDIFF() result.'
ELSE
PRINT 'The dates contain the different months. We are adding 1 to the DATEDIFF() result.'
PRINT CASE
WHEN MONTH(@StartDate) = MONTH(@EndDate) AND YEAR(@StartDate) = YEAR(@EndDate)
-- Special case when a contract starts and ends in the same month and year.
THEN DATEDIFF(MONTH, @StartDate, @EndDate) + 1
WHEN MONTH(@StartDate) = MONTH(@EndDate)
THEN DATEDIFF(MONTH, @StartDate, @EndDate)
ELSE
DATEDIFF(MONTH, @StartDate, @EndDate) + 1
END
Resultados:
-------------------------------------------------------
Test #1: @StartDate = 2018-01-08, @EndDate = 2023-01-07
-------------------------------------------------------
The dates contain the same months. We are NOT adding 1 to the DATEDIFF() result.
60
-------------------------------------------------------
Test #2: @StartDate = 2021-06-01, @EndDate = 2023-05-31
-------------------------------------------------------
The dates contain the different months. We are adding 1 to the DATEDIFF() result.
24
-------------------------------------------------------
Test #3: @StartDate = 2024-04-30, @EndDate = 2024-07-16
-------------------------------------------------------
The dates contain the different months. We are adding 1 to the DATEDIFF() result.
4
-------------------------------------------------------
Test #4: @StartDate = 2024-10-07, @EndDate = 2024-10-30
-------------------------------------------------------
The dates contain the same month and year. We are adding 1 to the DATEDIFF() result.
1
-------------------------------------------------------
Test #5: @StartDate = 2024-09-15, @EndDate = 2024-10-15
-------------------------------------------------------
The dates contain the different months. We are adding 1 to the DATEDIFF() result.
2
Os resultados correspondem aos meus requisitos, para os 5 conjuntos de intervalos de datas de teste.
Pergunta
Existe uma maneira mais confiável de fazer isso, além da minha CASE
declaração desajeitada? Certamente não estou reinventando a roda aqui. Tenho certeza de que há mais casos extremos de intervalos de datas que ainda não pensei em testar. Estou fazendo isso da maneira mais difícil?