Aprenda a usar osformatadores de variáveispara exibir informações no formato que você precisa em seus documentos ou modelos. Os formatadores permitem transformar como um valor é exibido (sem alterar o dado original), por exemplo, converter números em palavras ou modificar o formato de uma data.
O que são os formatadores?
Os formatadores (antes chamados de “filtros”) são usados paratransformar variáveis existentes, modificando como são exibidas dentro dos seus documentos ou comunicações.
Eles são aplicados escrevendo uma barra vertical (|) após o nome da variável, seguida do formatador que você deseja usar. Veja um exemplo:
{{ finiquito.monto | palabras }}Transfere o valor numérico do montante em palavras.
Formatadores disponíveis
A seguir, listamos os formatadores para adicionar após a barra vertical (|).
📝 palavras
Converte uma variável numérica ou do tipo data para sua versão por extenso. Se a variável não for numérica nem do tipo data, não realiza nenhuma transformação.
{{ finiquito.monto | palabras }}🖼️ imagem
Exibe uma imagem a partir do seu caminho. É usado principalmente comatributos personalizados do tipo arquivoque contenham imagens.
{{ empresa.logo | imagen: "200", "100" }}O primeiro valor corresponde àlargurae o segundo àaltura(em pixels).
📅 formato_data
Permite exibir uma data no formato que você precisar.
{{ fecha_de_hoy | formato_fecha: "yyyy-mm-dd" }}Atributos disponíveis:
-
yyyy→ Ano completo (2020) -
mm→ Mês numérico (07) -
dd→ Dia do mês (31) -
hh→ Hora (16) -
MM→ Minutos (59) -
ss→ Segundos (59)
Separadores disponíveis: /,-ou espaço.
🧩 detalhe_data
Obtém um elemento específico de uma data (dia, mês ou ano).
{{ fecha_de_hoy | detalle_fecha: "M" }}Parâmetros disponíveis:
-
"A"→ Ano -
"M"→ Mês -
"D"→ Dia
Se não for usado corretamente, retorna um valor vazio.
📖 data_por_extenso
Transforma uma data em sua versão escrita por extenso.
{{ fecha_de_hoy | fecha_en_palabras: "%A %d de %B de %Y" }}Formatos disponíveis:
-
%A→ Dia da semana -
%d→ Dia numérico -
%b→ Abreviação do mês -
%B→ Nome completo do mês -
%Y→ Ano completo -
%y→ Dois últimos dígitos do ano
Exemplo de resultado:
Se a data for30/03/2020, o resultado será:
Segunda-feira, 30 de março de 2020
⏳ data_n_meses_no_futuro
Retorna a data no formato01/mm/yyyysomando N meses ao valor original.
{{ fecha_de_hoy | fecha_n_meses_al_futuro: "3" }}Exibe a data três meses após a data atual.
🔢 remove_zero
Remove os decimais “.0” de um número.
{{ empleado.horas_semanales | remove_zero }}Se o valor original for “40.0”, exibirá “40”.
💰 valor_com_formato
Exibe o valor com formato de moeda ($ ###.###).
{{ empleado.total_descuentos_ultima_liquidacion | monto_con_formato }}Resultado: $ 1.234.567
💬 valor_com_decimais_por_extenso
Converte um valor numérico em palavras, incluindo os decimais como fração (x/100).
{{ empleado.total_liquidacion | monto_con_decimales_a_palabras }}Se o valor for
1534.50, exibirá “mil quinhentos e trinta e quatro com 50/100”.
🔠 converter_para_maiusculas
Converte o texto para maiúsculas.
{{ empleado.nombre_completo | convertir_a_mayusculas }}Se o nome for “Ana Pérez”, exibirá “ANA PÉREZ”.
📊 formato_numero
Aplica formato numérico com separador de milhar (.) e dois decimais separados por vírgula (,).
{{ 1000000 | formato_numero }}Resultado: 1.000.000,00
Considerações importantes
- Se o formatador não for usado corretamente, a variável será exibidasem modificações.
- Você podecombinar formatadoresem uma mesma variável:
{{ finiquito.monto | remove_zero | monto_con_formato }}- Os formatadores afetam apenas aforma como o valor é exibido, não modificam o dado original na base.
💡Ainda tem dúvidas?
Se este artigo não responder completamente à sua dúvida ou se precisar de apoio em um caso específico, nossa equipe está disponível através dos canais de atendimento.
Chat | Telefone | E-mail
🎓Tem interesse em se certificar na Buk?
Convidamos você a fazer um curso de seu interesse na Buk Academy, onde encontrará conteúdos guiados para aprofundar o uso da plataforma e fortalecer seus conhecimentos.
🤖 Este artigo foi traduzido com inteligência artificial. Ver artigo original.