Cos'e' "JCalendar"

"JCalendar" e' una dialog swing per l'editing visuale di data ed ora.
Le caratteristiche principali sono:

• Visualizzazione dei nomi a seconda delle impostazioni internazionali del software che lo usa
• Editing dell'ora e dell'anno tramite spin.

Perche' usare "JCalendar"

E' un componente molto utile per la modifica visuale delle date. Ne esistono molte implementazioni in circolazione, questa e' la mia. Dal momento che java standard non prevede un componente simile, il suo utilizzo potrebbe essere un buon modo di non ricreare ogni volta una maschera apposita per l'editing di data ed ora.

Il futuro di "JCalendar"

In futuro, dipendentemente dal mio tempo libero (che e' sempre molto poco...), potranno esserci

1. Possibilita' di non usare l'editor dell'ora
2. ottimizzazioni sulle prestazioni e sul codice
3. correzioni di bug, se ne trovo e se me ne vengono segnalati
4. realizzazione del Javadoc
5. supporto saltuario e improbabile (nel senso che vengono prima gli altri impegni) a coloro che intendono usare seriamente la libreria (non ci prendo una lira... ehm... un euro).

1. alcuno sforzo per rendere il sistema uno standard di sviluppo: l'ho scritto per piacere ed utilita' personali!
2. alcun impegno costante e regolare nella scrittura di codice
3. alcuna risposta a email provocatorie del tipo "ma che hai scritto...", "non capisci niente...", "che e' sto schifo...", fatica inutile!

Esempio di utilizzo

Il seguente esempio apre la dialog implementante il calendario senza usare l'owner. Tipicamente verranno usati i costruttori che prevedono il passaggio dell'owner, dal momento che l'apertura di questa dialog sara' sempre subordinata ad un'altro frame, dialog o simile.

        JCalendar cal = new JCalendar("Ok", "Cancel", Locale.ITALIAN);
        //Dimensioni minime e precise
        cal.pack();
        //Modale: non si va avanti fino alla chiusura della dialog
        cal.setModal(true);
        //Visualizzazione del calendario e attesa di una scelta
        cal.setVisible(true);
        //STATE_OK=data selezionata
        //STATE_CANCEL=selezione annullata
        if (cal.getState()==JCalendar.STATE_OK){
            System.out.println("Selected date = " + cal.getSelectedDay().getTime());
        }
        else {
            System.out.println("Date not selected");
        }

Screenshot

Ecco uno screenshot del JCalendar.