fr.lifl.genca.negotiation
Class MyDate

java.lang.Object
  fr.lifl.genca.negotiation.MyDate

All Implemented Interfaces:

java.io.Serializable

public class MyDate

extends java.lang.Object

implements java.io.Serializable

Cette classe a pour objectif de redéfinir proprement la classe GregorianCalendar qui est d'un usage difficile et pas très cohérent. En effet, entre-autres anomalies, on peut remarquer que dans GregorianCalendar :

• getTime() fournit la Date courante.
• Il n'y a pas de toString(). Il faut utiliser SimpleDateFormat de l'API java.text pour afficher la date
• Il n'y a pas de méthode compareTo() pour comparer deux dates mais des méthodes before() et after().
• Le premier mois de l'année est 0.

Tout ces défauts sont corrigés et rendus transparents dans cette classe qui utilise des noms de méthodes habituels.

See Also:

Serialized Form

Field Summary

static java.lang.String	DATE constante permettant l'affichage sous la forme jj/mm/aaaa
static java.lang.String	DATECLAIR constante permettant l'affichage de la date en clair
static java.lang.String	TIME constante permettant l'affichage hh:mm:ss
static java.lang.String	TIMESTAMP constante permettant l'affichage jj/mm/aaaa hh:mm

Constructor Summary

MyDate(int j, int m, int a)
Constructeur à qui l'on passe trois entiers jour,mois,année dans l'ordre.

MyDate(int j, int m, int a, int h, int mi)
Constructeur à qui l'on passe cinq entiers jour,mois,année, heure, minute dans l'ordre.

Method Summary

void	addDays(int j) Permet d'ajouter un certain nombre de jours à l'objet courant.
void	addHours(int h) Permet d'ajouter un certain nombre d'heures à l'objet courant.
void	addMinutes(int m) Permet d'ajouter un certain nombre de minutes à l'objet courant.
java.lang.Object	clone()
int	compareTo(MyDate d) Compare la date courante avec la date passée en paramètre.
static MyDate	getCurrentDate() Renvoie la date courante.
java.lang.String	getString(java.lang.String s) Renvoie la chaine de caractères représentant la partie sprécifiée de l'objet courant.
long	getTimeInMillis()
boolean	included(MyDate dmin, MyDate dmax) Vérifie si la date courante est comprise entre les deux dates passées en paramètre.
java.lang.String	toString() Affiche l'objet courant sous la forme timeStamp.

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

DATE

public static final java.lang.String DATE

constante permettant l'affichage sous la forme jj/mm/aaaa

See Also:

Constant Field Values

DATECLAIR

public static final java.lang.String DATECLAIR

constante permettant l'affichage de la date en clair

See Also:

Constant Field Values

TIME

public static final java.lang.String TIME

constante permettant l'affichage hh:mm:ss

See Also:

Constant Field Values

TIMESTAMP

public static final java.lang.String TIMESTAMP

constante permettant l'affichage jj/mm/aaaa hh:mm

See Also:

Constant Field Values

Constructor Detail

MyDate

public MyDate(int j,
              int m,
              int a)

Constructeur à qui l'on passe trois entiers jour,mois,année dans l'ordre. Le premier jour du mois est noté 1 et le premier mois de l'année est noté 1 aussi.

Parameters:

j - le jour de la nouvelle date à créer

m - le mois de la nouvelle date à créer

a - l'année de la nouvelle date à créer

MyDate

public MyDate(int j,
              int m,
              int a,
              int h,
              int mi)

Constructeur à qui l'on passe cinq entiers jour,mois,année, heure, minute dans l'ordre. Le premier jour du mois est noté 1 et le premier mois de l'année est noté 1 aussi.

Parameters:

j - le jour de la nouvelle date à créer

m - le mois de la nouvelle date à créer

a - l'année de la nouvelle date à créer

h - l'heure de la nouvelle date à créer

mi - la minute de la nouvelle date à créer

Method Detail

getCurrentDate

public static MyDate getCurrentDate()

Renvoie la date courante.

Returns:

un nouvel objet MyDate correspondant au moment de l'exécution de cette méthode.

getString

public java.lang.String getString(java.lang.String s)

Renvoie la chaine de caractères représentant la partie sprécifiée de l'objet courant. utilisez de préférence les constantes DATE, TIME ou TIMESTAMP

Returns:

la chaine de caractères représentant l'objet courant dans le format demandé.

toString

public java.lang.String toString()

Affiche l'objet courant sous la forme timeStamp. Cette methode équivalente à getString() avec l'argument static TIMESTAMP

Returns:

la chaine jj/mm/aa hh:mm:ss

compareTo

public int compareTo(MyDate d)

Compare la date courante avec la date passée en paramètre.

Returns:

un entier correspondant à :

• -1 si la date courante est inférieure à la date passée en paramètre
• 0 si les deux dates sont égales
• +1 si la date courante est supérieure à la date passée en paramètre.

included

public boolean included(MyDate dmin,
                        MyDate dmax)

Vérifie si la date courante est comprise entre les deux dates passées en paramètre. Les bornes ne sont pas comprises.

Parameters:

dmin - - la date minimum de l'intervalle

dmax - - la date maximum de l'intervalle

Returns:

un booleen correspondant à :

• true si la date courante est comprise entre les deux dates passées en paramètre.
• false dans le cas contraire.

addMinutes

public void addMinutes(int m)

Permet d'ajouter un certain nombre de minutes à l'objet courant. Le nombre de minutes est un entier signé. On peut donc ajouter aussi bien qu'enlever des minutes.

Parameters:

m - le nombre de minutes (signé) à ajouter.

addHours

public void addHours(int h)

Permet d'ajouter un certain nombre d'heures à l'objet courant. Le nombre d'heures est un entier signé. On peut donc ajouter aussi bien qu'enlever des heures.

Parameters:

h - le nombre d'heures (signé) à ajouter.

addDays

public void addDays(int j)

Permet d'ajouter un certain nombre de jours à l'objet courant. Le nombre de jours est un entier signé. On peut donc ajouter aussi bien qu'enlever des jourss.

Parameters:

j - le nombre de jours (signé) à ajouter.

getTimeInMillis

public long getTimeInMillis()

clone

public java.lang.Object clone()