Datumsoperationen
CanParseAsDate()
Diese Funktion prüft, ob ein Textwert als Datumswert interpretiert werden kann.
Rückgabetyp: Bool
Parameter | Datentyp | Beschreibung |
|---|---|---|
1* | Text | zu prüfender Wert |
2 | Text | optionales Muster des Datumsformataufbaus Die Syntax ist analog zur Syntax der Eigenschaft |
Beispiele
CanParseAsDate("2025-12-31") ergibt TRUE.
CanParseAsDate("12/31/2025") ergibt FALSE (bei deutscher Ländereinstellung im Betriebssystem).
CanParseAsDate("12/31/2025", "MM/dd/yyyy") ergibt TRUE (unabhängig von Ländereinstellung).
GetDate()
Diese Funktion generiert einen Datumswert anhand bestimmter Vorgaben. Wenn die Vorgaben leer sind, liefert die Funktion stattdessen das aktuelle Datum zurück.
Rückgabetyp: Date
Parameter | Datentyp | Beschreibung |
|---|---|---|
1 | Number | Jahreszahl des zu erstellenden Datumswertes |
2 | Number | Monatsangabe (1 bis 12) des zu erstellenden Datumswertes |
3 | Number | Tagesangabe (1 bis 31) des zu erstellenden Datumswertes |
Beispiele
GetDate(2025, 12, 31) ergibt 2025-12-31 00:00:00.
GetDate() ergibt das aktuelle Datum mit Uhrzeit.
DateAdd()
Diese Funktion addiert einen Wert zu einem Datum und liefert das modifizierte Datum zurück. Wenn ein negativer Wert angegeben ist, wird dieser Wert von dem Datum subtrahiert.
Rückgabetyp: Date
Parameter | Datentyp | Beschreibung |
|---|---|---|
1* | Date | zu modifizierender Datumswert |
2 | Number | Anzahl der zu addierenden Zeiteinheiten Standardwert: |
3 | Text | Zeiteinheit des zu addierenden Wertes:
|
Beispiele
DateAdd(2025-12-31, 14) ergibt 2026-01-14 00:00:00.
DateAdd(2025-12-31, 2, "Month") ergibt 2026-02-28 00:00:00.
GetDatePart()
Diese Funktion liest einen Teilwert aus einem Datum.
Rückgabetyp: Number
Parameter | Datentyp | Beschreibung |
|---|---|---|
1* | Date | zugrunde liegender Datumswert |
2 | Text | Art des zu lesenden Wertes:
|
Beispiele
GetDatePart(2025-12-31, "Month") ergibt 12.
GetRandomDate()
Liefert einen zufällig generierten Datumswert zurück.
Rückgabetyp: Date
Parameter | Datentyp | Beschreibung |
|---|---|---|
1* | Date | Untergrenze des Wertebereichs Standardwert: |
2 | Text | Obergrenze des Wertebereichs Standardwert: |
Beispiele
GetRandomDate(2025-01-01, 2025-12-31) ergibt einen Datumswert innerhalb des Jahres 2025, z. B. 2025-11-25 00:00:00.
IsDate()
Diese Funktion prüft, ob ein Wert vom Datentyp "Date" ist.
Rückgabetyp: Bool
Parameter | Datentyp | Beschreibung |
|---|---|---|
1* | (variabel) | zu prüfender Wert |
Beispiele
IsDate(2025-12-31) ergibt TRUE.
IsDate("2025-12-31") ergibt FALSE.
ParseAsDate()
Diese Funktion konvertiert einen Textwert in einen Datumswert.
Rückgabetyp: Date
Parameter | Datentyp | Beschreibung |
|---|---|---|
1* | Text | zu konvertierender Wert |
2 | Text | optionales Muster des Datumsformataufbaus Die Syntax ist analog zur Syntax der Eigenschaft |
Beispiele
ParseAsDate("12/31/2025", "MM/dd/yyyy") ergibt 2025-12-31 00:00:00.
ParseAsDate("12/31/2025") ergibt 0001-01-01 00:00:00 ("leeres" Datum, da das Datum bei deutschen Ländereinstellungen im Betriebssystem nicht interpretierbar ist).