Java / GregorianCalendar.add

Bienvenidos sean a este post, hoy veremos un metodo de GregorianCalendar.

Este metodo agrega una cantidad de tiempo a un campo de la fecha en base al campo que especifiquemos. Veamos su sintaxis:

objeto.add(campo, valor);

Se aplica directamente al objeto, el primer argumento es el campo que modificaremos. El segundo argumento es el valor que deseamos incrementar en ese campo. Analicemos el siguiente ejemplo:

import java.util.*;

public class Gregorio
{
        public static void main(String[] args)
        {
                GregorianCalendar cal = new GregorianCalendar();
                System.out.println(cal.getTime());
                cal.add((GregorianCalendar.MONTH), 4);
                System.out.println(cal.getTime());
        }
}

Primero generamos un objeto de tipo GregorianCalendar, este almacenara la fecha y hora del momento que es ejecutado el programa. La siguiente linea es para mostrar la fecha almacenada, para luego incrementar el mes contenido con cuatro mediante el metodo, para establecer el campo usamos la propiedad MONTH de GregorianCalendar para que el metodo sepa cual es. Y finalmente, mostramos el nuevo valor en cal. Compilemos y veamos como es la salida:

$ java Gregorio
Sun Feb 02 15:58:12 ART 2025
Mon Jun 02 15:58:12 ART 2025
$

Observen como paso de febrero a junio que es el nuevo valor despues de incrementado. Tomemos el codigo anterior, y busquemos la siguiente linea:

cal.add((GregorianCalendar.MONTH), 4);

Y hagamos el siguiente cambio:

cal.add((GregorianCalendar.MONTH), 13);

En este caso, incrementamos a la fecha en trece meses, si lo compilamos nuevamente nos devolvera la siguiente salida:

$ java Gregorio
Sun Feb 02 16:10:36 ART 2025
Mon Mar 02 16:10:36 ART 2026
$

Observen que se modifico el mes pero tambien el año porque lo incrementamos mas de un año. Esto sucede con los dias, horas, minutos y segundos. Siempre que los incrementemos con un valor superior al que soporta, incrementara al otro campo tambien. En este caso, incremento el año (12 meses) y el resto que le sobra lo uso para los meses internos.

En resumen, hoy hemos visto GregorianCalendar.add, que es, para que sirve, como se utiliza, un ejemplo practico para verlo en accion, y una pequeña rareza que posee para ver su conducta. Espero les haya resultado de utilidad sigueme en tumblr, Twitter o Facebook para recibir una notificacion cada vez que subo un nuevo post en este blog, nos vemos en el proximo post.