Klasse Datum

java.lang.Object

gdv.xport.feld.Feld

gdv.xport.feld.NumFeld

gdv.xport.feld.Datum

Alle implementierten Schnittstellen:

Serializable, Cloneable, Comparable<Feld>

public final class Datum
extends NumFeld

The Class Datum.

Seit:

04.10.2009

Version:

$Revision$

Autor:

oliver

Siehe auch:

• Serialisierte Form

Verschachtelte Klassen - Übersicht

Verschachtelte Klassen

Modifikator und Typ	Klasse	Beschreibung
static class	Datum.Validator	Die Validierung von Datum-Felder ist etwas strikter als bei NumFeldern.

Feldübersicht

Von Klasse geerbte Felder Feld

config, inhalt, NULL_FELD

Modifikator und Typ	Feld	Beschreibung
protected final Config	config
protected String	inhalt
static final Feld	NULL_FELD	statt "null".

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
Datum(Bezeichner bezeichner, int start)	Veraltet. durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)
Datum(Bezeichner bezeichner, int length, int start)	Veraltet. durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)
Datum(Bezeichner bezeichner, int length, ByteAdresse start)	Legt ein neues Datum an.
Datum(Bezeichner name, int length, ByteAdresse start, String inhalt)	Legt ein neues Datum an.
Datum(Bezeichner bezeichner, ByteAdresse start)	Erstellt ein neues Datum.
Datum(Datum other)	Dies ist der Copy-Constructor, mit dem man ein bestehendes Datum kopieren kann.
Datum(Feld other)	Dies ist der Copy-Constructor, mit dem man ein bestehendes Feld kopieren kann.
Datum(String name, int start)	Veraltet. durch entsprechenden Constructor mit Bezeichner und ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)
Datum(String name, int length, int start, String inhalt)	Veraltet. durch entsprechenden Constructor mit Bezeichner und ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)
Datum(String name, String inhalt)	Veraltet. durch entsprechenden Constructor mit Bezeichner ersetzt (TODO: wird mit v8 entsorgt)

Methodenübersicht

Modifikator und Typ	Methode	Beschreibung
BigDecimal	add(BigDecimal anzahlTage)	Addiert den Summand auf und liefert das Datum als Zahl zurueck.
Object	clone()	Die clone-Methode hat gegenueber dem CopyConstructor Feld(Feld) den Vorteil, dass es den richtigen Typ fuer die abgeleiteten Klassen zurueckliefert.
String	format()	Diese Methode ist dafuer vorgesehen, das Feld als normalen String ausgeben zu koennen.
String	getFormat()	Liefert das Datumsformat zurueck, so wie es in der GDV-Beschreibung steht.
static Datum	heute()	Heute.
boolean	isEmpty()	Checks if is empty.
boolean	isInvalid()	Checks if is invalid.
boolean	isValid()	Aus Performance-Gruenden verwenden wir hier nicht die validate()-Methode.
Datum	mitConfig(Config c)	Liefert eine neues Datum mit neuer Konfiguration.
void	setInhalt(Datum d)	Sets the inhalt.
void	setInhalt(String neuerInhalt)	Setzt den Inhalt.
void	setInhalt(LocalDate localDate)	Setzt den Inhalt anhand des uebergebenen Datums.
void	setInhalt(Date d)	Setzt den Inhalt anhand des uebergebenen Datums.
Date	toDate()	To date.
LocalDate	toLocalDate()	Wandelt das Datum in ein LocalDate um
List<net.sf.oval.ConstraintViolation>	validate()	Validate.

Von Klasse geerbte Methoden NumFeld

getInhalt, getNachkommastellen, mitNachkommastellen, pack, setInhalt, setInhalt, setInhalt, setInhalt, setInhalt, toBigDecimal, toBigInteger, toDouble, toInt, toLong, truncate

