Aprende a usar los formateadores de variables para mostrar información con el formato que necesites en tus documentos o plantillas. Los formateadores te permiten transformar cómo se ve un valor (sin cambiar el dato original), por ejemplo convertir números a palabras o modificar el formato de una fecha.
¿Qué son los formateadores?
Los formateadores (antes llamados “filtros”) se utilizan para transformar variables existentes, modificando cómo se muestran dentro de tus documentos o comunicaciones.
Se aplican escribiendo una barra vertical (|) después del nombre de la variable, seguida del formateador que deseas usar, a continuación te dejamos un ejemplo:
{{ finiquito.monto | palabras }}Transfiere el valor numérico del monto en palabras.
Formateadores disponibles
A continuación te dejamos los formateadores a agregar después de la barra vertical (|).
📝 palabras
Convierte una variable numérica o de tipo fecha a su versión en palabras. Si la variable no es numérica ni de tipo fecha, no realiza ninguna transformación.
{{ finiquito.monto | palabras }}🖼️ imagen
Muestra una imagen a partir de su ruta. Se usa principalmente con atributos personalizados de tipo archivo que contengan imágenes.
{{ empresa.logo | imagen: "200", "100" }}El primer valor corresponde al ancho y el segundo al alto (en píxeles).
📅 formato_fecha
Permite mostrar una fecha en el formato que necesites.
{{ fecha_de_hoy | formato_fecha: "yyyy-mm-dd" }}Atributos disponibles:
yyyy→ Año completo (2020)mm→ Mes numérico (07)dd→ Día del mes (31)hh→ Hora (16)MM→ Minutos (59)ss→ Segundos (59)
Separadores disponibles: /, - o espacio.
🧩 detalle_fecha
Obtiene un elemento específico de una fecha (día, mes o año).
{{ fecha_de_hoy | detalle_fecha: "M" }}Parámetros disponibles:
"A"→ Año"M"→ Mes"D"→ Día
Si no se usa correctamente, devuelve un valor vacío.
📖 fecha_en_palabras
Transforma una fecha a una versión escrita en palabras.
{{ fecha_de_hoy | fecha_en_palabras: "%A %d de %B de %Y" }}Formatos disponibles:
%A→ Día de la semana%d→ Día numérico%b→ Abreviatura del mes%B→ Nombre completo del mes%Y→ Año completo%y→ Últimos dos dígitos del año
Ejemplo de resultado:
Si la fecha es 30/03/2020, el resultado será:
Lunes 30 de marzo de 2020
⏳ fecha_n_meses_al_futuro
Entrega la fecha en formato 01/mm/yyyy sumando N meses al valor original.
{{ fecha_de_hoy | fecha_n_meses_al_futuro: "3" }}Muestra la fecha tres meses después de la fecha actual.
🔢 remove_zero
Elimina los decimales “.0” de un número.
{{ empleado.horas_semanales | remove_zero }}Si el valor original es “40.0”, mostrará “40”.
💰 monto_con_formato
Muestra el monto con formato de moneda ($ ###.###).
{{ empleado.total_descuentos_ultima_liquidacion | monto_con_formato }}Resultado: $ 1.234.567
💬 monto_con_decimales_a_palabras
Convierte un monto numérico a palabras, incluyendo los decimales como fracción (x/100).
{{ empleado.total_liquidacion | monto_con_decimales_a_palabras }}Si el valor es
1534.50, mostrará “mil quinientos treinta y cuatro con 50/100”.
🔠 convertir_a_mayusculas
Convierte el texto a mayúsculas.
{{ empleado.nombre_completo | convertir_a_mayusculas }}Si el nombre es “Ana Pérez”, mostrará “ANA PÉREZ”.
📊 formato_numero
Da formato numérico con separador de miles (.) y dos decimales separados por coma (,).
{{ 1000000 | formato_numero }}Resultado: 1.000.000,00
Consideraciones importantes
- Si el formateador no se usa correctamente, la variable se mostrará sin modificaciones.
- Puedes combinar formateadores en una misma variable:
{{ finiquito.monto | remove_zero | monto_con_formato }}- Los formateadores afectan solo la forma en que se muestra el valor, no modifican el dato original en la base.
💡¿Aún tienes dudas?
Si este artículo no responde completamente tu consulta o necesitas apoyo en un caso particular, nuestro equipo está disponible a través de los canales de atención.
Chat | Teléfono | Correo
🎓 ¿Te interesa certificarte en Buk?
Te invitamos a realizar un curso de tu interés en Buk Academy, donde encontrarás contenidos guiados para profundizar en el uso de la plataforma y fortalecer tus conocimientos.