Содержимое

# Функции надстроек

Ниже описываются и перечисляются некоторые имеющиеся в наличии функции надстроек.

Понятие надстройки

В Справке также можно найти описание интерфейса надстроек LibreOfficeDev Calc . Дополнительно, в Справке описываются важные функции и их параметры для Общей библиотекиDLL надстроек LibreOfficeDev Calc.

## Предоставляемые надстройки

В LibreOfficeDev содержатся примеры интерфейса надстроек в LibreOfficeDev 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 сохраняет пробелы, цифры и точки.

#### Техническая информация

Эта функция НЕ входит в стандарт Формата Open Document для офисных приложений (OpenDocument) v1.3. Часть 4: Формат пересчитываемой формулы (OpenFormula). Используемое пространство имён:

ORG.OPENOFFICE.ROT13

Более подробную информацию по этой фукнции см. на wiki-странице ROT13.

## ГОДЫ

Возвращает количество лет между двумя датами.

#### Синтаксис

ГОДЫ(Начальная дата; Конечная дата; Тип)

Начальная дата: первая дата.

Конечная дата: вторая дата.

Тип: вычисляет тип различия. Возможные значения - 0 (интервал) и 1 (в календарных годах).

#### Техническая информация

Эта функция НЕ входит в стандарт Формата Open Document для офисных приложений (OpenDocument) v1.3. Часть 4: Формат пересчитываемой формулы (OpenFormula). Используемое пространство имён:

ORG.OPENOFFICE.YEARS

Страница wiki функции ГОДЫ.

## ДНЕЙВГОДУ

Вычисляет количество дней в году, на который пришлась указанная дата.

#### Синтаксис

ДНЕЙВГОДУ(Дата)

Дата: любая дата в соответствующем году. Параметр «Дата» должен представлять собой допустимую дату в соответствии с настройками локали LibreOfficeDev.

#### Пример

=ДНЕЙВГОДУ(A1) возвращает 366 дней, если ячейка A1 содержит значение 1968-02-29, которое является допустимой датой для 1968 года.

#### Техническая информация

Эта функция НЕ входит в стандарт Формата Open Document для офисных приложений (OpenDocument) v1.3. Часть 4: Формат пересчитываемой формулы (OpenFormula). Используемое пространство имён:

ORG.OPENOFFICE.DAYSINYEAR

Страница wiki функции ДНЕЙВГОДУ.

## ДНЕЙВМЕС

Вычисление количества дней в месяце, на который пришлась указанная дата.

#### Синтаксис

ДНЕЙВМЕС(Дата)

Дата: любая дата в соответствующем месяце требуемого года. Параметр «Дата» должен представлять собой допустимую дату в соответствии с настройками локали LibreOfficeDev.

#### Пример

=ДНЕЙВМЕС(A1) возвращает 29 дней, если ячейка A1 содержит значение 1968-02-17, которое является допустимой датой для февраля 1968 года.

#### Техническая информация

Эта функция НЕ входит в стандарт Формата Open Document для офисных приложений (OpenDocument) v1.3. Часть 4: Формат пересчитываемой формулы (OpenFormula). Используемое пространство имён:

ORG.OPENOFFICE.DAYSINMONTH

Страница wiki функции ДНЕЙВМЕС.

## ЕВИСОКОСНЫЙ

Служит для определения високосного года. Если год високосный, то функция возвращает значение 1 (ИСТИНА); в противном случае возвращается значение 0 (ЛОЖЬ).

#### Синтаксис

ЕВИСОКОСНЫЙ(Дата)

Дата: указывает попадает ли заданная дата на високосный год. Параметр «Дата» должен содержать допустимую дату.

Microsoft Excel неверно причисляет 1900 год к числу високосных и при вычислении даты рассматривает несуществующий день 1900-02-29 в качестве допустимого. Поэтому даты до 1900-03-01 в Excel и Calc будут отличатся.

#### Пример

