Reemplaza todas las apariciones de un fragmento.
| Campo | Valor |
|---|---|
| Categoría | Texto |
| Tipo | Escalar (opera valor por valor) |
| Aridad | 3 argumentos (fijo) |
| Se compila a SQL (columna calculada) | Sí |
| Versión | Motor de fórmulas v3. |
Alias#
Nombre canónico: SUBSTITUIR. Alias aceptados (sin distinguir mayúsculas/minúsculas): substitute, replace.
Sintaxis#
SUBSTITUIR(expr; arg2; arg3)Todos los argumentos son expresiones.
Retorno#
Texto.
Tratamiento de nulos#
El vacío se convierte en texto vacío ("").
Contexto de evaluación#
Escalar — se evalúa sobre el resultado de los argumentos (en las columnas calculadas, se ejecuta fila por fila).
Diferencias con DAX#
- Equivalente en DAX: SUBSTITUTE
- Compatibilidad: DIFIERE de DAX — semántica diferente, atención
- Observación: Reemplaza TODAS las apariciones por contenido (como SUBSTITUTE). El alias
replaceNO es el REPLACE por posición de DAX/Excel.
Ejemplos#
SUBSTITUIR(sku; "-"; "")Ejemplo con valores#
Entrada: "A-B-C", reemplaza "-" por "".
SUBSTITUIR("A-B-C"; "-"; "") → "ABC"Resultado esperado: "ABC"
Ejemplo de negocio#
Limpiar el SKU quitando guiones antes de cruzarlo con otra base.
Errores comunes#
Errores de escritura en el nombre de una columna, un tipo incompatible o un argumento inválido se convierten en un mensaje claro (pt-BR) — el motor nunca devuelve un número incorrecto en silencio.