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 Collabora Office 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 Collabora Office Calc.
Suplemento fornecido
O Collabora Office contém exemplos para a interface dos suplementos do Collabora Office Calc.
ANOS
Calcula a diferença em anos entre duas datas.
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).
ORG.OPENOFFICE.YEARS
DIASNOANO
Calcula o número de dias do ano no qual ocorre a data inserida.
DIASNOANO(Data)
Data é qualquer data no ano respectivo. O parâmetro Data deve ser uma data válida na configuração da locale do Collabora Office.
=DIASNOANO(A1) retorna 366 dias se A1 contém 29-02-1968, uma data válida do ano de 1968.
ORG.OPENOFFICE.DAYSINYEAR
DIASNOMÊS
Calcula o número de dias do mês no qual ocorre a data inserida.
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 Collabora Office.
=DIASNOMÊS(A1) retorna 29 dias se A1 contém 1968-02-17, uma data válida para fevereiro de 1968.
ORG.OPENOFFICE.DAYSINMONTH
MESES
Calcula a diferença em meses entre duas datas.
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).
ORG.OPENOFFICE.MONTHS
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.
ROT13(Texto)
Texto é o texto a ser criptografado. ROT13(ROT13(Texto)) descriptografa o código.
=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.
ORG.OPENOFFICE.ROT13
Consulte a página wiki ROT13 para mais detalhes
SEMANAS
Calcula a diferença em semanas entre duas datas.
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.
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("12/01/2022","17/01/2022",0) retorna 0 por que Tipo é 0 e há apenas 5 dias no intervalo.
=SEMANAS("12/01/2022","19/01/2022",0) retorna 1 por que Tipo é 0 e há 7 dias no intervalo.
=SEMANAS("12/01/2022","17/01/2022",1) retorna 1 por que Tipo é 1 e o intervalo contem uma segunda-feira, pois 12/01/2022 é uma quarta-feira e 17/01/2022 é uma segunda-feira.
=SEMANAS("10/01/2022","15/01/2022",1) retorna 0 por que Tipo é 1 e o intervalo não contém uma segunda-feira, exceto na data de início.
ORG.OPENOFFICE.WEEKS
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.
SEMANASNOANO(Data)
Data é qualquer data no ano respectivo. O parâmetro Data deve ser uma data válida na configuração da locale do Collabora Office.
SEMANASNOANO(A1) retorna 51 se A1 contém 17-02-1970, uma data válida para o ano de 1970.
ORG.OPENOFFICE.WEEKSINYEAR
É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).
É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.
=É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.
ORG.OPENOFFICE.ISLEAPYEAR
Suplemento (add-ins) através do Collabora Office API
Os suplementos também podem ser implementados através da API do Collabora Office .