Welche Funktionen kann man in Formeln nutzen?
aB-Agenta Formeln unterstützen folgende Funktionen.
Funktionsnamen werden in den Schreibweisen klein (iif), mit großem Anfangsbuchstaben (Iif) und komplett groß (IIF) erkannt. Andere Mischformen (z. B. iIf) funktionieren nicht; schreiben Sie die Namen am besten wie in der Spalte „Syntax“.
In eckige Klammern eingerahmte Parameter sind optional und haben bei Weglassen automatisch den mit Gleichheitszeichen dahinter angegebenen Wert.
| Funktion | Syntax | Beschreibung | Beispiel |
| Iif | iif(Bedingung, dann, sonst) | Prüft, ob eine Bedingung zutrifft und gibt je nach Prüfungsergebnis einen von zwei Werten zurück. | =iif(<>, 'Ihre', 'Deine') |
| IsInArray | isinarray(Prüfwert, Wert1, Wert2, ...) | Prüft, ob ein Wert in einer Auflistung anderer Werte enthalten ist. Texte werden ohne Beachtung der Groß-/Kleinschreibung verglichen. | =isInArray(<>, 'Maklervollmacht', 'Maklervertrag') |
| Choose | choose(Index, Auswahl1, Auswahl2, ...) | Gibt den Wert aus einer Auswahl von Werten an einer bestimmten Stelle (Index) zurück. Der Index beginnt bei 1. | =choose(2, 16.15, 16.34, 19) → 16.34 |
| Int | int(Wert) | Wandelt einen Wert in eine ganze Zahl ("Integer") um. Kommazahlen werden immer abgerundet, also auf die nächstkleinere ganze Zahl (int(-1.5) → -2). Zum Runden verwenden Sie round oder cint. | =int('15') |
| Fix | fix(Wert) | Wandelt einen Wert in eine ganze Zahl um. Werte größer als 0 werden abgerundet, Werte kleiner als 0 werden aufgerundet. | =fix('15') |
| Round | round(Zahl, Dezimalstellen) | Rundet eine Kommazahl auf die angegebene Anzahl an Nachkommastellen auf oder ab. Es wird kaufmännisch gerundet, d.h. ab 5 wird aufgerundet (round(2.5, 0) → 3). | =round(<> * 1.19, 2) |
| Abs | abs(Zahl) | Gibt den absoluten Wert einer Zahl zurück, d.h. entfernt ggf. ein negatives Vorzeichen. | =abs(-12) → 12 |
| InStr | instr(Text, Suchtext) | Sucht einen Text innerhalb eines anderen Texts und gibt dessen Position zurück oder 0 falls er nicht enthalten ist. Die Groß-/Kleinschreibung wird dabei nicht beachtet. | =instr('Beispiel','eis') → 2 |
| Mid | mid(Text, Position, Länge) | Gibt einen Teil eines Textes zurück, beginnend ab einer bestimmten Position und mit einer bestimmten Länge. Die Position des ersten Zeichens ist 1. Ist die Länge 0 oder negativ, wird der gesamte Rest des Textes ab der Position zurückgegeben. | =mid('Beispiel', 2, 3) → 'eis' |
| Left | left(Text, Länge) | Gibt die ersten x Zeichen eines Textes zurück. | =left('Beispiel', 3) → 'Bei' |
| Right | right(Text, Länge) | Gibt die letzten x Zeichen eines Textes zurück. | =right('Beispiel', 3) → 'iel' |
| Trim | trim(Text) | Entfernt alle unsichtbaren Zeichen (Leerzeichen, Tabulator, Zeilenumbruch etc.) am Anfang und am Ende eines Textes. |
=trim(' Beispiel ') → 'Beispiel' |
| Replace | replace(Text, Suchtext, Ersetzung) | Ersetzt Text durch anderen Text innerhalb eines Textes. Es werden alle Fundstellen ersetzt, die Groß-/Kleinschreibung des Suchtextes wird dabei nicht beachtet. | =replace('Baispiel', 'ai', 'ei') → 'Beispiel' |
| Chr | chr(Zeichencode) | Gibt das Zeichen entsprechend dem übergebenen Zeichencode (Unicode) zurück. | =chr(228) → 'ä' |
| Len | len(Text) | Gibt die Anzahl der Zeichen eines Textes zurück. | =len('Beispiel') → 8 |
| cDbl | cdbl(Wert) | Wandelt falls möglich einen Wert in eine Kommazahl um. | =cdbl('13,4') → 13.4 |
| cInt | cint(Wert) | Wandelt falls möglich einen Wert in eine ganze Zahl um. Kommazahlen werden gerundet, bei genau 0,5 auf die nächste gerade Zahl (cint(2.5) → 2, cint(3.5) → 4). | =cint('12') → 12 |
| cStr | cstr(Wert) | Wandelt falls möglich einen Wert in eine Zeichenfolge um. | =cstr(14) → '14' |
| cBool | cbool(Wert) | Wandelt falls möglich einen Wert in einen Ja-/Nein-Wert um. | =cbool('True') → wahr |
| cDate | cdate(Wert) | Wandelt falls möglich einen Wert in ein Datum um. | =cdate('1.10.2000') → #10/1/2000# |
| Format | format(Wert, Format) | Erzeugt einen Text aus einem Wert anhand des übergebenen Formats. Formatiert werden Datums- und Zahlenwerte, andere Werte (z. B. Texte) bleiben unverändert. Zusätzlich zu den Formatierungszeichenfolgen von Microsoft gibt es die Kurzformen 'Currency' (Währung mit zwei Nachkommastellen) und 'Standard' (Tausendertrennzeichen, zwei Nachkommastellen). Die verwendbaren Formatierungszeichenfolgen finden Sie hier: https://learn.microsoft.com/de-de/dotnet/standard/base-types/formatting-types#format-strings-and-net-types |
=format(#10/14/2001#, 'd. MMMM') → '14. Oktober' |
| equals | equals(Text1, Text2) | Prüft, ob zwei Texte gleich sind, ignoriert dabei die Groß- und Kleinschreibung sowie Leerzeichen am Ende der Texte. Zwei leere Texte gelten als gleich. | =equals('Beispiel', 'beispiel') → wahr |
| IsDate | isdate(wert) | Prüft, ob ein beliebiger Wert einem Datum entspricht oder sich in ein Datum umwandeln lässt. | =isdate('1.2.2000') → wahr |
| Now | now() | Gibt den aktuellen Zeitpunkt (Datum und Uhrzeit) zurück. | =now() → #10/14/2024 09:36:10# |
| Time | time() | Gibt die aktuelle Uhrzeit (ohne Datum) zurück. | =time() → #09:36:10# |
| Today | today() | Gibt das aktuelle Datum (ohne Uhrzeit) zurück. | =today() → #12/30/2024# |
| Day | day(Datum) | Gibt den Tag eines Datums zurück. | =day(#10/14/2001 11:30:15#) → 14 |
| Month | month(Datum) | Gibt den Monat eines Datums zurück. | =month(#10/14/2001 11:30:15#) → 10 |
| Year | year(Datum) | Gibt das Jahr eines Datums zurück. | =year(#10/14/2001 11:30:15#) → 2001 |
| Hour | hour(Datum) | Gibt die Stunde eines Zeitpunkts zurück. | =hour(#10/14/2001 11:30:15#) → 11 |
| Minute | minute(Datum) | Gibt die Minute eines Zeitpunkts zurück. | =minute(#10/14/2001 11:30:15#) → 30 |
| Second | second(Datum) | Gibt die Sekunde eines Zeitpunkts zurück. | =second(#10/14/2001 11:30:15#) → 15 |
| Weekday | weekday(Datum, [ErsterWochentag]=1) | Gibt den Wochentag eines Datums als Zahl zurück. Standardmäßig ist der erste Wochentag der Sonntag. |
=weekday(#10/14/2001 11:30:15#) → 1 (=Sonntag) =weekday(#10/14/2001 11:30:15#, 2) → 7 (=Sonntag) |
| DateValue | datevalue(Wert) | Wandelt falls möglich einen Wert in ein Datum um und lässt die Uhrzeit weg. | =datevalue('14.10.2001 11:30') → #10/14/2001# |
| DatePart | datepart(Zeitintervall, Datum, [ErsterWochentag]=1, [ErsteWocheDesJahres]=1) | Gibt den angegebenen Teil eines Zeitpunkts zurück. Siehe https://learn.microsoft.com/de-de/dotnet/api/microsoft.visualbasic.dateandtime.datepart?view=netframework-4.7.2 |
=datepart('d', #10/14/2001 11:30:15#) → 14 |
| DateAdd | dateadd(Zeitintervall, Anzahl, Datum) | Addiert die angegebene Anzahl an Zeiteinheiten zu einem Datum. Siehe https://learn.microsoft.com/de-de/dotnet/api/microsoft.visualbasic.dateandtime.dateadd?view=netframework-4.7.2 |
=dateadd('d', 2, #10/14/2001 11:30:15#) → #10/16/2001 11:30:15# |
| DateDiff | datediff(Zeitintervall, Datum1, Datum2, [ErsterWochentag]=1, [ErsteWocheDesJahres]=1) | Bestimmt die Differenz zwischen zwei Zeitpunkten in der angegebenen Zeiteinheit. Siehe https://learn.microsoft.com/de-de/dotnet/api/microsoft.visualbasic.dateandtime.datediff?view=netframework-4.7.2 |
=datediff('d', #10/14/2001#, #10/16/2001#) → 2 (Tage) |
| alterZuBestimmtemZeitpunkt | alterzubestimmtemzeitpunkt(Geburtsdatum, Stichtag) | Gibt das Alter in vollendeten Jahren zurück, das jemand mit dem Geburtsdatum am Stichtag hat. | =alterzubestimmtemzeitpunkt(#10/14/2001#, #10/13/2026#) → 24 |