Calc Add-in Número Por Extenso

    From The Document Foundation Wiki

    Como funciona?

    Integração com a interface gráfica

    Após a instalação, serão acrescentadas duas novas funções para o Calc: VMPEXTENSO e VNPEXTENSO. Ambas podem ser utilizadas a partir do Assistente de Funções, na categoria Suplemento, ou digitadas diretamente pelo usuário numa célula da planilha.

    Função VMPEXTENSO

    Retorna o texto da pronúncia brasileira de um valor monetário. Recebe dois argumentos:

    num: obrigatório; é o valor monetário

    grafia: opcional; se omitido usa a vírgula na grafia, senão (qualquer valor) exclui a vírgula

    Exemplos de uso

    =VMPEXTENSO ( A10 )
    onde: A10 é a célula contendo o valor; grafa com vírgula
    =VMPEXTENSO ( B10; 1 )
    onde: B10 é a célula contendo o valor; grafa sem vírgula
    =VMPEXTENSO ( 1234,55 )
    onde: 1234,55 é o valor monetário; grafa com vírgula

    Função VNPEXTENSO

    Retorna o texto da pronúncia brasileira de um número. Recebe três argumentos:

    num: obrigatório; é o número

    unid: opcional; intervalo de células contendo a unidade e subunidade (singular e plural). Se omitido, escreve a pronúncia do número sem unidade para a parte inteira e acresce centésimo(s) para a fração. Se definido, usa a unidade / subunidade no texto.

    grafia: opcional; se omitido usa a vírgula na grafia, senão (qualquer valor) exclui a vírgula

    Exemplos de uso

    =VNPEXTENSO ( A10 )
    onde: A10 é a célula contendo o valor; grafa sem unidade e com vírgula
    =VNPEXTENSO ( B10; K1:K4 )
    onde: B10 é a célula contendo o valor
    K1:K4 é o intervalo com as unidades (por ex: metro, metros, centímetro, centímetros)
    =VNPEXTENSO ( D5; K1:K4; 1 )
    onde: D5 é a célula contendo o valor
    K1:K4 é o intervalo com as unidades (por ex: metro, metros, centímetro, centímetros)
    1 indica que a vírgula deve ser excluída da grafia

    Nota: No momento, a função VNPEXTENSO não lida com unidades terminadas com a letra a. Por exemplo, será escrito um tonelada em vez de uma tonelada.

    Usando as funções em extensões

    Após instalado, o add-in pode ser utilizado em macros e extensões. No documento de teste, veja abaixo, existem duas macros exemplificando o uso das funções.

    Download

    Extensão:Calc Add-in NumeroPorExtenso versão 0.10

    Teste:Testa Add-in NumeroPorExtenso

    Ajudando

    Você pode ajudar testando as funções no seu sistema. Para facilitar, preparei um arquivo do CALC com diversas chamadas das funções. Instale o add-in, baixe o arquivo de teste e abra-o no seu LibreOffice.

    Para contribuir com sugestões de melhoria ou informando erros, contate o autor: Noelson Duarte