Funções de suplemento (add-in)

Sumário

# Funções de suplemento

Abaixo descreve-se e lista-se algumas funções de suplemento (add-in) disponíveis.

Conceito de suplemento (add-in)

Você também encontrará uma descrição da interface de suplemento (add-in) do LibreOffice Calc na Ajuda. Além disso, funções importantes e seus parâmetros são descritos na Ajuda para a biblioteca compartilhadaDLL de suplemento (add-in) do LibreOffice Calc.

## Suplemento fornecido

O LibreOffice contém exemplos para a interface dos suplementos do LibreOffice Calc.

Funções de análise - parte 1

Funções de análise - parte 2

## ANOS

Calcula a diferença em anos entre duas datas.

#### Sintaxe

ANOS(DataInicial; DataFinal; Tipo)

DataInicial é a primeira data

DataFinal é a segunda data

Tipo calcula o tipo de diferença. Valores possíveis são 0 (intervalo) e 1 (em anos de calendário).

#### Informação técnica

Esta função não faz parte do padrão Open Document Format for Office Applications (OpenDocument) Versão 1.3. Parte 4: Formato de Fórmula Recalculada (OpenFormula). O espaço de nomes é

ORG.OPENOFFICE.YEARS

Página wiki da função ANOS.

## DIASNOANO

Calcula o número de dias do ano no qual ocorre a data inserida.

#### Sintaxe

DIASNOANO(Data)

Data é qualquer data no ano respectivo. O parâmetro Data deve ser uma data válida na configuração da locale do LibreOffice.

#### Exemplo

=DIASNOANO(A1) retorna 366 dias se A1 contém 29-02-1968, uma data válida do ano de 1968.

#### Informação técnica

Esta função não faz parte do padrão Open Document Format for Office Applications (OpenDocument) Versão 1.3. Parte 4: Formato de Fórmula Recalculada (OpenFormula). O espaço de nomes é

ORG.OPENOFFICE.DAYSINYEAR

Página wiki da função DIASNOANO.

## DIASNOMÊS

Calcula o número de dias do mês no qual ocorre a data inserida.

#### Sintaxe

DIASNOMÊS(Data)

Data é qualquer data no mês respectivo do ano desejado. O parâmetro Data deve ser uma data válida de acordo com as definições da locale do LibreOffice.

#### Exemplo

=DIASNOMÊS(A1) retorna 29 dias se A1 contém 1968-02-17, uma data válida para fevereiro de 1968.

#### Informação técnica

Esta função não faz parte do padrão Open Document Format for Office Applications (OpenDocument) Versão 1.3. Parte 4: Formato de Fórmula Recalculada (OpenFormula). O espaço de nomes é

ORG.OPENOFFICE.DAYSINMONTH

Página wiki da função DIASNOMÊS.

## MESES

Calcula a diferença em meses entre duas datas.

#### Sintaxe

MESES(DataInicial; DataFinal; Tipo)

DataInicial é a primeira data

DataFinal é a segunda data

Tipo calcula o tipo de diferença. Valores possíveis são 0 (intervalo) e 1 (em meses do calendário).

#### Informação técnica

Esta função não faz parte do padrão Open Document Format for Office Applications (OpenDocument) Versão 1.3. Parte 4: Formato de Fórmula Recalculada (OpenFormula). O espaço de nomes é

ORG.OPENOFFICE.MONTHS

Página wiki da função MESES.

## ROT13

Criptografa uma cadeia de caracteres movendo os caracteres 13 posições no alfabeto. Depois da letra Z, o alfabeto começa novamente (Rotação). Ao aplicar a função de criptografia novamente ao código de resultado, você poderá descriptografar o texto.

#### Sintaxe

ROT13(Texto)

Texto é o texto a ser criptografado. ROT13(ROT13(Texto)) descriptografa o código.

#### Exemplo

=ROT13("Gur Qbphzrag Sbhaqngvba jnf sbhaqrq va Frcgrzore 2010.") retorna o texto "The Document Foundation was founded in September 2010.". Note como espaços, dígitos e pontos não são afetados pela função ROT13.

#### Informação técnica

Esta função não faz parte do padrão Open Document Format for Office Applications (OpenDocument) Versão 1.3. Parte 4: Formato de Fórmula Recalculada (OpenFormula). O espaço de nomes é

ORG.OPENOFFICE.ROT13

Consulte a página wiki ROT13 para mais detalhes.

## SEMANAS

Calcula a diferença em semanas entre duas datas.

#### Sintaxe

SEMANAS(DataInicial; DataFinal; Tipo)

DataInicial é a data inicial no intervalo.

