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 LibreOfficeDev Calc na Ajuda. Além disso, funções importantes e seus parâmetros são descritos na Ajuda para a de suplemento (add-in) do LibreOfficeDev Calc.

Suplemento fornecido

O LibreOfficeDev contém exemplos para a interface dos suplementos do LibreOfficeDev 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

tip

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 LibreOfficeDev.

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

tip

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 LibreOfficeDev.

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

tip

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

tip

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

tip

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.

note

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.

=WEEKS("2022-01-12","2022-01-17",0) returns 0 because Type was set to 0 and there are only 5 days in the interval.

=WEEKS("2022-01-12","2022-01-19",0) returns 1 because Type was set to 0 and there are 7 days in the interval.

=WEEKS("2022-01-12","2022-01-17",1) returns 1 because Type was set to 1 and the interval contains a Monday, since 2022-01-12 is a Wednesday and 2022-01-17 is a Monday.

=WEEKS("2022-01-12","2022-01-15",1) returns 0 because Type was set to 1 and the interval does not contain any Mondays, except for the start date.

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

tip

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 LibreOfficeDev.

note

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

tip

É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.

warning

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

tip

Suplemento (add-ins) através do LibreOfficeDev API

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