Welche Funktionen kann man in Formeln nutzen?
aB-Agenta Formeln unterstützen folgende Funktionen.
Die Groß-/Klein-Schreibung ist generell gleichgültig.
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. | =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 gerundet. | =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. | =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. | =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. | =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. | =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. | =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. 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. | =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) |