4D Doc Center : Date

4D v13.4

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 13 Zeichen und 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.
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.

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 (/) und Leerzeichen.

Date prüft nicht, ob DatumString ein gültiges Datum ist. Übergeben Sie ein ungültiges Datum, z.B. "13.35.97", gibt Date das ungültige Datum zurück. Kann DatumString jedoch nicht als Datum interpretiert werden, z.B. "aa.12.97" , wird ein Nulldatum zurückgegeben (!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.