Adicionando meses a datas sem exceder o final do mês

Introdução

Ao manipular datas, torna-se essencial evitar situações em que o final do mês seja excedido inadvertidamente. Este artigo explora uma abordagem confiável para adicionar meses a uma determinada data, garantindo que ela permaneça dentro dos limites do mês de destino.

Declaração do problema

Dada uma função PHP, o objetivo é adicionar um determinado número de meses até uma data sem exceder o final do mês. A função deve ajustar o resultado para o último dia do mês se a adição levar a uma repercussão.

Solução

Para obter a funcionalidade desejada, você pode utilizar as seguintes etapas:

1. Converta a data da string de entrada em um objeto DateTime usando new DateTime($date_str).
2. Extraia o dia do mês antes da modificação usando $start_day = $date->format('j ').
3. Use $date->modify(" {$months}month") para incrementar o mês adequadamente.
4. Obtenha o dia do mês após a modificação com $end_day = $ data->formato('j').
5. Compare $start_day e $end_day. Se forem diferentes, indica que o final do mês foi excedido. Nesse caso, ajuste a data para o último dia do mês anterior usando $date->modify('último dia do mês passado').

Implementação

function add($date_str, $months)
{
    $date = new DateTime($date_str);

    $start_day = $date->format('j');

    $date->modify(" {$months} month");

    $end_day = $date->format('j');

    if ($start_day != $end_day)
    {
        $date->modify('last day of last month');
    }

    return $date;
}

// Sample tests
$result = add('2011-01-28', 1);   // 2011-02-28
$result = add('2011-01-31', 3);   // 2011-04-30
$result = add('2011-01-30', 13);  // 2012-02-29
$result = add('2011-10-31', 1);   // 2011-11-30
$result = add('2011-12-30', 1);   // 2011-02-28

Conclusão

Ao seguir esta abordagem, você pode adicionar meses às datas com segurança em PHP, ao mesmo tempo em que segue as restrições do final do mês, garantindo que seus resultados representem com precisão o prazo pretendido.