Data (prog4ed)

java.lang.Object
- prog.utili.Data

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<Data>
```
public class Data
extends java.lang.Object
implements java.lang.Comparable<Data>, java.io.Serializable
```
Le sue istanze rappresentano date del calendario.

Version:

4.0

Author:

Mauro Ferrari, Giovanni Pighizzini

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description
`Data()` Costruisce un nuovo oggetto che rappresenta la data corrente, cioè la data relativa all'istante in cui viene invocato.
`Data(int g, int m, int a)` 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

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`compareTo(Data d)` Confronta la data che esegue il metodo con quella specificata 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 altro)` Restituisce `true` se e solo l'oggetto specificato come argomento è una data e coincide con quella che esegue il metodo.
`int`	`getAnno()` Restituisce l'intero che rappresenta l'anno della data che esegue il metodo.
`static FormatoData`	`getFormato()` Restituisce la costante enumerativa di `FormatoData` che descrive il formato utilizzato per la costruzione della stringa che rappresenta la data.
`int`	`getGiorno()` Restituisce l'intero che rappresenta il giorno della data che esegue il metodo.
`GiornoDellaSettimana`	`getGiornoDellaSettimana()` Restituisce il valore del tipo enumerativo `GiornoDellaSettimana` che rappresenta il giorno della settimana corrispondente alla data che esegue il metodo.
`int`	`getMese()` Restituisce l'intero che rappresenta il mese della data che esegue il metodo.
`MeseDellAnno`	`getMeseDellAnno()` Restituisce il valore del tipo enumerativo `MeseDellAnno` che rappresenta il mese dell'anno corrispondente alla data che esegue il metodo.
`static char`	`getSeparatore()` Restituisce il separatore utilzzato per separare giorno, mese ed anno nella stringa che rappresenta la data.
`int`	`hashCode()`
`boolean`	`isInAnnoBisestile()` 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 temporalmente 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 temporalmente 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 l'argomento.
`static void`	`setFormato(FormatoData f)` Definisce il formato utilizzato per la costruzione della stringa che rappresenta la data.
`static void`	`setSeparatore(char c)` Definisce il separatore utilizzato per separare giorno mese ed anno nella stringa che rappresenta la data.
`java.lang.String`	`toString()` Restituisce la stringa che rappresenta la data che esegue il metodo.

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Data
```
public Data()
```
    Costruisce un nuovo oggetto che rappresenta la data corrente, cioè la data relativa all'istante in cui viene invocato.
  - Data
```
public Data(int g,
            int m,
            int a)
```
    Costruisce una nuova data a partire dai tre argomenti che rappresentano, nell'ordine, giorno, mese e anno.
    
    Parameters:
    
    g - il giorno.
    
    m - il mese.
    
    a - l'anno.
  - 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.
    
    Parameters:
    
    str - la stringa che specifica la data.
- Method Detail
  - compareTo
```
public int compareTo(Data d)
```
    Confronta la data che esegue il metodo con quella specificata come argomento.
    
    Specified by:
    
    compareTo in interface java.lang.Comparable<Data>
    
    Parameters:
    
    d - la data da confrontare con quella che esegue il metodo.
    
    Returns:
    
    restituisce un numero intero minore di zero se la data che esegue il metodo precede temporalmente quella fornita come argomento, restituisce zero se le due date sono uguali e restituisce un intero maggiore zero se la data che esegue il metodo segue temporalmente quella specificata come argomento.
  - equals
```
public boolean equals(Data altra)
```
    Restituisce true se e solo la data che esegue il metodo è uguale a quella specificata come argomento.
    
    Parameters:
    
    altra - la data da confrontare con quella che esegue il metodo.
    
    Returns:
    
    true se la data che esegue il metodo è uguale a quella fornita come argomento.
  - equals
```
public boolean equals(java.lang.Object altro)
```
    Restituisce true se e solo l'oggetto specificato come argomento è una data e coincide con quella che esegue il metodo.
    
    Overrides:
    
    equals in class java.lang.Object
    
    Parameters:
    
    altro - l'oggetto da confrontare con la data che esegue il metodo.
    
    Returns:
    
    true se la data che esegue il metodo è uguale a quella specificata dall'oggetto fornito come argomento.
  - 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.
  - 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.
  - getGiornoDellaSettimana
```
public GiornoDellaSettimana getGiornoDellaSettimana()
```
    Restituisce il valore del tipo enumerativo GiornoDellaSettimana che rappresenta il giorno della settimana corrispondente alla data che esegue il metodo.
    
    Returns:
    
    il giorno dela settimana corrispondente alla 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.
  - getMeseDellAnno
```
public MeseDellAnno getMeseDellAnno()
```
    Restituisce il valore del tipo enumerativo MeseDellAnno che rappresenta il mese dell'anno corrispondente alla data che esegue il metodo.
    
    Returns:
    
    il mese dell'anno corrispondente alla data che esegue il metodo.
  - isInAnnoBisestile
```
public boolean isInAnnoBisestile()
```
    Restituisce true se l'anno della data che esegue il metodo è bisestile, false altrimenti.
    
    Returns:
    
    true se l'anno a cui appartiene la data che esegue il metodo è bisestile, false altrimenti.
  - 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 temporalmente quella fornita come argomento.
    
    Parameters:
    
    altra - la data da confrontare con quella che esegue il metodo.
    
    Returns:
    
    true se la data che esegue il metodo segue quella fornita come argomento.
  - 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 temporalmente quella fornita come argomento.
    
    Parameters:
    
    altra - la data da confrontare con quella che esegue il metodo.
    
    Returns:
    
    true se la data che esegue il metodo precede quella fornita 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 l'argomento. In particolare, se la data rappresentata dall'oggetto che esegue il metodo precede quella fornita tramite l'argomento, 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. Il formato è stabilito tramite il metodo setFormato(prog.utili.FormatoData).
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    la stringa che rappresenta la data.
  - getFormato
```
public static FormatoData getFormato()
```
    Restituisce la costante enumerativa di FormatoData che descrive il formato utilizzato per la costruzione della stringa che rappresenta la data.
    
    Returns:
    
    il formato.
  - getSeparatore
```
public static char getSeparatore()
```
    Restituisce il separatore utilzzato per separare giorno, mese ed anno nella stringa che rappresenta la data.
    
    Returns:
    
    il separatore.
  - 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".
    
    Parameters:
    
    str - la stringa a partire dalla quale costruire la data.
    
    Returns:
    
    la data costruita.
    
    Throws:
    
    SintassiDataScorretta - se il formato della stringa non ï¿½ quello richiesto.
  - setFormato
```
public static void setFormato(FormatoData f)
```
    Definisce il formato utilizzato per la costruzione della stringa che rappresenta la data. I valori possibili dell'argomento sono le costanti del tipo enumerativo FormatoData.
    
    Parameters:
    
    f - il formato.
  - setSeparatore
```
public static void setSeparatore(char c)
```
    Definisce il separatore utilizzato per separare giorno mese ed anno nella stringa che rappresenta la data. Di default il separatore è il punto ('.').
    
    Parameters:
    
    c - il nuovo separatore.
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object

Class Data

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Data

Data

Data

Method Detail

compareTo

equals

equals

getAnno

getGiorno

getGiornoDellaSettimana

getMese

getMeseDellAnno

isInAnnoBisestile

isMaggiore

isMinore

quantoManca

toString

getFormato

getSeparatore

parseData

setFormato

setSeparatore

hashCode