Agregar meses a fechas sin exceder el fin de mes

Introducción

Al manipular fechas, resulta esencial evitar situaciones en las que se exceda el fin de mes sin darse cuenta. Este artículo explora un enfoque confiable para agregar meses a una fecha determinada y al mismo tiempo garantizar que permanezca dentro de los límites del mes objetivo.

Declaración del problema

Dada una función PHP, el objetivo es agregar una número especificado de meses hasta una fecha sin exceder el final del mes. La función debe ajustar el resultado al último día del mes si la adición provocaría un desbordamiento.

Solución

Para lograr la funcionalidad deseada, puede utilizar los siguientes pasos:

1. Convierta la fecha de la cadena de entrada en un objeto DateTime usando el nuevo DateTime($date_str).
2. Extraiga el día del mes antes de la modificación usando $start_day = $date->format('j').
3. Utilice $date->modify(" {$months} ​​mes") para incrementar el mes en consecuencia.
4. Obtenga el día del mes después de la modificación con $end_day = $date->format('j').
5. Compare $start_day y $end_day. Si difieren indica que se ha superado el fin de mes. En ese caso, ajuste la fecha al último día del mes anterior usando $date->modify('último día del mes pasado').

Implementación

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

Conclusión

Al seguir este enfoque, puedes agregar meses a fechas con confianza en PHP mientras cumples con las restricciones de fin de mes, asegurando que tus resultados representen con precisión el plazo previsto.