eva/3 Application BuilderEntwicklung von eva/3 AnwendungenArbeiten mit AusdrückenFunktionen 

Datums-/ Zeitfunktionen

Die Datumsfunktionen gestatten den Umgang und die Berechnung von Datumswerten.

Datumsfunktionen Syntax
NOW
-
JETZT
Die Jetzt-Funktion gibt das aktuelle Datum und die aktuelle Zeit zurück. Die Ausgabe erfolgt lokalisiert und ist abhängig von den Ländereinstellungen des Betriebssystems.

Beispiel: =NOW() Ergebnis: 12.07.06 16:01:22
NOW()
DATE
-
DATUM
Die Datum-Funktion gibt das aktuelle Datum zurück. Die Ausgabe erfolgt lokalisiert und ist abhängig von den Ländereinstellungen des Betriebssystems.

Beispiel: =DATE() Ergebnis: 12.07.06
DATE()
YEAR
-
JAHR
Die Jahresfunktion gibt das Jahr des Datums zurück.

Beispiel: =YEAR(#27.03.2006#) Ergebnis: =2006
YEAR(date Datum)

Datum: Das Datum aus dem das Jahr zurückgegeben werden soll.
MONTH
-
MONAT
Die Monatsfunktion gibt den Monat des Jahres zurück.

Beispiel: =MONTH(#27.03.2006#) Ergebnis: =3
MONTH(date Datum)

Datum: Das Datum aus dem der Monat zurückgegeben werden soll.
DAY
-
TAG
Die Tagesfunktion gibt den Tag des Monats zurück.

Beispiel: =DAY(#27.03.2006#) Ergebnis: =27
DAY(date Datum)

Datum: Das Datum aus dem der Tag zurückgegeben werden soll.
DATEADD
-
DATADD
Die Datumaddierenfunktion addiert auf ein Datum einen übergebenen Wert.

Beispiel: =DATEADD("m"; 9; #27.03.2006#) Ergebnis: =27.12.2006
DATEADD(literal Interval; number Wert; date Datum)

Interval: Der Teil des Datums, der geändert werden soll.
Parameter können sein:
  • "yyyy" für Jahr
  • "m" für Monat
  • "q" für Quartal
  • "ww" für Woche des Jahres
  • "w" für Wochentag
  • "d" für Tag
  • "y" für Tag des Jahres
  • "h" für Stunde
  • "n" für Minute
  • "s" für Sekunde
"d", "w" und "y" sind in diesem Fall das Gleiche

Wert: Der Wert, der zu dem Datum dazuaddiert werden soll.

Datum: Das Datum, das geändert werden soll.
DATEDIFF
-
DATDIFF
Die Datumsdifferenzfunktion berechnet die verstrichene Zeit zwischen zwei Datumsangaben.

Beispiel: =DATEDIFF("yyyy"; #27.03.2006#; #27.03.2007#) Ergebnis: =1
DATEDIFF(literal Interval; date Datum1; date Datum2;
[number ErsterTagderWoche] ;[number ErsteWochedesJahres])


Interval: Der Teil des Datums, dessen Differenz berechnet werden soll.
Parameter können sein:
  • "yyyy" für Jahr
  • "m" für Monat
  • "q" für Quartal
  • "ww" für Woche
  • "w" für volle Woche
  • "d" für Tag
  • "y" für Tag des Jahres
  • "h" für Stunde
  • "n" für Minute
  • "s" für Sekunde
"d" und "y" sind in dem Fall das Gleiche
"w" rechnet die vollen Wochen aus(also in 7 Tagen Intervallen),
"ww" die Anzahl der Wochen ausgehend vom ersten Tag der Woche

Datum1: Das Anfangsdatum

Datum2: Das Enddatum

ErsterTagderWoche: Gibt an, mit welchem Tag die Woche beginnen soll
Die Parameter können sein:
  • 1=Sonntag
  • 2=Montag
  • 3=Dienstag
  • 4=Mittwoch
  • 5=Donnerstag
  • 6=Freitag
  • 7=Samstag

  • Defaultwert ist 2 (gem ISO 8601)

ErsteWochedesJahres: Gibt an, welche die erste Woche des Jahres sein soll
Parameter können sein:
  • 1=die erste Woche
    ist die Woche mit dem 1.Januar
  • 2=die erste Woche
    ist die erste Woche mit 4 Tagen im neuen Jahr
  • 3= die erste Woche
    ist die erste volle Woche im Jahr (7 Tage)

  • Defaultwert ist 1
DATEPART
-
DATTEIL
Die Datumsteilfunktion liefert einen bestimmten Teil eines übergebenen Datums.

Beispiel: =DATEPART("d"; #27.03.2006#) Ergebnis: =27
DATEPART(literal Interval; date Datum;
[number ErsterTagderWoche] ;[number ErsteWochedesJahres])


Interval: Der Teil des Datums, der zurückgegeben werden soll
Parameter können sein:
  • "yyyy" für Jahr
  • "m" für Monat
  • "q" für Quartal
  • "ww" für Woche des Jahres
  • "w" für Wochentag
  • "d" für Tag
  • "y" für Tag des Jahres
  • "h" für Stunde
  • "n" für Minute
  • "s" für Sekunde

"ww" gibt die Nummer der Woche und ist abhängig von dem eingestellten ersten Tag der Woche
und von der ersten Woche des Jahres
"w" ist ebenfalls abhängig vom ersten Tag der Woche, da von diesem Tag an gezählt wird

Datum: Das Datum, von dessen ein Teil zurückgegeben wird

ErsterTagderWoche: Gibt an, mit welchem Tag die Woche beginnen soll
Die Parameter können sein:
  • 1=Sonntag
  • 2=Montag
  • 3=Dienstag
  • 4=Mittwoch
  • 5=Donnerstag
  • 6=Freitag
  • 7=Samstag

  • Defaultwert ist 2 (gem ISO 8601)

ErsteWochedesJahres: Gibt an, welche die erste Woche des Jahres sein soll
Parameter können sein:
  • 1=die erste Woche
    ist die Woche mit dem 1.Januar
  • 2=die erste Woche
    ist die erste Woche mit 4 Tagen im neuen Jahr
  • 3=die erste Woche
    ist die erste volle Woche im Jahr (7 Tage)

  • Defaultwert = 1
DATESERIAL
-
DATSERIELL
Die Datumseriellfunktion gibt ein Datum zu angegebenen Jahres-,Monats- und Tageswerten zurück.

Beispiel: =DATESERIAL(2006; 03; 27) Ergebnis: =27.03.2006
DATESERIAL(number Jahr; number Monat; number Tag)

Jahr: Das Jahr des neuen Datums

Monat: Der Monat des neuen Datums

Tag: Der Tag des neuen Datums
WEEKDAY
-
WOCHENTAG
Die Wochentagfunktion gibt die Nummer des übergebenen Tages in der Woche zurück.

Beispiel: =WEEKDAY(#27.03.2006#;1) Ergebnis: =2 Erklärung: Da der Tag ein Montag ist und
als Wochenbeginn Sonntag eingegeben wurde, ist der Tag der 2. der Woche.
WEEKDAY(date Datum ;[number ErsterTagderWoche])

Datum: Das Datum, in dem der Tag enthalten ist.

ErsterTagderWoche: Gibt an, mit welchem Tag die Woche beginnen soll.
Die Parameter können sein:
  • 1=Sonntag
  • 2=Montag
  • 3=Dienstag
  • 4=Mittwoch
  • 5=Donnerstag
  • 6=Freitag
  • 7=Samstag

  • Defaultwert ist 2 (gem ISO 8601)
WEEKDAYNAME
-
WOCHENTAGNAME
Die Wochentagnamefunktion gibt den Namen des übergebenen Tages zurück.
Der Rückgabewert ist dabei lokalisiert, d.h. wenn in der Systemsteuerung deutsch
eingestellt ist, bekommt man z.B. "Sonntag", bei englisch "Sunday" u.s.w

Beispiel: =WEEKDAYNAME(3;true;6) Ergebnis: =Sun Erklärung: Da als Wochenbeginn Freitag eingegeben wurde
und der 3. Tag ausgegeben werden soll, ist das der Sonntag.
Aufgrund des "true", dass als Parameter Abkürzung übergeben wurde,
ist der Rückgabewert nur Sun.
WEEKDAYNAME(number Wochentag ;[boolean Abkürzung] ;[number ErsterTagderWoche])

Wochentag: Die Nummer des Tages von dem man den Namen wissen will.

Abkürzung: Gibt an ob der Tag als Abkürzung zurückgegeben werden soll.
Parameter: true für Abkürzung, false für vollen Namen
Defaultwert ist false

ErsterTagderWoche: Gibt an, mit welchem Tag die Woche beginnen soll.
Die Parameter können sein:
  • 1=Sonntag
  • 2=Montag
  • 3=Dienstag
  • 4=Mittwoch
  • 5=Donnerstag
  • 6=Freitag
  • 7=Samstag

  • Defaultwert ist 2 (gem ISO 8601)
MONTHNAME
-
MONATNAME
Die Monatnamefunktion gibt den Namen des übergebenen Monats zurück.
Der Rückgabewert ist dabei lokalisiert, d.h. wenn in der Systemsteuerung deutsch
eingestellt ist, bekommt man z.B. "Januar", bei englisch "January" u.s.w

Beispiel: =MONTHNAME(3;false) Ergebnis: =März Erklärung: Der dritte Monat ist der März
und da Abkürzung "false" ist, ist der Rückgabewert der ganze Name des Monats.
MONTHNAME(number Monat ;[boolean Abkürzung])

Monat: Die Nummer des Monats von dem man den Namen wissen will.

Abkürzung: Gibt an, ob der Tag als Abkürzung zurückgegeben werden soll.
Parameter: true für Abkürzung, false für vollen Namen
Defaultwert ist false
CALENDARWEEK Berechnet die Kalendarwoche für ein vorgegebenes Datum.
Beispiel: =calendarWeek(#4.1.2008#) Ergebnis: 1 Erklärung: Ermittelt die Kalendarwoche für den 4.1.2008, der gem. ISO 8601 immer in die erste Kalendarwoche fällt.
CALENDARWEEK(date Datum; [number ErsterTagderWoche])

Datum: Das Datum für das die Kalendarwoche bestimmt werden soll.

ErsterTagderWoche: Gibt an, mit welchem Tag die Woche beginnen soll
Die Parameter können sein:
  • 1=Sonntag
  • 2=Montag
  • 3=Dienstag
  • 4=Mittwoch
  • 5=Donnerstag
  • 6=Freitag
  • 7=Samstag

  • Defaultwert ist 2 (gem ISO 8601)

DAYOFCALENDARWEEK Berechnet das Datum für einen bestimmten tag innerhalb einer Kalendarwoche.
Beispiel: =dayOfCalendarWeek(1, 2, 2008, 1) Ergebnis: 31.12.07 Erklärung: Der 31.12.07 fällt auf einen Montag der ersten Kalendarwoche.
DAYOFCALENDARWEEK(number Kalendarwoche; number Tag; number Jahr; [number ErsterTagDerWoche])

Kalendarwoche: Kalendarwoche aus der ein Wochentag berechnet werden soll.

Tag: Tag der Kalendarwoche. (Aufstellung der Tage s. ErsterTagDerWoche)

Jahr: Das Jahr in dem die gewünschte Kalendarwoche liegt.

ErsterTagderWoche: Gibt an, mit welchem Tag die Woche beginnen soll
Die Parameter können sein:
  • 1=Sonntag
  • 2=Montag
  • 3=Dienstag
  • 4=Mittwoch
  • 5=Donnerstag
  • 6=Freitag
  • 7=Samstag

  • Defaultwert ist 2 (gem ISO 8601)

DAYOFWEEK Berechnet das Datum für einen Tag in der Woche eines Datums.
Beispiel: =dayofweek("5.1.2008", 2, 2) Ergebnis: 31.12.07 Erklärung: Der Montag in der Woche vom 5.1.2008 is der 31.12.07.
DAYOFWEEK(date Datum; number Tag; [number ErsterTagDerWoche])

Datum: Das Datum aus dem ein Tag in der Woche ermittelt werden soll.

Tag: Der zu ermittelnde Tag. (Aufstellung der Tage s. ErsterTagDerWoche)

ErsterTagderWoche: Gibt an, mit welchem Tag die Woche beginnen soll
Die Parameter können sein:
  • 1=Sonntag
  • 2=Montag
  • 3=Dienstag
  • 4=Mittwoch
  • 5=Donnerstag
  • 6=Freitag
  • 7=Samstag

  • Defaultwert ist 2 (gem ISO 8601)

Zeitfunktionen Syntax
TIME
-
ZEIT
Die Zeit-Funktion gibt die aktuell Uhrzeit zurück. Die Ausgabe erfolgt lokalisiert und ist abhängig von den Ländereinstellungen des Betriebssystems.

Beispiel: =TIME() Mit dem Ergebnis 15:48:45
TIME()
HOUR
-
STUNDE
Die Stundenfunktion gibt die Stunde des Datums zurück.

Beispiel: =HOUR(#27.03.2006 13:18:45#) Ergebnis: =13
HOUR(date Datum)

Datum: Das Datum aus dem die Stunde zurückgegeben werden soll.
MINUTE
-
MINUTE
Die Minutenfunktion gibt die Minute zurück

Beispiel: =MINUTE(#27.03.2006 13:18:45#) Ergebnis: =18
MINUTE(date Datum)

Datum: Das Datum aus dem die Minute zurückgegeben werden soll.
SECOND
-
SEKUNDE
Die Sekundenfunktion gibt die Sekunde zurück

Beispiel: =SECOND(#27.03.2006 13:18:45#) Ergebnis: =45
SECOND(date Datum)

Datum: Das Datum aus dem die Sekunde zurückgegeben werden soll.