Funktionsbibliothek
Zoho Books bietet eine integrierte Funktionsbibliothek, eine Sammlung vordefinierter mathematischer, Text- und logischer Funktionen, die Sie verwenden können, um Berechnungen durchzuführen, Text zu manipulieren und Bedingungen zu bewerten. Diese Funktionen sind sowohl im Formel-Datentyp für benutzerdefinierte Felder als auch in HTML-PDF-Vorlagen verfügbar.
Hinweis: Die Funktionsbibliothek enthält vordefinierte Funktionen, die in Zoho Books integriert sind. Diese unterscheiden sich von Funktionen, die benutzerdefinierte Skripte sind, die Sie mit Deluge schreiben, um Arbeitsabläufe zu automatisieren.
Jede Funktion in der Bibliothek führt eine spezifische Aktion basierend auf den Werten aus, die Sie als Eingabe bereitstellen, und generiert einen neuen Wert als Ausgabe. Eine Funktion besteht aus:
- Funktionsname: Der vordefinierte Name der Funktion, gefolgt von Klammern. Zum Beispiel:
ABS(),CEILING(). - Argumente: Die Werte, die innerhalb der Klammern bereitgestellt werden. Argumente können Zahlen, Text oder andere Funktionen sein. Mehrere Argumente sind durch Kommas getrennt. Zum Beispiel:
MAX(20, 5, 45). - Operatoren: Mathematische Symbole, die innerhalb von Argumenten verwendet werden, um Berechnungen durchzuführen. Zum Beispiel:
IF(2==2).
Mathematische Funktionen
Mathematische Funktionen führen numerische Berechnungen durch.
Die folgende Tabelle listet die verfügbaren mathematischen Funktionen mit ihrer Syntax und Beispielen auf:
| Funktionsname | Beschreibung | Syntax | Beispiele |
|---|---|---|---|
| Abs | Gibt den absoluten (nicht-negativen) Wert einer Zahl zurück. | ABS(Zahl) | ABS(-42) gibt 42 zurück, ABS(+33) gibt 33 zurück. |
| Addmonths | Fügt einem Datum Monate hinzu oder subtrahiert sie und gibt das neue Datum zurück. | ADDMONTHS(Datum, Zahl) | ADDMONTHS(“2022-10-17”, 3) gibt 2023-01-17 zurück, ADDMONTHS(“2022-10-17”, -5) gibt 2022-05-17 zurück. |
| Avg | Gibt den Durchschnittswert der angegebenen Zahlen zurück. | AVG(Zahl1, Zahl2, …, Zahl30) | AVG(1,2,3) gibt 6 zurück, AVG(5,6,7,-9) gibt 2.25 zurück. |
| Ceiling | Rundet auf die nächste ganze Zahl auf. | CEILING(Zahl) | CEILING(3.4) gibt 4 zurück, CEILING(-3.4) gibt -3 zurück. |
| Datum | Wandelt die angegebenen Jahr-, Monat- und Tageswerte in ein Datum im Format yyyy/mm/dd um. | DATE(Jahr, Monat, Tag) | DATE(2022,10,17) gibt 2022/10/17 zurück. |
| Abrunden | Rundet auf die nächste ganze Zahl ab. | FLOOR(Zahl) | FLOOR(3.8) gibt 3 zurück, FLOOR(-3.4) gibt -4 zurück. |
| Max | Gibt die größte der angegebenen Zahlen zurück. | MAX(Zahl1, Zahl2, …, Zahl 30) | MAX(3,1,5,2) gibt 5 zurück, MAX(0,-4,-3,-2) gibt 0 zurück. |
| Min | Gibt die kleinste der angegebenen Zahlen zurück. | MIN(Zahl1, Zahl2, …, Zahl 30) | MIN(5,-3,0,1) gibt -3 zurück, MIN(0,4,1) gibt 0 zurück. |
| Prozentsatz | Gibt an, wie viel Prozent Zahl2 von Zahl1 ist. | PERCENTAGE(Zahl1, Zahl2) | PERCENTAGE(20,5) gibt 25 zurück. |
| Produkt | Multipliziert die angegebenen Zahlen. | PRODUCT(Zahl1, Zahl2, …, Zahl30) | PRODUCT(5,6) gibt 30 zurück, PRODUCT(5,-6) gibt -30 zurück, PRODUCT(-5,-6) gibt 30 zurück. |
| Runden | Rundet eine Zahl auf die angegebene Anzahl von Dezimalstellen. | ROUND(Zahl, Dezimalstelle) | ROUND(123.344, 2) gibt 123.34 zurück, ROUND(123.345, 2) gibt 123.35 zurück. |
| Serie | Generiert eine Folge von Zahlen von Start bis Ende mit einem optionalen Schritt. | SERIES(Zahl, Zahl, Zahl) | SERIES(5), SERIES(3,7), SERIES(2,10,2). |
| Summe | Gibt die Summe aller angegebenen Zahlen zurück. | SUM(Zahl1, Zahl2, …, Zahl 30) | SUM(3,8,5) gibt 16 zurück, SUM(5,6,-3,0) gibt 8 zurück. |
| Wurzel | Gibt die Quadratwurzel der angegebenen Zahl zurück. | SQRT(Zahl) | SQRT(9) gibt 3 zurück, SQRT(ABS(-9)) gibt 3 zurück. |
Hinweis:
- Sie können die Standardfelder von Zoho Books oder benutzerdefinierte Felder als Argumente verwenden. Zum Beispiel, Addmonths(Datum, 3) fügt drei Monate zum Verkaufsbestelldatum hinzu und gibt das neue Datum zurück.
- Sie können Funktionen innerhalb anderer Funktionen verschachteln. Zum Beispiel, Sum(Max(10,15), Min(2,5)) gibt 17 zurück.
- Die Funktion Sqrt() unterstützt keine negativen Zahlen. Verwenden Sie Abs() innerhalb von Sqrt(), um negative Werte zu behandeln, z.B. SQRT(ABS(-9)).
Die folgende Tabelle listet die Einschränkungen für mathematische Funktionen auf:
| Funktionsname | Anzahl der erforderlichen Argumente | Argumentdatentyp | Ausgabedatentyp |
|---|---|---|---|
| Abs | 1 | Zahl | Zahl, Zeichenfolge |
| Addmonths | 2 | Zeichenfolge, Zahl | Datum, Zeichenfolge |
| Durchschnitt | Mehrere | Alle Zahlen | Zahl, Zeichenfolge |
| Decke | 1 | Zahl | Zahl, Zeichenfolge |
| Datum | 3 | Zahl, Zahl, Zahl | Datum, Zeichenfolge |
| Abrunden | 1 | Zahl | Zahl, Zeichenfolge |
| Max | Mehrere | Alle Zahlen | Zahl, Zeichenfolge |
| Min | Mehrere | Alle Zahlen | Zahl, Zeichenfolge |
| Prozentsatz | 2 | Zahl, Zahl | Zahl, Zeichenfolge |
| Produkt | Mehrere | Alle Zahlen | Zahl, Zeichenfolge |
| Runden | 2 | Zahl, Zahl | Zahl, Zeichenfolge |
| Summe | Mehrere | Alle Zahlen | Zahl, Zeichenfolge |
| Wurzel | 1 | Zahl | Zahl, Zeichenfolge |
Einblick: Wenn der Ausgabedatentyp Zeichenfolge ist, bezieht sich dies nur auf den Textfeldtyp (Einzeilige Eingabe), nicht auf E-Mail, URL, Telefon, automatisch generierte Nummer oder Dropdown.
Textfunktionen
Textfunktionen ermöglichen es Ihnen, Text zu manipulieren oder zu formatieren.
Die folgende Tabelle listet die verfügbaren Textfunktionen mit ihrer Syntax und Beispielen auf:
| Funktionsname | Beschreibung | Syntax | Beispiele |
|---|---|---|---|
| Char | Gibt das Zeichen für den angegebenen ASCII-Code zurück. | CHAR(Zahl) | CHAR(97) gibt a zurück, CHAR(65) gibt A zurück. |
| Clean | Entfernt nicht druckbare Zeichen aus dem Text. | CLEAN(Zeichenfolge) | CLEAN(“H¶ello”) gibt Hello zurück. |
| Code | Gibt den ASCII-Code des ersten Zeichens in der Zeichenfolge zurück. | CODE(Zeichenfolge) | CODE(“Apple”) gibt 65 zurück, CODE(“apple”) gibt 97 zurück, CODE(“B”) gibt 98 zurück, CODE(“n”) gibt 110 zurück. |
| Concatenate | Kombiniert zwei Zeichenfolgen zu einer einzigen Zeichenfolge. | CONCATENATE(Zeichenfolge1, Zeichenfolge2) | CONCATENATE(“FirstName”, “LastName”) gibt FirstNameLastName zurück. |
| Exact | Gibt wahr zurück, wenn die beiden Zeichenfolgen identisch sind. | EXACT(Zeichenfolge1, Zeichenfolge2) | EXACT(“Zoho”, “Zoho”) gibt wahr zurück, EXACT(“Zoho”, “zoho”) gibt falsch zurück. |
| Fixed | Rundet eine Zahl auf die angegebenen Dezimalstellen und fügt optional Kommas hinzu. | FIXED(Zahl, Dezimalstellen(optional), keine_Kommas(optional)) | FIXED(12345678.4367,3,FALSE) gibt 12.345.678,437 zurück, FIXED(12345678.437,3,TRUE) gibt 12345678,437 zurück, FIXED(12345678.4367) gibt 12345678,44 zurück. |
| Mid | Extrahiert Zeichen aus der Mitte einer Zeichenfolge, beginnend an einer bestimmten Position. | MID(Zeichenfolge, Startposition, Anzahl_der_Zeichen) | MID(“welcome”, 4, 7) gibt come zurück. |
| Left | Gibt die angegebene Anzahl von Zeichen vom Anfang einer Zeichenfolge zurück. | LEFT(Zeichenfolge, Anzahl) | LEFT(“Apple”, 3) gibt App zurück, LEFT(“Chess”, 2) gibt Ch zurück. |
| Len | Gibt die Anzahl der Zeichen in einer Zeichenfolge zurück, einschließlich Leerzeichen. | LEN(Zeichenfolge) | LEN(“abc”) gibt 3 zurück, LEN(" abc “) gibt 5 zurück. |
| Lower | Wandelt eine Zeichenfolge in Kleinbuchstaben um. | LOWER(Zeichenfolge) | LOWER(APPLES) gibt apples zurück, LOWER(Apples) gibt apples zurück. |
| Proper | Großschreibt den ersten Buchstaben jedes Wortes und macht den Rest klein. | PROPER(Zeichenfolge) | PROPER(zoho books) gibt Zoho Books zurück, PROPER(Zoho books) gibt Zoho Books zurück, PROPER(GadGet) gibt Gadget zurück. |
| Right | Gibt die angegebene Anzahl von Zeichen vom Ende einer Zeichenfolge zurück. | RIGHT(Zeichenfolge, Anzahl_der_Zeichen) | RIGHT(“Zoho Books”, 5) gibt Books zurück. |
| Rept | Wiederholt einen Wert eine bestimmte Anzahl von Malen. | REPT(Wert, Anzahl) | REPT(“A”, 6) gibt AAAAAA zurück, REPT(“The”, 2) gibt TheThe zurück, REPT(“1”, 3) gibt 111 zurück. |
| Replace | Ersetzt einen Teil der Zeichenfolge durch einen anderen Text. | REPLACE(alter_text, Startnummer, Anzahl_der_Zeichen, neuer_text) | REPLACE(“South Africa”, 1, 5, “North”) gibt North Africa zurück, REPLACE(“abcdef”, 4, 3, “xyz”) gibt abcxyz zurück. |
| Search | Gibt die Position zurück, an der string2 erstmals in string1 erscheint. | SEARCH(Zeichenfolge1, Zeichenfolge2, Zahl(optional)) | SEARCH(“Elephant”, “e”, 2) gibt 3 zurück, SEARCH(“Elephant”, “E”) gibt 1 zurück, SEARCH(“Antarctica”, “a”, 3) gibt 4 zurück. |
| Substitute | Ersetzt Vorkommen eines bestimmten Textes in einer Zeichenfolge. | SUBSTITUTE(Zeichenfolge, alter_text, neuer_text, Vorkommen(optional)) | SUBSTITUTE(“Dog in the wall, and Dog in the street”, “Dog”, “Cat”) gibt Cat in the wall, and Cat in the street zurück, SUBSTITUTE(“Dog in the wall, and Dog in the street”, “Dog”, “Cat”, 2) gibt Dog in the wall, and Cat in the street zurück. |
| Upper | Wandelt eine Zeichenfolge in Großbuchstaben um. | UPPER(Zeichenfolge) | UPPER(apples) gibt APPLES zurück, UPPER(APPles) gibt APPLES zurück. |
| T | Gibt den Wert zurück, wenn er Text ist; andernfalls wird leer zurückgegeben. | T(Zeichenfolge) | T(“India”) gibt India zurück, T(1) gibt leer zurück, T(True) gibt leer zurück. |
| Trim | Entfernt führende und nachfolgende Leerzeichen aus einer Zeichenfolge. | TRIM(Zeichenfolge) | TRIM(” abcd “) gibt abcd zurück. |
Hinweis:
- Sie können die Standardfelder von Zoho Books oder benutzerdefinierte Felder als Argumente verwenden. Zum Beispiel wandelt upper(notes) den Wert des Notizfelds in Großbuchstaben um.
- Sie können Funktionen innerhalb anderer Funktionen verschachteln. Zum Beispiel gibt len(mid(“Finance”,4,3)) 3 zurück.
- In der Funktion fixed() sind decimal_places und no_commas optional. Ohne diese Argumente rundet die Funktion auf zwei Dezimalstellen und lässt Kommas weg. Wenn no_commas wahr ist, werden Kommas weggelassen.
Die folgende Tabelle listet die Einschränkungen für Textfunktionen auf:
| Funktionsname | Anzahl der erforderlichen Argumente | Argumentdatentyp | Ausgabedatentyp |
|---|---|---|---|
| Char | 1 | Zahl | Zeichenfolge |
| Clean | 1 | Zeichenfolge | Zeichenfolge |
| Code | 1 | Zeichenfolge | Zahl |
| Concatenate | 2 | Zeichenfolge, Zeichenfolge | Zeichenfolge |
| Exact | 2 | Zeichenfolge, Zeichenfolge | Zeichenfolge |
| Fixed | 3 | Zahl, Zahl, Boolesch | Zahl |
| Mid | 3 | Zeichenfolge, Zahl, Zahl | Zeichenfolge |
| Left | 2 | Zeichenfolge, Zahl | Zeichenfolge |
| Len | 1 | Zeichenfolge | Zahl |
| Lower | 1 | Zeichenfolge | Zeichenfolge |
| Proper | 1 | Zeichenfolge | Zeichenfolge |
| Right | 2 | Zeichenfolge, Zahl | Zeichenfolge |
| Rept | 2 | Zeichenfolge, Zahl | Zeichenfolge |
| Replace | 4 | Zeichenfolge, Zahl, Zahl, Zeichenfolge | Zeichenfolge |
| Search | 3 | Zeichenfolge, Wert, Zahl | Zahl |
| Substitute | 4 | Zeichenfolge, Zeichenfolge, Zeichenfolge, Zahl | Zeichenfolge |
| Upper | 1 | Zeichenfolge | Zeichenfolge |
| T | 1 | Zeichenfolge | Zeichenfolge |
| Trim | 1 | Zeichenfolge | Zeichenfolge |
Einblick: Die Funktion T() gibt leer zurück, wenn die Eingabe keine Zeichenfolge ist.
Logische Funktionen
Logische Funktionen bewerten Bedingungen und geben wahr oder falsch zurück.
Die folgende Tabelle listet die verfügbaren logischen Funktionen mit ihrer Syntax und Beispielen auf:
| Funktionsname | Beschreibung | Syntax | Beispiele |
|---|---|---|---|
| And | Gibt nur dann wahr zurück, wenn alle Bedingungen wahr sind. | AND(Bedingung1, Bedingung2, …, Bedingung30) | AND(2>1, 5>3, 7<8) gibt wahr zurück, AND(2>1, 5>3, 7>8) gibt falsch zurück. |
| Count | Gibt die Anzahl der numerischen Werte unter den angegebenen Werten zurück. | COUNT(Wert1, Wert2, …, Wert30) | COUNT(10, 11.5, “Zeichenfolge”, -55, “25”) gibt 3 zurück. |
| If | Gibt Wert1 zurück, wenn die Bedingung wahr ist; andernfalls Wert2. | IF(Bedingung, Wert1, Wert2) | IF(8>7,1,0) gibt 1 zurück, IF(8<7, “Gültig”, “Ungültig”) gibt Ungültig zurück. |
| Isblank | Gibt wahr zurück, wenn der Wert leer ist; andernfalls falsch. | ISBLANK(Wert) | ISBLANK() gibt wahr zurück, ISBLANK(197) gibt falsch zurück. |
| Isnumber | Gibt wahr zurück, wenn der Wert eine Zahl ist; andernfalls falsch. | ISNUMBER(Wert) | ISNUMBER(25) gibt wahr zurück, ISNUMBER(apple) gibt falsch zurück. |
| Not | Gibt das Gegenteil der Bedingung zurück: falsch, wenn wahr, wahr, wenn falsch. | NOT(Bedingung) | NOT(1==1) gibt falsch zurück, NOT(1==2) gibt wahr zurück. |
| Or | Gibt wahr zurück, wenn eine der Bedingungen wahr ist. | OR(Bedingung1, Bedingung2, …, Bedingung30) | OR(1<2,3>5,7>8) gibt wahr zurück, OR(1>2,3>5,7>8) gibt falsch zurück. |
Hinweis:
- Sie können die Standardfelder von Zoho Books oder benutzerdefinierte Felder als Argumente verwenden. Zum Beispiel gibt isblank(notes) true zurück, wenn das Notizfeld leer ist, und false, wenn es einen Wert hat.
- Sie können Funktionen innerhalb anderer Funktionen verschachteln. Zum Beispiel gibt not(and(8<9,1>0)==or(10>9,100>99) false zurück.
Die folgende Tabelle listet die Einschränkungen für logische Funktionen auf:
| Funktionsname | Anzahl der erforderlichen Argumente | Argumentdatentyp | Rückgabetyp |
|---|---|---|---|
| Und | Mehrere | Boolean | Boolean |
| Zählen | Mehrere | Generic | Boolean |
| Wenn | 3 | Generic | Boolean |
| IstLeer | 1 | Generic | Boolean |
| IstZahl | 1 | Generic | Boolean |
| Nicht | 1 | Boolean | Boolean |
| Oder | Mehrere | Boolean | Boolean |
Einblick: Generic bedeutet jeder Datentyp: numerisch, Zeichenfolge oder boolean. Der Rückgabetyp entspricht dem Eingabedatentyp.