Функции надстроек
Ниже описываются и перечисляются некоторые имеющиеся в наличии функции надстроек.
В Справке также можно найти описание интерфейса надстроек LibreOffice Calc . Дополнительно, в Справке описываются важные функции и их параметры для Общей библиотекиDLL надстроек LibreOffice Calc.
Предоставляемые надстройки
В LibreOffice содержатся примеры интерфейса надстроек в LibreOffice Calc.
Функции для анализа (часть первая)
Функции для анализа (часть вторая)
ROT13
Служит для шифрования строки символов путём их смещения на 13 позиций в алфавите. После буквы Z алфавит начинается снова (повторяется). При повторном применении функции шифрования к полученному коду можно произвести расшифровку.
ROT13(Текст)
Текст: шифруемая символьная строка. ROT13(ROT13 (Текст)) дешифрует код.
=ROT13("Gur Qbphzrag Sbhaqngvba jnf sbhaqrq va Frcgrzore 2010.") возвращает строку «The Document Foundation was founded in September 2010.». Обратите внимание на то, что функция ROT13 сохраняет пробелы, цифры и точки.
ORG.OPENOFFICE.ROT13
Более подробную информацию по этой фукнции см. на wiki-странице ROT13.
ГОДЫ
Возвращает количество лет между двумя датами.
ГОДЫ(Начальная дата; Конечная дата; Тип)
Начальная дата: первая дата.
Конечная дата: вторая дата.
Тип: вычисляет тип различия. Возможные значения - 0 (интервал) и 1 (в календарных годах).
ORG.OPENOFFICE.YEARS
ДНЕЙВГОДУ
Вычисляет количество дней в году, на который пришлась указанная дата.
ДНЕЙВГОДУ(Дата)
Дата: любая дата в соответствующем году. Параметр «Дата» должен представлять собой допустимую дату в соответствии с настройками локали LibreOffice.
=ДНЕЙВГОДУ(A1) возвращает 366 дней, если ячейка A1 содержит значение 1968-02-29, которое является допустимой датой для 1968 года.
ORG.OPENOFFICE.DAYSINYEAR
ДНЕЙВМЕС
Вычисление количества дней в месяце, на который пришлась указанная дата.
ДНЕЙВМЕС(Дата)
Дата: любая дата в соответствующем месяце требуемого года. Параметр «Дата» должен представлять собой допустимую дату в соответствии с настройками локали LibreOffice.
=ДНЕЙВМЕС(A1) возвращает 29 дней, если ячейка A1 содержит значение 1968-02-17, которое является допустимой датой для февраля 1968 года.
ORG.OPENOFFICE.DAYSINMONTH
ЕВИСОКОСНЫЙ
Служит для определения високосного года. Если год високосный, то функция возвращает значение 1 (ИСТИНА); в противном случае возвращается значение 0 (ЛОЖЬ).
ЕВИСОКОСНЫЙ(Дата)
Дата: указывает попадает ли заданная дата на високосный год. Параметр «Дата» должен содержать допустимую дату.
Microsoft Excel неверно причисляет 1900 год к числу високосных и при вычислении даты рассматривает несуществующий день 1900-02-29 в качестве допустимого. Поэтому даты до 1900-03-01 в Excel и Calc будут отличатся.
=ЕВИСОКОСНЫЙ(A1) возвращает значение 1, если ячейка A1 содержит значение 1968-02-29, поскольку дата 29 февраля 1968 допустима при выбранных параметрах языка.
Также можно использовать =ЕВИСОКОСНЫЙ(DATE(1968;2;29)) или =ЕВИСОКОСНЫЙ("1968-02-29") с передачей строки даты в нотации ISO 8601.
Не следует использовать запись =ЕВИСОКОСНЫЙ(2/29/68), поскольку в данном случае сначала будет выполнено вычисление аргумента, где 2 будет поделено на 29 и на 68, после чего функция ЕВИСОКОСНЫЙ будет использовать полученное малое число в качестве даты в числовом формате.
ORG.OPENOFFICE.ISLEAPYEAR
МЕСЯЦЫ
Возвращает количество месяцев между двумя датами.
МЕСЯЦЫ(Начальная дата; Конечная дата; Тип)
Начальная дата: первая дата.
Конечная дата: вторая дата.
Тип: вычисляет тип различия. Возможные значения включают 0 (интервал) и 1 (в календарных месяцах).
ORG.OPENOFFICE.MONTHS
НЕДЕЛИ
Возвращает количество недель между двумя датами.
НЕДЕЛИ(Начальная дата; Конечная дата; Тип)
Начальная дата: начальная дата интервала.
Конечная дата: конечная дата интервала. Конечная дата должна быть больше начальной даты, в противном случае возвращается ошибка.
Тип: указывает на тип вычисляемой разницы. Возможны значения: 0 (интервал времени) или 1 (календарные недели).
Если Тип = 0, функция предполагает, что 7 дней эквивалентно одной неделе без установки конкретного дня для обозначения начала недели.
Если Тип = 1, то первым днём недели функция считает понедельник. Поэтому не считая начальной даты, каждое появление понедельника в интервале считается за ещё одну неделю.
Эта функция считает понедельник первым днём недели независимо от текущих настроек локали.
В следующих примерах даты передаются в виде строк. Однако они также могут хранится в отдельных ячейках и передаваться с помощью ссылок.
=НЕДЕЛИ("2022-01-12","2022-01-17",0) возвращает 0, потому что Тип имеет значение 0, а интервал составляет всего 5 дней.
=НЕДЕЛИ("2022-01-12","2022-01-19",0) возвращает 1, потому что Тип имеет значение 0, а интервал составляет 7 дней.
=НЕДЕЛИ("2022-01-12","2022-01-17",1) возвращает 1, потому что Тип имеет значение 1, а интервал включает понедельник, поскольку 2022-01-12 — среда, а 2022-01-17 — понедельник.
=НЕДЕЛИ("2022-01-12","2022-01-15",1) возвращает 0, потому что Тип имеет значение 1, а интервал не включает понедельники, за исключением начальной даты.
ORG.OPENOFFICE.WEEKS
НЕДЕЛЬВГОДУ
Вычисляет количество недель в году, на который пришлась указанная дата.Количество недель определяется следующим образом: неделя, выпадающая на два года, прибавляется к году, к которому относится большее число дней этой недели.
НЕДЕЛЬВГОДУ(Дата)
Дата: любая дата в соответствующем году. Параметр «Дата» должен представлять собой допустимую дату в соответствии с настройками локали LibreOffice.
Согласно ISO 8601, эта функция считает понедельник первым днём недели, а первой неделей года считается та, которая имеет большую часть дней в данном году.
НЕДЕЛЬВГОДУ(A1) возвращает значение 53, если ячейка A1 содержит значение 1970-02-17, которое является допустимой датой для 1970 года.
ORG.OPENOFFICE.WEEKSINYEAR
Надстройки через API для LibreOffice
Надстройки также могут применяться через API для LibreOffice.