JCalendar Java Swing Tutorial.

Tutorial del JCalendar con ejemplos, Java Swing.

---

Que mejor manera de controlar la fecha que un usuario ingresa que con un calendario en donde con un simple clic ya obtengamos Año, Mes y Día, en Java Swing no trae por defecto un componente que facilite este comportamiento, así que por eso hay que descargar una librería externa llamada JCalendar, dicha librería tiene varias funcionalidades, podemos elegir desde un calendario la fecha completa, la fecha de hoy, elegir una fecha maxima o minima para seleccionar, elegir solo un día, año o mes... En fin en este Tutorial de JCalendar vamos hacer varios ejemplos con las funcionalidades que ofrece utilizando el IDE JBoss Developer Studio o eclipse.

Tabla De Contenidos

      1. Descargar JCalendar.
      2. Crear proyecto Java.
      3. Ejemplo de JCalendar.
      4. Ejemplo de JDateChooser.
      5. Ejemplo de JTextFieldDateEditor.
      6. Ejemplo de JDayChooser.
      7. Ejemplo de JMonthChooser.
      8. Ejemplo de JYearChooser.

1. Descargar JCalendar.

Para realizar los ejemplos tenemos que descargar jcalendar-1.4.jar, y luego importarlo a nuestro classpath, puedes descargarlo desde aquí.

2. Crear proyecto Java.

Vamos a crear desde nuestro IDE un simple "Java Project" con el nombre de JCalendarDatoJava. Para eso recordamos que vamos a la opción de File> New> Java Project.

Nuevo Java Project.

Una vez creado, en la carpeta src, creamos un paquete llamado datojava.jcalendar, y dentro del mismo vamos a crear la clase DJJCalendar en la cual vamos a desarrollar los ejemplos, aparte de eso vamos a crear otra clase llamada DJFechasEspInv que extiende de la interface IDateEvaluator en la cual vamos a desarrollar un ejemplo agregando fechas especiales/invalidas a nuestro JCalendar. Por ultimo importamos la librería jcalendar-1.4.jar al classpath de nuestro proyecto y esta es la estructura que debería tener hasta ahora nuestro proyecto:

Estructura JCalendar.

3. Ejemplo de JCalendar.

Hay varios componentes que ofrece esta librería, entre ellos esta el mas común JCalendar, que no es mas que un calendario en el cual podremos elegir una fecha:

JCalendar.

Este es el codigo para utilizar el componente JCalendar:

private JCalendar calendar;

// Instanciar Componente
calendar = new JCalendar();

// Ubicar y agregar al panel
calendar.setBounds...

panel.add(calendar);
  

A este JCalendar podemos agregarle/quitarle varias cosas, por ejemplo para agregar un boton que nos permita elegir la fecha de hoy:

  calendar.setTodayButtonVisible(true);
  

A ese boton podemos cambiarle el label (por defecto es "Hoy") de esta manera:

  calendar.setTodayButtonText("Hoy Día");
  

También podemos agregarle un boton para no seleccionar ninguna fecha:

  calendar.setNullDateButtonVisible(true);
  

Y de igual manera podemos cambiar el label por defecto ("Sin fecha"), así se ve el JCalendar con los botones:

JCalendar Botones.

Si detallamos la imagen del calendario, podemos observar que muestra varios datos que a veces son innecesarios dependiendo de la aplicación, podemos hacer una que otra modificación quitandole o agregandole varias cosas.
Para quitar el numero de semanas:

  calendar.setWeekOfYearVisible(false);
  

JCalendar Sin Numero de semanas.

Para incrementar/decrementar la cantidad de caracteres que tiene el label de los días:

    calendar.setMaxDayCharacters(1);
  

JCalendar Primera Letra Del Día.

Cambiar color de letra de los días de semana, fin de semana o numero de día:

  // Cambiar color de letra del numero de día 
  calendar.setForeground(Color.GREEN);
  
  // Cambiar color de letra del dia domingo
  calendar.setSundayForeground(Color.BLUE);

  // Cambiar color de letra de semana
  calendar.setWeekdayForeground(Color.RED);
  

Establecer una fecha en el JCalendar:

  Calendar calendario = new GregorianCalendar(2014,5,10);
  calendar.setDate(calendario.getTime());
  

JCalendar establecer fecha.

Establecer la fecha maxima/minima que puede elegir un usuario:

  // Fecha minima seleccionable
  calendar.setMinSelectableDate(new Date());

  // Fecha maxima seleccionable
  calendar.setMaxSelectableDate(new Date());
  

