Dokumentation / Calc Funktionen

    From The Document Foundation Wiki
    This page is a translated version of the page Documentation/Calc Functions and the translation is 100% complete.


    Einführung

    Der Abschnitt zu den Calc Funktionen im The Document Foundation Wiki wird vom LibreOffice Documentation Team gewartet und ist ein Verzeichnis für technische Informationen über die Funktionen die für die Nutzer von Calc zugänglich sind. Diese Funktionen werden üblicherweise über die Funktions Assistenten oder aber auch auf anderem Wege eingesetzt.

    Diese Dokumentation ersetzt nicht die Informationen aus dem Hilfe-System und dem Calc-Führer. Der Sinn dieser Wiki ist es, zusätzliche Hintergrund-Informationen, Erklärungen, Bilde, Zeichnungen, Use Cases und Daten zu liefern, die zusammen eine eher zusammenfassende technische Beschreibung der Funktionen bietet.

    Status

    Zum Zeitpunkt der Erstellung dieser Einführung (Januar 2020) waren die Wiki-Seiten der Calc Funktionen noch in Erstellung. Sie werden veröffentlicht, sobald es uns die Zeit erlaubt. Ursprünglich enthält jede Funktionen-Seite oben eine Info-Box mit dem Text "Achtung! Baustelle! Beachten Sie bitte das Hilfe-System." Sobald eine Seite komplett veröffentlicht und gegengelesen ist, wird diese Info-Box entfernt.

    Entgegen den Gepflogenheiten beim Hilfe-System und dem Calc-Führer werden die Wiki-Seiten der Calc Funktionen nicht über LibreOffice versioniert. Historische Funktionen werden üblicherweise nicht aus der Software entfernt oder in der Funktionalität angepasst (außer aufgrund einer Fehler-Beseitigung) und neue Funktionen werden hinzugefügt sobald sie verfügbar sind. Die Wiki-Seiten für neue Funktionen werden erstellt, sobald sich ein Freiwilliger dazu bereit erklärt. Bei jedem Update spiegelt die Seite den aktuellen Stand der Informationen wieder.

    Funktionen Finden

    Jede Funktion wird auf einer eigenen Wiki-Seite beschrieben. Um auf die Seite der Funktion zuzugreifen, benutzen Sie die dynamische Tabelle auf der Seite Funktionsliste. Die Tabelle ermöglicht es, nach Funktionsname und -kategorie zu sortieren und zu filtern

    Struktur der Funktions-Seiten

    Die Informationen für jede Funktion werden in einem gemeinsamen Format unter den folgenden Stichpunkten geliefert:

    • Funktionsname
    • Kategorie
    • Zusammenfassung
    • Syntax
    • Rückgabewerte
    • Argumente
    • Zusätzliche Informationen
    • Beispiele
    • Ähnliche LibreOffice Funktionen
    • ODF Standard
    • entsprechende Excel-Funktionen

    Um eine durchgehende Beschreibung zu geben kann eine Wiki auch Informationen aus der Hilfe und dem Calc Führer wiederholen.

    Funktion Syntax

    Alle Funktionen haben eine ähnliche Struktur. Als ein typisches Beispiel dient die Struktur der Funktion zum Suchen von Zellen aus einer Calc Datenbank. Diese Funktion erfüllt einige Such-Paramter und lautet:

    =DCOUNT(Datenbank; Datenbank Feld; Such-Parameter)
    

    Eine Funktion muss immer Teil einer Formel sein. Konsequenterweise, auch wenn die Funktion die ganze Formel darstellt, muss daher immer ein = am Anfang der Formel stehen. Wenn Seiten in dieser Wiki die Syntax einer Funktion beschreiben, wird das = oft weggelassen. Es ist dagegen in allen Beispiel-Formeln zu dieser Funktion vorhanden.

    Unabhängig davon wo die Funktion in der Formel auftaucht beginnt diese Dokumentation mit dem Funktionsnamen wie DCOUNT im obigen Beispiel. Üblicherweise werden Funktionsnamen durchgehend in Großbuchstaben gehalten, obwohl sie Calc auch in Kleinbuchstaben oder Groß-/Kleinbuchstaben gemischt versteht. In dieser Wiki werden Funktionsnamen zur Klarstellung in Großbuchstaben geschrieben.

    Nach dem Funktionsnamen folgt eine Liste der Argumente in runden Klammern. Falls eine Funktion keine Argumente hat, dann folgen in einer Formel trotzdem die runden Klammern. Alle aufgelisteten Argumente sind erforderlich, außer sie sind als optional gekennzeichnet.Beim Aufruf einer Funktion müssen die Argumente in der geforderten Reihenfolge und vom erwarteten Typ sein. Sollten die Argumente nicht in der geforderten Reihenfolge oder nicht vom erwarteten Typ sein, gibt die Funktion entweder eine Fehlermeldung oder ein unerwartetes Ergebnis zurück.

    Ein spezielles Zeichen wird zur Trennung der Argumente genutzt - als Voreinstellung dient ein Komma oder ein Strichpunkt. Diese Voreinstellung kann aber auch auf Ihre Präferenz über Extras ▸ Optionen... ▸ LibreOffice Calc ▸ Formel ▸ Trennzeichen geändert werden.

    Optionale Argumente werden durch eckige Klammern um das Argument angegeben. Beim Aufruf einer Funktion in einer Formel können optionale Argumente nur dann weggelassen werden, wenn keine Argumente mehr folgen. Als Beispiel dient eine Funktion mit 4 Argumenten, wovon die letzten beiden Argumente als optional gekennzeichnet sind. Hier können entweder Argument 4 oder Argumente 3 und 4 weggelassen werden, nicht aber Argument 3 alleine. In vielen Fällen ersetzt Calc ein weggelassenes optionales Argument mit einem voreingestelltem Wert - dieser voreingestellte Wert ist spezifisch für die Funktion.

    Abkürzungen

    Eine Liste der Abkürzungen der Calc Funktionen Wiki ist erhältlich.

    Richtlinien zur Aktualisierung der Calc Funktionen Wiki

    Wenn Sie diese Wiki ändern, beachten Sie bitte Richtlinien und Tipps bevor Sie Änderungen vornehmen.