4D Doc Center : Date

Home

4D v14.3

Date


Date ( DatumString ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
DatumString	String	String, der das zurückzugebende Datum angibt
Funktionsergebnis	Datum	Datum

Beschreibung

Die Funktion Date bewertet DatumString und gibt ein Datum zurück.

Der Parameter DatumString muss entweder das ISO Datumsformat oder die regionalen Einstellungen, die im Betriebssystem definiert sind, befolgen.

ISO Datumsformat
Der String muss folgende Formatierung haben: JJJJ-MM-DDTHH:MM:SS", zum Beispiel "2013-11-20T10:20:00". In diesem Fall bewertet Date den Parameter DatumString korrekt, unabhängig von den aktuellen Spracheinstellungen. Es lassen sich auch dezimale Sekunden (Werte kleiner als 1 Sekunde) mit vorangestelltem Punkt hinzufügen, z.B.: "2013-11-20T10:20:00.9854".
Passt das Format DatumString nicht exakt in dieses ISO Schema, wird das Datum als abgekürztes Datumsformat bewertet, das sich nach den regionalen Einstellungen des Systems richtet.

Hinweis: Ab 4D v14 wird empfohlen, das Format "YYYY-MM-DDTHH:MM:SSZ" zu verwenden, da es dem ISO Standard entspricht und die Darstellung der Zeitzone ermöglicht

Regionale Einstellungen
Passt das Format DatumString nicht zum ISO Format, werden zur Bewertung die regionalen Einstellungen verwendet, die im Betriebssystem als abgekürztes Format definiert sind. In der deutschen Version von 4D muss das Datum standardmäßig die Reihenfolge TT.MM.JJ (Tag, Monat, Jahr) haben. Monat und Tag können eine oder zwei Stellen haben, das Jahr kann zwei- oder vierstellig sein. Ist das Jahr zweistellig, bewertet Date je nach dem eingetragenen Wert, ob das Datum zum 21. oder 20. Jahrhundert gehört. Dabei gilt 30 standardmäßig als Schlüsselwert.

Einen Wert größer als oder gleich 30 wertet 4D als 20. Jahrhundert und fügt vor dem Wert 19 hinzu.
Einen Wert kleiner als 30 wertet 4D als 21. Jahrhundert und fügt vor dem Wert 20 hinzu.

Diese Standardeinstellung können Sie mit dem Befehl SET DEFAULT CENTURY verändern. Folgende Zeichen gelten als Trennung im Datum: Punkt (.), Komma (,), Schrägstrich (/) Bindestrich (-) und Leerzeichen.

Übergeben Sie in DatumString ein ungültiges Datum, z.B. "13.35.97" oder "aa.12.97", gibt Date ein Nulldatum zurück (!00.00.00!). Sie müssen selbst prüfen, dass DatumString ein gültiges Datum enthält.

Beispiel 1

Folgendes Beispiel fordert den Benutzer auf, ein Datum einzugeben. Die eingegebene Zeichenkette wird in ein Datum konvertiert und in der Variablen reqDate gespeichert:

 vdRequestedDate:=Date(Request("Gib das Datum ein:";String(Current date)))

 If(OK=1)

  ` Mach etwas mit dem in vdRequestedDate gespeicherten Datum

 End if

Beispiel 2

Folgendes Beispiel gibt die Zeichenkette "12.12.97" als Datum zurück:

vdDate:=Date("12.12.97")

Beispiel 3

Das Datum wird nach einem Datum im ISO Format bewertet:

 $vtDateISO:="2013-06-05T20:00:00"

 $vDate:=Date($vtDateISO)

  //$vDate stellt 6. Juni 2013 dar, unabhängig von der Sprache des Systems.