Modifikator und Typ	Methode	Beschreibung
String	getInhalt()	Liefert den Inhalt, so wie er im Record steht (ungetrimm't).
int	getNachkommastellen()	Liefert die Anzahl der Nachkommastellen.
NumFeld	mitNachkommastellen(int n)	Liefert ein neues NumFeld mit der gewuenschten Anzahl von Nachkommastellen zurueck.
protected String	pack(String s)
void	setInhalt(char c)	Setzt den Inhalt mit der uebergebenen Ziffer.
void	setInhalt(double x)	Setzt den Inhalt eines Feldes als Double.
void	setInhalt(long n)	Setzt den Inhalt mit der uebergebenen Zahl unter Beruecksichtigung der Nachkommastellen.
void	setInhalt(BigDecimal n)	Setzt den Inhalt mit der uebergebenen Zahl.
void	setInhalt(BigInteger n)	Setzt den Inhalt mit der uebergebenen Zahl unter Beruecksichtigung der Nachkommastellen.
BigDecimal	toBigDecimal()	Wenn eine Zahl Nachkommastellen hat, sollte sie auch als BigDecimal ausgegeben werden koennen.
BigInteger	toBigInteger()	Fuer grosse Zahlen kann auch schon mal ein BigInteger noetig sein.
double	toDouble()	Wenn eine Zahl Nachkommastellen hat, sollte sie auch als Double ausgegeben werden koennen.
int	toInt()	Wandelt den Inhalt in einen Integer (ohne Beruecksichtigung etwaiger Nachkommastellen).
long	toLong()	Wandelt den Inhalt in einen Long (ohne Beruecksichtigung etwaiger Nachkommastellen).
protected String	truncate(String s)	Schneidet einen zu langen String unabhaengig vom Alignment rechts ab.

Von Klasse geerbte Methoden Feld

compareTo, equals, getAnzahlBytes, getAusrichtung, getBezeichner, getBezeichnung, getByteAdresse, getEndAdresse, getValidator, hashCode, hasValue, overlapsWith, resetInhalt, setAusrichtung, setInhalt, toShortString, toString, validate, withInhalt, write

Modifikator und Typ	Methode	Beschreibung
final int	compareTo(Feld other)	Es gilt fuer Feld a und b: a < b, wenn die Start-Adresse von a vor b liegt.
boolean	equals(Object obj)	Zwei Felder sind gleich, wenn sie die gleiche Adresse und den gleichen Inhalt haben.
final int	getAnzahlBytes()	Gets the anzahl bytes.
Align	getAusrichtung()	Liefert die Ausrichtung eines Feldes.
Bezeichner	getBezeichner()	Liefert den Bezeichner eines Feldes zurueck.
String	getBezeichnung()	Gets the bezeichnung.
final int	getByteAdresse()	Gets the byte adresse.
final int	getEndAdresse()	Gets the end adresse.
Feld.Validator	getValidator()	Hierueber kann der Validator zur Pruefung im Vorfeld geholt werden.
int	hashCode()
final boolean	hasValue()	Dient zum Ermittel, ob ein Wert schon gesetzt wurde.
final boolean	overlapsWith(Feld other)	Ueberprueft, ob sich zwei Felder mit unterschiedlichen Start-Adressen ueberlagern.
final void	resetInhalt()	Reset inhalt.
void	setAusrichtung(Align alignment)	Hiermit kann man die Ausrichtung umstellen.
void	setInhalt(char c, int i)	Sets the inhalt.
String	toShortString()
String	toString()
List<net.sf.oval.ConstraintViolation>	validate(Config validationConfig)	Validiert das Feld mit der angegebenen Konfiguration.
Feld	withInhalt(String inhalt)	Setzt das Feld und liefert es als Ergebnis zurueck.
final void	write(Writer writer)	Write.

Von Klasse geerbte Methoden Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Konstruktordetails

Datum

public Datum(Feld other)

Dies ist der Copy-Constructor, mit dem man ein bestehendes Feld kopieren kann.

Parameter:

other - das originale Feld

Datum

@Deprecated
public Datum(Bezeichner bezeichner,
 int start)

Veraltet.

durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)

Erstellt ein neues Datum.

Parameter:

bezeichner - Bezeichner

start - the start

Seit:

2.0

Datum

public Datum(Bezeichner bezeichner,
 ByteAdresse start)

Erstellt ein neues Datum.

Parameter:

bezeichner - Bezeichner

start - the start

Seit:

7.0 (07-Jan-2024)

Datum

@Deprecated
public Datum(String name,
 int start)

Veraltet.

durch entsprechenden Constructor mit Bezeichner und ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)

Erstellt ein neues Datum.

Parameter:

name - the name

start - the start

Datum

@Deprecated
public Datum(String name,
 String inhalt)

Veraltet.

durch entsprechenden Constructor mit Bezeichner ersetzt (TODO: wird mit v8 entsorgt)

Instantiates a new datum.

Parameter:

name - the name

inhalt - Datum der Form "ddmmjjjj" oder "ddjjjj" oder "dd"

Datum

@Deprecated
public Datum(Bezeichner bezeichner,
 int length,
 int start)

Veraltet.

durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)

Legt ein neues Datum an.

Parameter:

bezeichner - Bezeichner

length - Anzahl Bytes

start - Byte-Adresse

Datum

public Datum(Bezeichner bezeichner,
 int length,
 ByteAdresse start)

Legt ein neues Datum an.

Parameter:

bezeichner - Bezeichner

length - Anzahl Bytes

start - Byte-Adresse

Seit:

7.0 (07-Jan-2024)

Datum

@Deprecated
public Datum(String name,
 int length,
 int start,
 String inhalt)

