Документация. Функции Calc
TDF LibreOffice Document Liberation Project Блоги сообщества Weblate Nextcloud Redmine Ask LibreOffice Пожертвования
Введение
Раздел вики The Document Foundation Функции Calc поддерживается командой документации LibreOffice и представляет собой репозиторий технической информации о функциях, доступных пользователям Calc. Эти функции обычно доступны через Мастер функций, но могут быть доступны и другими путями.
Материал, представленный в этом разделе, не замещает соответствующую информацию в файлах Справки и Руководстве пользователя Calc. Роль этих страниц в вики предоставить дополнительный фон, объяснения, изображения, рисунки, случаи использования и данные, которые вместе предоставляют более всестороннее техническое описание функций.
Статус
Во время написания этого Введения (Январь 2020), вики страницы Функций Calc были в стадии разработки. Они будут заполнены, как только позволит время. Первоначально страница каждой функции будет включать информационное поле в верхней части, содержащее текст «В разработке. На данный момент см. файлы Справки». Когда страница будет полностью заполнена и проверена, это информационное поле будет удалено.
В отличие от файлов Справки и Руководства по Calc, раздел Функции Calc не предназначен для конкретной сборки программного обеспечения LibreOffice. Исторически функции обычно не удаляются из программного обеспечения и в них не изменяются функциональные возможности (кроме исправления ошибок), а новые функции добавляются по мере их появления. Страницы вики будут доработаны для включения новых функций, когда волонтеры смогут это сделать. При каждом обновлении на страницах вики будет отражаться самая последняя доступная информация.
Функции поиска
Каждая функция описана на отдельной странице вики. Для доступа к какой-либо нужной вам странице с функцией используйте динамическую таблицу на странице Список функций. Таблица позволяет сортировать и фильтровать по имени функции и по категориям.
Структура страниц с описанием функций
Информация для каждой функции представлена в одинаковом формате под следующими заголовками:
- Имя функции
- Категория
- Краткое описание
- Синтаксис
- Возвращает
- Аргументы
- Дополнительная информация
- Примеры
- Связанные функции LibreOffice
- Стандарт ODF
- Аналогичная функция Excel
Чтобы представить последовательное описание, на странице в вики может повторяться информация, которая уже включена в файлы Справки и Руководство по Calc.
Синтаксис функции
Все функции имеют одинаковую структуру. Как типовой пример, структура функции для поиска ячеек в базе данных Calc, которая сравнивает некоторые критерии поиска, будет такая:
=ДСЧЁТ(База данных; Поле базы данных; Критерий поиска)
Функция не может существовать сама по себе; она всегда должна быть частью формулы. Следовательно, даже если одна единственная функция и представляет собой всю формулу, то в начале формулы все равно должен быть знак =. Когда страницы в этом разделе вики описывают синтаксис функции, то знак = для удобства опущен. Однако, он включен во все примеры формул, которые ссылаются на функцию.
Независимо от того, где в формуле появляется ссылка на функцию, эта ссылка будет начинаться с имени функции, например ДСЧЁТ в приведенном выше примере. По традиции имена функций вводятся полностью в верхнем регистре, хотя Calc также правильно распознает имя функции, если оно будет написано в нижнем или смешанном регистре. В этом разделе вики имена функций написаны в верхнем регистре для ясности.
После имени функции следует список ее аргументов, заключенный в круглые скобки. Если функция не имеет аргументов, вы все равно должны вводить круглые скобки при использовании функции в формуле. Все перечисленные аргументы являются обязательными, если только они специально не помечены, как необязательные. При использовании функции ее аргументы должны вводиться в правильном порядке, и каждый аргумент должен быть ожидаемого типа. Если вы поместите аргументы в другом порядке или аргументы не относятся к ожидаемому типу, функция может вернуть сообщение об ошибке или может вернуть неожиданный результат.
Для разделения аргументов функций используется специальный символ - обычно, по умолчанию используется запятая или точка с запятой (;), но это можно изменить в соответствии с вашими предпочтениями в диалоге ▸ ▸ ▸ ▸ . В этом разделе вики для разделения аргументов функций используется точка с запятой (;).
Необязательные аргументы заключаются в квадратные скобки вокруг имени аргумента. При ссылке на функцию в формуле аргументы, помеченные как необязательные, могут быть пропущены, только если за ними нет следующих аргументов. Например, в функции с четырьмя аргументами, где последние два аргумента отмечены, как необязательные, вы можете не указывать аргумент 4 или аргументы 3 и 4, но вы не можете пропустить аргумент 3 отдельно. Во многих случаях, если вы пропускаете необязательный аргумент, Calc будет применять значение по умолчанию - это значение по умолчанию будет своим специфичным для каждой функции.
Сокращения
Доступен Список сокращений, используемый на страницах вики с описанием Функций Calc.
Рекомендации по обновлению страниц в вики с описанием Функций Calc
Просьба тем, кто обновляет страницы в этом разделе вики, прочитать наши Рекомендации и советы, прежде чем вносить какие-либо изменения.