Methoden und Eigenschaften von Datumswerten

Um Quellfelder als Datumswert zu interpretieren muss der Datentyp "DateTime" verwendet werden. Wie die Zeichenketten-Eigenschaft "Length" besitzen auch DateTime-Werte eine Vielzahl von Eigenschaften, über die die einzelnen Bestandteile eines Zeitstempels (Jahr, Monat, Tag, Stunde, Minute, Sekunde) angesprochen werden können. Die folgende Tabelle gibt eine Übersicht, wobei davon ausgegangen wird, dass in den Quelldaten eine Spalte namens "Datum" existiert, in denen Werte der Form "DD.MM.YYYY HH:MM:SS" stehen:

Die folgende Tabelle enthält Beispiele für Methoden und Eigenschaften von Datumswerten.

Zu ermittelnder Ausdruck	C# - Syntax
Das Jahr des Datum-Quellfeldes	((DateTime)Datum).Year
Der Monat des Datum-Quellfeldes	((DateTime)Datum).Month
Der Tag des Datum-Quellfeldes	((DateTime)Datum).Day
Die Stunde des Datum-Quellfeldes	((DateTime)Datum).Hour
Die Minute des Datum-Quellfeldes	((DateTime)Datum).Minute
Die Sekunde des Datum-Quellfeldes	((DateTime)Datum).Second
Das Datum ohne Zeitangabe des Datum-Quellfeldes	((DateTime)Datum).Date
Wenn das Datum-Quellfeld einen Wert aus dem Jahr 2017 oder später angibt	((DateTime)Datum).Year >= 2017
Das heutige Datum ("heute" bezieht sich auf den Zeitpunkt der Durchführung des Imports)	DateTime.Today
Der jetzige Zeitpunkt ("jetzt" bezieht sich auf den Zeitpunkt der Durchführung des Imports)	DateTime.Now
Wenn das Datum-Quellfeld einen Wert hat, der innerhalb der letzten 30 Tage liegt (bezogen auf den Zeitpunkt der Durchführung des Imports)	((DateTime)Datum).Date >= DateTime.Today.AddDays(-30)
Wenn das Datum-Quellfeld einen Wert hat, der innerhalb der letzten 6 Monate liegt (bezogen auf den Zeitpunkt der Durchführung des Imports)	((DateTime)Datum).Date >= DateTime.Today.AddMonths(-6)
Wenn das Datum-Quellfeld einen Wert hat, der innerhalb der letzten 5 Jahre liegt (bezogen auf den Zeitpunkt der Durchführung des Imports)	((DateTime)Datum).Date >= DateTime.Today.AddYears(-5)
Wenn das Datum-Quellfeld einen Wert enthält, dessen Datum dem 23.06.2017 entspricht	((DateTime)Datum).Date == new DateTime(2017, 6, 23).Date ODER ((DateTime)Datum).Date == DateTime.Parse("12.06.2017").Date
Der Wert des Datum-Quellfeldes als Zeichenkette	Datum.ToString()
Wenn das Datum-Quellfeld einen Wert hat, der gemäß dem Datumsformat-Parameter der Importkonfiguration ein gültiges Datum ist	Datum is DateTime
Wenn das Datum-Quellfeld einen Wert hat, der gemäß dem Datumsformat-Parameter der Importkonfiguration kein gültiges Datum ist	!(Datum is DateTime)

Erläuterungen zu den Methoden und Eigenschaften

•DateTime.Today: Gibt den aktuellen Tag als Datumswert zur Uhrzeit 00:00:00 an.

•AddDays(x): Geht vom zugehörigen Datumswert aus x Tage weiter (bzw. zurück, wenn x negativ ist).

•AddMonths(x): Geht vom zugehörigen Datumswert aus x Monate weiter (bzw. zurück, wenn x negativ ist).

•AddYears(x): Geht vom zugehörigen Datumswert aus x Jahre weiter (bzw. zurück, wenn x negativ ist).

•new DateTime(jahr, monat, tag , stunde, minute, sekunde): Erstellt ein Datum mit dem angegebenen Jahr, Monat und Tag (zu beachten ist hier zwingend die Reihenfolge der Parameter und dass auf führende 0en verzichtet wird) um 00:00:00 Uhr oder optional mit einer zusätzlichen Zeitangabe (welche in diesem Fall vollständig anzugeben ist).

oDas so erstellte Datum kann für Vergleiche oder Wertzuweisungen verwendet werden.

•DateTime.Parse("x"): Wandelt die Zeichenkette "x" in ein Datum um. Das Format der umzuwandelnden Datums-Zeichenkette muss dabei dem der aktuellen Inhaltssprache entsprechen und ist unabhängig vom Datumsformat, das als Formatparameter zum Einlesen der Quelldatensätze angegeben wird.

oDas so erstellte Datum kann für Vergleiche oder Wertzuweisungen verwendet werden.

•ToString(): Wandelt den Wert in eine Zeichenkette um. Diese Umwandlung ist zwingend erforderlich, wenn ein Datumswert als (Teil-)Ergebnis einem DELECO-Feld vom Typ Text zugewiesen werden soll.

•x is DateTime: Ermittelt, ob der Wert x ein DateTime-Objekt ist. Dies ist nur dann der Fall, wenn der Wert des zugehörigen Quellfeldes nach dem in der Importkonfiguration festgelegten Datumsformat-Parameter formatiert ist.

•!(x is DateTime): Ermittelt, ob der Wert x kein DateTime-Objekt ist. Dies ist immer dann der Fall, wenn der Wert des zugehörigen Quellfeldes nicht nach dem in der Importkonfiguration festgelegtem Datumsformat-Parameter formatiert ist. Die Klammern um den gesamten Ausdruck sind zwingend erforderlich.