Para establecer algunas fechas especiales o invalidas en el JCalendar, implementamos la clase DJFechasEspInv que creamos anteriormente, si por ejemplo queremos establecer como fecha especial el día 24 de diciembre y como fecha invalida el dia 01 de Enero:

package datojava.jcalendar;

import java.awt.Color;
import java.util.Calendar;
import java.util.Date;

import com.toedter.calendar.IDateEvaluator;

public class DJFechasEspInv implements IDateEvaluator {

 Calendar calendar = Calendar.getInstance();

 public DJFechasEspInv() {

 }

 @Override
 public boolean isSpecial(Date date) {
  calendar.setTime(date);
  return calendar.get(Calendar.MONTH) == Calendar.DECEMBER
    && calendar.get(Calendar.DAY_OF_MONTH) == 24;
 }

 @Override
 public Color getSpecialForegroundColor() {
  return Color.GREEN;
 }

 @Override
 public Color getSpecialBackroundColor() {
  return Color.WHITE;
 }

 @Override
 public String getSpecialTooltip() {
  return "Es Navidad";
 }

 @Override
 public boolean isInvalid(Date date) {
  calendar.setTime(date);
  return calendar.get(Calendar.MONTH) == Calendar.JANUARY
    && calendar.get(Calendar.DAY_OF_MONTH) == 01;
 }

 @Override
 public Color getInvalidForegroundColor() {
  return Color.WHITE;
 }

 @Override
 public Color getInvalidBackroundColor() {
  return Color.BLACK;
 }

 @Override
 public String getInvalidTooltip() {
  return "No es día Laborable";
 }
}
  

Explicando un poco el codigo, en la implementación del metodo boolean isSpecial(Date date) (18), obtenemos la fecha y verificamos si coincide con el día "24 de Diciembre", en caso de ser cierto, ese día tendrá la letra de color verde (Color getSpecialForegroundColor() (25)) y el fondo de color blanco (Color getSpecialBackroundColor() (30)), adicionalmente vamos agregarle el ToolTip con la descripción del día especial (String getSpecialTooltip() (35)), lo propio hacemos con el día invalido que en este caso es el día "01 de Enero" (boolean isInvalid(Date date) (40)), con la letra de color blanco (Color getInvalidForegroundColor() (47)), el fondo de color negro (Color getInvalidBackroundColor() (52)) y la descripción correspondiente (String getInvalidTooltip() (57)). Ahora tenemos que agregarle esta clase el calendar:

  calendar.getDayChooser().addDateEvaluator(new DJFechasEspInv());
  

Ya con eso funciona, pero en el caso de que necesitemos hacer algo como esto no creo que sea solo con una fecha, así que para agregar varias fechas se complica un poco, pero para todo hay solución. En la clase DJJCalendar tenemos que hacer dos metodos, uno en el cual crearemos una lista con todas las fechas especiales y otro con una lista de ToolTip por cada fecha especial, en el caso de que queramos agregar fechas invalidas creamos otro metodo adicional.
Metodo que retorna la lista de fechas especiales:

 public static List fechasEspeciales() {
  List fechas = new ArrayList();
  
  Calendar calendar = new GregorianCalendar(2015, Calendar.SEPTEMBER, 10);
  fechas.add(calendar);
  calendar = new GregorianCalendar(2015, Calendar.NOVEMBER, 10);
  fechas.add(calendar);
  calendar = new GregorianCalendar(2015, Calendar.NOVEMBER, 18);
  fechas.add(calendar);

  return fechas;
 }
  

Metodo que retorna la lista de ToolTip por cada fecha:

  public static List tipFechas() {
  List tips = new ArrayList();

  tips.add("Septiembre 10");
  tips.add("Noviembre 10");
  tips.add("Noviembre 18");

  return tips;
 }
 

Ahora en la implementación del metodo boolean isSpecial(Date date) recorremos la lista de fechas especiales y vamos pintando en el calendario las mismas:

 private int i = 0;
 
 @Override
 public boolean isSpecial(Date date) {
  calendar.setTime(date);
  for (i = 0; i < DJJCalendar.fechasEspeciales().size(); i++) {
   if (calendar.get(Calendar.MONTH) == DJJCalendar.fechasEspeciales()
     .get(i).get(Calendar.MONTH)
     && calendar.get(Calendar.DAY_OF_MONTH) == DJJCalendar
       .fechasEspeciales().get(i)
       .get(Calendar.DAY_OF_MONTH)) {
    return true;
   }
  }
  return false;
 }
  

