prog.utili
Class Data

java.lang.Object
  |
  +--prog.utili.Data

All Implemented Interfaces:

java.lang.Comparable, java.io.Serializable

public class Data

extends java.lang.Object

implements java.lang.Comparable, java.io.Serializable

Le sue istanze rappresentano date del calendario.

Version:

1.0

Author:

Mauro Ferrari, Giovanni Pighizzini

See Also:

Serialized Form

Constructor Summary

Data()
Costruisce una nuova data che rappresenta la data corrente.

Data(int gg, int mm, int aaaa)
Costruisce una nuova data a partire dai tre argomenti che rappresentano, nell'ordine, giorno, mese e anno.

Data(java.lang.String str)
Costruisce una nuova data a partire da una stringa nel formato "gg.mm.aaaa".

Method Summary

int	compareTo(java.lang.Object o) Confronta l'oggetto che esegue il metodo con quello specificato come argomento.
boolean	equals(Data altra) Restituisce true se e solo la data che esegue il metodo è uguale a quella specificata come argomento.
boolean	equals(java.lang.Object altra) Restituisce true se e solo la data che esegue il metodo è uguale all'oggetto specificato come argomento.
int	getAnno() Restituisce l'intero che rappresenta l'anno della data che esegue il metodo.
int	getGiorno() Restituisce l'intero che rappresenta il giorno della data che esegue il metodo.
int	getMese() Restituisce l'intero che rappresenta il mese della data che esegue il metodo.
java.lang.String	getNomeGiorno() Restituisce la stringa che rappresenta il giorno corrispondente alla data che esegue il metodo.
java.lang.String	getNomeMese() Restituisce la stringa che rappresenta il mese corrispondente alla data che esegue il metodo.
boolean	isBisestile() Restituisce true se l'anno della data che esegue il metodo è bisestile, false altrimenti.
boolean	isMaggiore(Data altra) Confronta la data che esegue il metodo con quella fornita come argomento e restituisce true se la data che esegue il metodo segue quella fornita come argomento.
boolean	isMinore(Data altra) Confronta la data che esegue il metodo con quella fornita come argomento e restituisce true se la data che esegue il metodo precede quella fornita come argomento.
static Data	parseData(java.lang.String str) Restituisce un oggetto di tipo data che rappresenta la data specificata da una stringa nel formato "gg.mm.aaaa".
int	quantoManca(Data altra) Restituisce il numero di giorni trascorsi dalla data rappresentata dall'oggetto che esegue il metodo a quella rappresentata dall'oggetto fornito tramite il parametro.
java.lang.String	toString() Restituisce la stringa che rappresenta la data che esegue il metodo nel formato "gg.mm.aaaa".

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Data

public Data()

Costruisce una nuova data che rappresenta la data corrente.

Data

public Data(int gg,
            int mm,
            int aaaa)

Costruisce una nuova data a partire dai tre argomenti che rappresentano, nell'ordine, giorno, mese e anno.

Parameters:

gg - il giorno.

Data

public Data(java.lang.String str)

Costruisce una nuova data a partire da una stringa nel formato "gg.mm.aaaa". Se la stringa non ha il formato corretto si verifica un errore in fase di esecuzione.

Method Detail

getNomeGiorno

public java.lang.String getNomeGiorno()

Restituisce la stringa che rappresenta il giorno corrispondente alla data che esegue il metodo.

Returns:

il nome del giorno.

getNomeMese

public java.lang.String getNomeMese()

Restituisce la stringa che rappresenta il mese corrispondente alla data che esegue il metodo.

Returns:

il nome del mese.

getGiorno

public int getGiorno()

Restituisce l'intero che rappresenta il giorno della data che esegue il metodo.

Returns:

il giorno della data che esegue il metodo.

getMese

public int getMese()

Restituisce l'intero che rappresenta il mese della data che esegue il metodo.

Returns:

il mese della data che esegue il metodo.

getAnno

public int getAnno()

Restituisce l'intero che rappresenta l'anno della data che esegue il metodo.

Returns:

l'anno della data che esegue il metodo.

isBisestile

public boolean isBisestile()

Restituisce true se l'anno della data che esegue il metodo è bisestile, false altrimenti.

Returns:

true se l'anno della data che esegue il metodo è bisestile, false altrimenti.

equals

public boolean equals(Data altra)

Restituisce true se e solo la data che esegue il metodo è uguale a quella specificata come argomento.

Returns:

true se la data che esegue il metodo è uguale a quella fornita come argomento.

equals

public boolean equals(java.lang.Object altra)

Restituisce true se e solo la data che esegue il metodo è uguale all'oggetto specificato come argomento.

Overrides:

equals in class java.lang.Object

Returns:

true se la data che esegue il metodo è uguale all'oggetto fornito come argomento.

quantoManca

public int quantoManca(Data altra)

Restituisce il numero di giorni trascorsi dalla data rappresentata dall'oggetto che esegue il metodo a quella rappresentata dall'oggetto fornito tramite il parametro. In particolare, se la data rappresentata dall'oggetto che esegue il metodo precede quella fornita tramite il parametro, il risultato sarà un numero positivo (ad esempio, se le due date sono rispettivamente 31 dicembre 2002 e 1 gennaio 2003, il risultato sarà 1), se invece la segue il risultato sarà un numero negativo (se le due date sono rispettivamente 1 gennaio 2003 e 31 dicembre 2002, il risultato sarà -1).

Parameters:

altra - la data rispetto alla quale calcolare i giorni trascorsi.

Returns:

un intero che rappresenta il numero di giorni trascorsi fra le due date.

toString

public java.lang.String toString()

Restituisce la stringa che rappresenta la data che esegue il metodo nel formato "gg.mm.aaaa".

Overrides:

toString in class java.lang.Object

Returns:

la stringa che rappresenta la data.

isMinore

public boolean isMinore(Data altra)

Confronta la data che esegue il metodo con quella fornita come argomento e restituisce true se la data che esegue il metodo precede quella fornita come argomento.

Returns:

true se la data che esegue il metodo precede quella fornita come argomento.

isMaggiore

public boolean isMaggiore(Data altra)

Confronta la data che esegue il metodo con quella fornita come argomento e restituisce true se la data che esegue il metodo segue quella fornita come argomento.

Returns:

true se la data che esegue il metodo segue quella fornita come argomento.

compareTo

public int compareTo(java.lang.Object o)

Confronta l'oggetto che esegue il metodo con quello specificato come argomento.

Specified by:

compareTo in interface java.lang.Comparable

Parameters:

o - l'oggetto da confrontare con quello che esegue il metodo.

Returns:

restituisce un numero intero minore di zero se la data fornita come argomento segue quella che esegue il metodo, restituisce zero se le due date sono uguali e restituisce un intero maggiore zero se la data che esegue il metodo segue quella specificata come argomento.

parseData

public static Data parseData(java.lang.String str)
                      throws SintassiDataScorretta

Restituisce un oggetto di tipo data che rappresenta la data specificata da una stringa nel formato "gg.mm.aaaa".

Returns:

la data costruita.

Throws:

SintassiDataScorretta - se il formato della stringa non è quello richiesto.