Templates - Seção #EXTENSO#

Criada por Gustavo Vidal, Modificado em Ter, 9 Set na (o) 5:01 PM por Victoria Sbrogio

Objetivo

Permitir colocar qualquer número por extenso nos templates.

Sintaxe

#EXTENSO:X:Y:Z#NUMERO#/EXTENSO#

Onde:

X: pode ser um dos valores a seguir: M = Formatação de números no gênero masculino (dois, um, etc), F = Formatação de números no gênero feminino (uma, duas, etc) e V = Formatação de número especial com vírgula e mais de 2 casas decimais (ex.: 456,984 quatrocentos e cinquenta e seis vírgula novecentos e oitenta e quatro);
Y: Válido somente quando X = M ou F. Indica se é para a rotina de extenso retornar a palavra REIAS ou não. Os possíveis valores são: S ou N. S = Sim, N = Não;
Z: Uma sequência de palavras a serem removidas do final. Quando mais de uma palavra, separe com vírgula. Exemplo: você quer remover a palavra "centavos" do resultado final. Você deverá utilizar esse parâmetro. Confira exemplos mais abaixo;
NUMERO: O número a ser colocado por extenso. O número deve estar no seguinte formato 999.999.999,999999999 sendo que o separador de milhares não é obrigatório;

Exemplos

O João me deve #EXTENSO:M:S#100,93#/EXTENSO#.

Resultado: O João me deve cem reais e noventa e três centavos.

Eu tenho #EXTENSO:F:N#2#/EXTENSO# filhas.

Resultado: Eu tenho duas filhas.

O índice INCC no mês de outubro foi de #EXTENSO:V:S#456,876#/EXTENSO#.

Resultado: O índice INCC no mês de outubro foi de quatrocentos e cinqüenta e seis vírgula oitocentos e setenta e seis.

O João tem uma participação de #EXTENSO:M:S:centavos,reais#54,70%#/EXTENSO# por cento.

Resultado sem especificar o Z: O João tem uma participação de cinquenta e quatro reais e setenta e cinco centavos por cento (ERRADO, pois é por extenso).

Resultado COM o Z: O João tem uma participação de cinquenta e quatro e setenta e cinco (CERTO).