Hacemos lo propio en el metodo String getSpecialTooltip(), obtenemos la descripción en la posición correspondiente y la pintamos en el calendario

 @Override
 public String getSpecialTooltip() {
  return DJJCalendar.tipFechas().get(i);
 }
  

Hay mas propiedades con las que podemos jugar, todo depende de lo que necesitemos para nuestra aplicación.

4. Ejemplo de JDateChooser.

El JDateChooser es mucho mas util, ya que este componente nos presenta un campo de texto con un boton al lado, que al presionarlo nos muestra el JCalendar descrito anteriormente, y al momento de seleccionar la fecha, la misma se muestra en el campo de texto:

JDateChooser.

Este es el codigo para utilizar el componente JDateChooser:

 
private JDateChooser dateChooser;

// Instanciar Componente
dateChooser = new JDateChooser();

// Ubicar y agregar al panel
dateChooser.setBounds...

panel.add(calendar);
  

Obviamente a este componente también podemos modificarle sus propiedades, y como en si es otro JCalendar pero con un campo de texto, son practicamente las mismas propiedades, por ejemplo para obtener el JCalendar y aplicar las modificaciones anteriores necesitamos este codigo:

  dateChooser.getJCalendar();
  

En el campo de texto que ofrece JDateChooser el usuario puede ingresar la fecha manualmente, en el caso de que ingrese cualquier tontería se mostrará en rojo y al obtener la fecha la misma sera null, para controlar este comportamiento podemos agregar un patron, una mascara, que le indique al usuario como debe ingresar la fecha si lo quiere hacer de forma manual. Con este codigo:

  JDateChooser dateChooser = new JDateChooser("yyyy/MM/dd", "####/##/##", '_');
 

Indicamos que solo puede ingresar numeros, año/mes/día y en el campo de texto se mostrará este patron "____/__/__" mientras no ingrese o seleccione una fecha.

JDateChooser Máscara.

Podemos agregar un JSpinnerDateEditor, para que cuando el usuario ingrese una fecha pueda desplazarse sobre la misma.

  JDateChooser dateChooser = new JDateChooser(null, null, null,
    new JSpinnerDateEditor());
  

JDateChooser JSpinnerDateEditor.

Para obtener la fecha de un JDateChooser.

   dateChooser.getDate();
 

Como hemos visto el JDateChooser no es mas que un campo de texto con un JCalendar que hace de popup al momento de presionar un boton.

5. Ejemplo de JTextFieldDateEditor.

También podemos utilizar solamente el campo de texto JTextFieldDateEditor de esta manera.

private JTextFieldDateEditor textFieldDateEditor;

// Instanciar Componente
textFieldDateEditor = new JTextFieldDateEditor("yyyy/MM/dd",
    "####/##/##", '_');

// Ubicar y agregar al panel
textFieldDateEditor.setBounds...

panel.add(textFieldDateEditor);
 

JTextFieldDateEditor.

Esto puede ser util dependiendo del tipo de aplicación.

Pasando a otros componentes utiles, podemos ver el JDayChooser, JMonthChooser y el JYearChooser.

6. Ejemplo de JDayChooser.

JDayChooser:

private JDayChooser dayChooser;

// Instanciar Componente
dayChooser = new JDayChooser();

// Ubicar y agregar al panel
dayChooser.setBounds...

panel.add(dayChooser);
  

JDayChooser.

7. Ejemplo de JMonthChooser.

JMonthChooser

private JMonthChooser monthChooser;

// Instanciar Componente
monthChooser = new JMonthChooser();

// Ubicar y agregar al panel
monthChooser.setBounds...

panel.add(monthChooser);
  

JMonthChooser.

8. Ejemplo de JYearChooser.

JYearChooser

private JYearChooser yearChooser;

// Instanciar Componente
yearChooser = new JYearChooser();

// Ubicar y agregar al panel
yearChooser.setBounds...

panel.add(yearChooser);
  

JYearChooser.

Llegando al final de este Tutorial de JCalendar Swing, se puede decir que es una buena librería, muy util en aplicaciones Java Swing. Recuerda que esto fue un repaso, se puede lograr algo mucho mas potente, aquí te dejo el proyecto con los ejemplos para que lo descargues. Suerte.

Temas Relacionados:

• Tutorial de Aplicación Java Swing, ejemplo simple y sencillo.
• Vaciar DefaultTableModel JTable Swing.
• Enviar correos desde Java con Javamail.