La función Join combina elementos de array en una sola cadena usando un delimitador especificado. Es la operación inversa de Split y es muy útil para salida y formato de datos.
Sintaxis básica
Join(array, [delimitador])
Parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| array | Array (Variant) | Sí | Un array unidimensional a unir |
| delimitador | String | No | El delimitador (predeterminado espacio) |
Valor de retorno
Una cadena combinada (tipo String)
Uso básico
Unión simple
Sub JoinEjemploBasico()
Dim frutas() As Variant
Dim resultado As String
' Definir array
frutas = Array("manzana", "banana", "naranja")
' Unir con coma
resultado = Join(frutas, ",")
Debug.Print resultado ' manzana,banana,naranja
' Unir con espacio
resultado = Join(frutas, " ")
Debug.Print resultado ' manzana banana naranja
' Unir con saltos de línea
resultado = Join(frutas, vbCrLf)
Debug.Print resultado
' Salida:
' manzana
' banana
' naranja
End Sub
Omitir el delimitador
Sub JoinDelimitadorPredeterminado()
Dim palabras() As Variant
Dim oracion As String
palabras = Array("Hola", "Mundo", "desde", "VBA")
' Omitir delimitador (une con espacio)
oracion = Join(palabras)
Debug.Print oracion ' Hola Mundo desde VBA
End Sub
Consejo
Cuando omites el delimitador, los elementos se unen con un espacio (” ”). Si pasas explícitamente
una cadena vacía (""), los elementos se unen sin separador.
Ejemplos prácticos
Construir cláusula SQL IN
Function ConstruirClausulaIN(valores As Variant) As String
Dim valoresComillas() As String
Dim i As Long
ReDim valoresComillas(LBound(valores) To UBound(valores))
For i = LBound(valores) To UBound(valores)
valoresComillas(i) = "'" & valores(i) & "'"
Next i
ConstruirClausulaIN = "(" & Join(valoresComillas, ", ") & ")"
End Function
Sub ProbarConstruirSQL()
Dim ciudades As Variant
ciudades = Array("Madrid", "Barcelona", "Valencia")
Debug.Print "SELECT * FROM usuarios WHERE ciudad IN " & ConstruirClausulaIN(ciudades)
' Salida: SELECT * FROM usuarios WHERE ciudad IN ('Madrid', 'Barcelona', 'Valencia')
End Sub
Precaución
Si usas IDs de texto en una cláusula IN, encierra cada elemento entre comillas simples. Además, concatenar entradas del usuario directamente en SQL facilita la inyección SQL; en producción usa consultas parametrizadas.
Crear listas HTML
Function CrearListaHTML(items As Variant) As String
Dim elementosLista() As String
Dim i As Long
ReDim elementosLista(LBound(items) To UBound(items))
For i = LBound(items) To UBound(items)
elementosLista(i) = " <li>" & items(i) & "</li>"
Next i
CrearListaHTML = "<ul>" & vbCrLf & Join(elementosLista, vbCrLf) & vbCrLf & "</ul>"
End Function
Sub ProbarListaHTML()
Dim frutas As Variant
frutas = Array("Manzana", "Banana", "Naranja")
Debug.Print CrearListaHTML(frutas)
' Salida:
' <ul>
' <li>Manzana</li>
' <li>Banana</li>
' <li>Naranja</li>
' </ul>
End Sub
Construir rutas de archivo
Function ConstruirRuta(ParamArray partesRuta() As Variant) As String
ConstruirRuta = Join(partesRuta, "\")
End Function
Sub ProbarConstruirRuta()
Dim rutaCompleta As String
rutaCompleta = ConstruirRuta("C:", "Usuarios", "Juan", "Documentos", "informe.xlsx")
Debug.Print rutaCompleta ' C:\Usuarios\Juan\Documentos\informe.xlsx
End Sub
Crear informes formateados
Sub CrearInforme()
Dim lineasInforme() As String
Dim i As Long
ReDim lineasInforme(0 To 5)
lineasInforme(0) = "=== Informe de Ventas ==="
lineasInforme(1) = "Fecha: " & Format(Date, "yyyy-mm-dd")
lineasInforme(2) = ""
lineasInforme(3) = "Ventas Totales: $" & Format(12345.67, "#,##0.00")
lineasInforme(4) = "Artículos Vendidos: 150"
lineasInforme(5) = "======================="
' Unir con saltos de línea para mostrar
MsgBox Join(lineasInforme, vbCrLf), vbInformation, "Informe"
End Sub
Arrays que Join no admite
Join solo acepta arrays unidimensionales. En estos casos se produce un error:
- Pasar un array bidimensional (como
Range("A1:C3").Value) → error en tiempo de ejecución 5 (Llamada a procedimiento o argumento no válido) - Pasar un array de un tipo distinto de
StringoVariant(por ejemploLong()) → error 13 (No coinciden los tipos) - Algún elemento es
Null→ error 94 (Uso no válido de Null)
Sub JoinRangeRow()
Dim v As Variant
Dim arr() As Variant
Dim c As Long
v = Range("A1:C1").Value
ReDim arr(0 To UBound(v, 2) - 1)
For c = 1 To UBound(v, 2)
arr(c - 1) = v(1, c)
Next c
Debug.Print Join(arr, ",")
End Sub
チェック
En Excel 2019 o posterior y Microsoft 365, la función de hoja TEXTJOIN une un rango de celdas
directamente. Desde VBA: Application.WorksheetFunction.TextJoin(",", True, Range("A1:C1")).
Resumen
La función Join es el complemento de Split para manipulación de cadenas en VBA:
- Combina elementos de array con un delimitador especificado
- Predeterminado a espacio cuando se omite el delimitador
- Perfecta para crear datos CSV, cláusulas SQL, HTML e informes
- Funciona bien con Split para flujos de transformación de datos
- Esencial para construir salida formateada desde arrays
Domina Join junto con Split para capacidades completas de manipulación de cadenas en tus proyectos VBA.