DataFinal é a data final no intervalo. A data final deve ser maior que a data inicial, senão retorna um erro.

Tipo especifica o tipo de diferença a ser calculada. Os valores possíveis são 0 (intervalo de tempo) ou 1 (semanas do calendário).

Se Tipo = 0 a função assumirá que 7 dias é equivalente a uma semana sem considerar nenhum dia específico para marcar o início de uma semana.

Se Tipo = 1 a função considerará segunda-feira como o primeiro dia da semana. Portanto, exceto pela data de início, cada ocorrência de uma segunda-feira no intervalo é contada como uma semana adicional.

Esta função considera segunda-feira o primeiro dia da semana, independentemente das configurações de localidade atuais.

#### Exemplo

Nos exemplos a seguir, as datas são passadas como strings. No entanto, eles também podem ser armazenados em células separadas e passados como referências.

=SEMANAS("2022-01-12","2022-01-17",0) retorna 0 por que Tipo é 0 e há apenas 5 dias no intervalo.

=SEMANAS("2022-01-12","2022-01-19",0) retorna 1 por que Tipo é 0 e há 7 dias no intervalo.

=SEMANAS("2022-01-12","2022-01-17",1) retorna 1 por que Tipo é 1 e o intervalo contem uma segunda-feira, pois 2022-01-12 é uma quarta-feira e 2022-01-17 é uma segunda-feira.

=SEMANAS("2022-0-12","2022-01-15",1) retorna 0 por que Tipo é 1 e o intervalo não contém uma segunda-feira, exceto na data de início.

#### Informação técnica

Esta função não faz parte do padrão Open Document Format for Office Applications (OpenDocument) Versão 1.3. Parte 4: Formato de Fórmula Recalculada (OpenFormula). O espaço de nomes é

ORG.OPENOFFICE.WEEKS

Página wiki da função SEMANAS.

## SEMANASNOANO

Calcula o número de semanas do ano no qual ocorre a data inserida. O número de semanas é definido da seguinte forma: uma semana que se estende por dois anos é adicionada ao ano no qual ocorre a maioria dos dias dessa semana.

#### Sintaxe

SEMANASNOANO(Data)

Data é qualquer data no ano respectivo. O parâmetro Data deve ser uma data válida na configuração da locale do LibreOffice.

Seguindo a ISO 8601, esta função considera segunda-feira como o primeiro dia da semana, e a primeira semana do ano é aquela com mais dias neste ano.

#### Exemplo

SEMANASNOANO(A1) retorna 51 se A1 contém 17-02-1970, uma data válida para o ano de 1970.

#### Informação técnica

Esta função não faz parte do padrão Open Document Format for Office Applications (OpenDocument) Versão 1.3. Parte 4: Formato de Fórmula Recalculada (OpenFormula). O espaço de nomes é

ORG.OPENOFFICE.WEEKSINYEAR

Página wiki da função SEMANASNOANO.

## ÉANOBISSEXTO

Determina se o ano é um ano bissexto. Se for um ano bissexto, a função retornará o valor 1 (VERDADEIRO); se não for, retornará 0 (FALSO).

#### Sintaxe

ÉANOBISSEXTO(Data)

Data especifica se a data cai num ano bissexto. O parâmetro Data deve ser uma data válida.

O Microsoft Excel assume erroneamente o ano 1900 como ano bissexto e considera o dia inexistente de 1900-02-29 como válido nos cálculos de data. As datas anteriores a 1900-03-01 são, portanto, diferentes no Excel e no Calc.

#### Exemplo

=ÉANOBISSEXTO(A1) retorna 1, caso A1 contenha 29-02-1968, pois 29-02-1968 é uma data válida em suas definições de locale.

Utilize também =ÉANOBISSEXTO(DATA(1968;2;29)) ou ÉANOBISSEXTO("1968-02-29") sendo que a cadeia de caracteres da data deve estar na notação ISO 8601.

Nuca escreva =ÉANOBISSEXTO(29/2/1968), por que isso faria a conta de 29 dividido por 2 dividido por 1968, e calcularia então a função ÉANOBISSEXTO com esse pequeno número como número de data serial.

#### Informação técnica

Esta função não faz parte do padrão Open Document Format for Office Applications (OpenDocument) Versão 1.3. Parte 4: Formato de Fórmula Recalculada (OpenFormula). O espaço de nomes é

ORG.OPENOFFICE.ISLEAPYEAR

Página wiki da função ÉANOBISSEXTO.

## Suplemento (add-ins) através do LibreOffice API

Os suplementos também podem ser implementados através da API do LibreOffice .

Tópicos relacionados

Funções por categoria