=ЕВИСОКОСНЫЙ(A1) возвращает значение 1, если ячейка A1 содержит значение 1968-02-29, поскольку дата 29 февраля 1968 допустима при выбранных параметрах языка.

Также можно использовать =ЕВИСОКОСНЫЙ(ДАТА(1968;2;29)) или =ЕВИСОКОСНЫЙ("1968-02-29") с передачей строки даты в нотации ISO 8601.

Не следует использовать запись =ЕВИСОКОСНЫЙ(2/29/68), поскольку в данном случае сначала будет выполнено вычисление аргумента, где 2 будет поделено на 29 и на 68, после чего функция ЕВИСОКОСНЫЙ будет использовать полученное малое число в качестве даты в числовом формате.

#### Техническая информация

Эта функция НЕ входит в стандарт Формата Open Document для офисных приложений (OpenDocument) v1.3. Часть 4: Формат пересчитываемой формулы (OpenFormula). Используемое пространство имён:

ORG.OPENOFFICE.ISLEAPYEAR

Страница wiki функции ЕВИСОКОСНЫЙ.

## МЕСЯЦЫ

Возвращает количество месяцев между двумя датами.

#### Синтаксис

МЕСЯЦЫ(Начальная дата; Конечная дата; Тип)

Начальная дата: первая дата.

Конечная дата: вторая дата.

Тип: вычисляет тип различия. Возможные значения включают 0 (интервал) и 1 (в календарных месяцах).

#### Техническая информация

Эта функция НЕ входит в стандарт Формата Open Document для офисных приложений (OpenDocument) v1.3. Часть 4: Формат пересчитываемой формулы (OpenFormula). Используемое пространство имён:

ORG.OPENOFFICE.MONTHS

Страница wiki функции МЕСЯЦЫ.

## НЕДЕЛИ

Возвращает количество недель между двумя датами.

#### Синтаксис

НЕДЕЛИ(Начальная дата; Конечная дата; Тип)

Начальная дата: начальная дата интервала.

Конечная дата: конечная дата интервала. Конечная дата должна быть больше начальной даты, в противном случае возвращается ошибка.

Тип: указывает на тип вычисляемой разницы. Возможны значения: 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, а интервал не включает понедельники, за исключением начальной даты.

#### Техническая информация

Эта функция НЕ входит в стандарт Формата Open Document для офисных приложений (OpenDocument) v1.3. Часть 4: Формат пересчитываемой формулы (OpenFormula). Используемое пространство имён:

ORG.OPENOFFICE.WEEKS

Страницы wiki функции НЕДЕЛИ.

## НЕДЕЛЬВГОДУ

Вычисляет количество недель в году, на который пришлась указанная дата.Количество недель определяется следующим образом: неделя, выпадающая на два года, прибавляется к году, к которому относится большее число дней этой недели.

#### Синтаксис

НЕДЕЛЬВГОДУ(Дата)

Дата: любая дата в соответствующем году. Параметр «Дата» должен представлять собой допустимую дату в соответствии с настройками локали LibreOfficeDev.

Согласно ISO 8601, эта функция считает понедельник первым днём недели, а первой неделей года считается та, которая имеет большую часть дней в данном году.

#### Пример

НЕДЕЛЬВГОДУ(A1) возвращает значение 53, если ячейка A1 содержит значение 1970-02-17, которое является допустимой датой для 1970 года.

#### Техническая информация

Эта функция НЕ входит в стандарт Формата Open Document для офисных приложений (OpenDocument) v1.3. Часть 4: Формат пересчитываемой формулы (OpenFormula). Используемое пространство имён:

ORG.OPENOFFICE.WEEKSINYEAR

Страница wiki функции НЕДЕЛЬВГОДУ.

## Надстройки через API для LibreOfficeDev

Надстройки также могут применяться через API для LibreOfficeDev.

См. также

Функции по категориям

Пожалуйста, поддержите нас!