Veraltet.

durch entsprechenden Constructor mit Bezeichner und ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)

Instantiates a new datum.

Parameter:

name - the name

length - the length

start - the start

inhalt - Datum der Form "ddmmjjjj" oder "ddjjjj" oder "dd"

Datum

public Datum(Bezeichner name,
 int length,
 ByteAdresse start,
 String inhalt)

Legt ein neues Datum an.

Parameter:

name - Bezeichner

length - Laenge

start - Start-Adresse

inhalt - Datum der Form "ddmmjjjj" oder "ddjjjj" oder "dd"

Seit:

7.0 (07-Jan-2024)

Datum

public Datum(Datum other)

Dies ist der Copy-Constructor, mit dem man ein bestehendes Datum kopieren kann.

Parameter:

other - das originale Feld

Methodendetails

mitConfig

public Datum mitConfig(Config c)

Liefert eine neues Datum mit neuer Konfiguration.

Setzt außer Kraft:

mitConfig in Klasse NumFeld

Parameter:

c - neue Konfiguration

Gibt zurück:

neues Datzm

Seit:

6.1

setInhalt

public void setInhalt(Datum d)

Sets the inhalt.

Parameter:

d - the new inhalt

setInhalt

public void setInhalt(Date d)

Setzt den Inhalt anhand des uebergebenen Datums.

Parameter:

d - neues Datum

setInhalt

public void setInhalt(String neuerInhalt)

Beschreibung aus Klasse kopiert: Feld

Setzt den Inhalt. Hierueber kann auch ein Inhalt gesetzt werden, der nicht zum Datentyp passt (z.B. Buchstaben in einem NumFeld, damit ein Import nicht beim ersten fehlerhaften Feld abbricht.

Um festzustellen, ob ein Feld einen gueltigen Wert hat, kann die Feld.isValid()-Methode verwendet werden.

Setzt außer Kraft:

setInhalt in Klasse Feld

Parameter:

neuerInhalt - der neue Inhalt

setInhalt

public void setInhalt(LocalDate localDate)

Setzt den Inhalt anhand des uebergebenen Datums.

Parameter:

localDate - neues Datum

Seit:

5.0

add

public BigDecimal add(BigDecimal anzahlTage)

Addiert den Summand auf und liefert das Datum als Zahl zurueck.

Setzt außer Kraft:

add in Klasse NumFeld

Parameter:

anzahlTage - Anzahl Tage

Gibt zurück:

Summe

Seit:

5.0

toDate

public Date toDate()

To date.

Gibt zurück:

the date

toLocalDate

public LocalDate toLocalDate()

Wandelt das Datum in ein LocalDate um

Gibt zurück:

Datum als LocalDate

Seit:

5.0

heute

public static Datum heute()

Heute.

Gibt zurück:

the datum

isEmpty

public boolean isEmpty()

Beschreibung aus Klasse kopiert: Feld

Checks if is empty.

Setzt außer Kraft:

isEmpty in Klasse Feld

Gibt zurück:

true, if is empty

isValid

public boolean isValid()

Aus Performance-Gruenden verwenden wir hier nicht die validate()-Methode.

Setzt außer Kraft:

isValid in Klasse Feld

Gibt zurück:

true/false

Siehe auch:

• Feld.isValid()

isInvalid

public boolean isInvalid()

Beschreibung aus Klasse kopiert: Feld

Checks if is invalid.

Setzt außer Kraft:

isInvalid in Klasse Feld

Gibt zurück:

true, if is invalid

validate

public List<net.sf.oval.ConstraintViolation> validate()

Beschreibung aus Klasse kopiert: Feld

Validate.

Setzt außer Kraft:

validate in Klasse Feld

Gibt zurück:

eine Liste mit Constraint-Verletzungen

format

public String format()

Beschreibung aus Klasse kopiert: Feld

Diese Methode ist dafuer vorgesehen, das Feld als normalen String ausgeben zu koennen. Zahlen koennen so z.B. in der Form "123,45" ausgegeben werden, unter Beruecksichtigung der eingestellten "Locale".

Setzt außer Kraft:

format in Klasse NumFeld

Gibt zurück:

Inhalt des Feldes

getFormat

public String getFormat()

Liefert das Datumsformat zurueck, so wie es in der GDV-Beschreibung steht.

Gibt zurück:

z.B. "TTMMJJJJ"

Seit:

6.2

clone

public Object clone()

Beschreibung aus Klasse kopiert: Feld

Die clone-Methode hat gegenueber dem CopyConstructor Feld(Feld) den Vorteil, dass es den richtigen Typ fuer die abgeleiteten Klassen zurueckliefert.

Setzt außer Kraft:

clone in Klasse NumFeld

Gibt zurück:

eine Kopie