Lista de funciones

Acerca de las funciones

La herramienta de edición de consultas le permite utilizar funciones avanzadas para realizar filtrados complejos. Para ello, la paleta herramientas contiene el elemento Expression que puede utilizar en el espacio de trabajo. Encontrará más información sobre este elemento en una sección específica.

Este elemento le permite introducir las condiciones manualmente. Aquí puede utilizar las funciones definidas en las siguientes secciones.

Existen varios tipos de funciones disponibles, según los resultados deseados y los tipos de datos manipulados:

  • Fechas
  • Geomarketing
  • Valores numéricos
  • Otras funciones
  • Agregados
  • Manipulación de cadenas
  • Ordenar
NOTA

Hay funciones adicionales disponibles en todas las actividades que permiten utilizar variables de eventos después de llamar a un flujo de trabajo con parámetros externos. Se detallan en esta sección.

Fechas

Las funciones de fecha se utilizan para manipular los valores de fecha y hora.

Nombre
Descripción
Syntax
AddDays
Agrega un número de días a una fecha
AddDays(<fecha>, <número>)
AddHours
Agrega un número de horas a una fecha
AddHours(<fecha>, <número>)
AddMinutes
Añade un número de minutos a una fecha
AddMinutes(<fecha>, <número>)
AddMonths
Añade un número de meses a una fecha
AddMonths(<fecha>, <número>)
AddSeconds
Añade un número de segundos a una fecha
AddSeconds(<fecha>, <número>)
AddYears
Agrega un número de años a una fecha
AddYears(<fecha>, <número>)
DateOnly
Devuelve solo la fecha (con hora 00:00)
DateOnly(<fecha>)
Day
Devuelve el número que representa el día de la fecha.
Day(<fecha>)
DayOfYear
Devuelve un número que representa el día del año de la fecha
DayOfYear(<fecha>)
DaysAgo
Devuelve la fecha actual menos N días
DaysAgo(<número>)
DaysAgoInt
Devuelve la fecha actual menos N días (como un entero aaaammdd)
DaysAgoInt(<número>)
DaysDiff
Número de días entre dos fechas
DaysDiff(<fecha de finalización>, <fecha de inicio>)
DaysOld
Devuelve la edad en días de una fecha
DaysOld(<fecha>)
GetDate
Devuelve la fecha del sistema actual del servidor
GetDate()
Hour
Devuelve la hora de la fecha
Hour(<fecha>)
HoursDiff
Devuelve el número de horas entre dos fechas
HoursDiff(<fecha de finalización>, <fecha de inicio>)
LocalToUTC
Convierte una fecha y hora locales a UTC
LocalToUTC(<fecha>, <zona horaria>)
Minute
Devuelve los minutos de la fecha
Minute(<fecha>)
MinutesDiff
Devuelve el número de minutos entre dos fechas
MinutesDiff(<fecha de finalización>, <fecha de inicio>)
Month
Devuelve el número que representa el mes de la fecha
Month(<fecha>)
MonthsAgo
Devuelve la fecha correspondiente a la fecha actual menos n meses
MonthsAgo(<número>)
MonthsDiff
Devuelve el número de meses entre dos fechas
MonthsDiff(<fecha de finalización>, <fecha de inicio>)
MonthsOld
Devuelve la edad en meses de una fecha
MonthsOld(<fecha>)
Second
Devuelve los segundos de la fecha
Second(<fecha>)
Oldest
Devuelve la fecha más antigua Oldest(<Fecha>, <Fecha>)
SecondsDiff
Devuelve el número de segundos entre dos fechas
SecondsDiff(<fecha de finalización>, <fecha de inicio>)
SubDays
Resta un número de días a partir de una fecha
SubDays(<fecha>, <número>)
SubHours
Resta un número de horas a partir de una fecha
SubHours(<fecha>, <número>)
SubMinutes
Resta un número de minutos desde una fecha
SubMinutes(<fecha>, <número>)
SubMonths
Resta un número de meses desde una fecha
SubMonths(<fecha>, <número>)
SubSeconds
Resta un número de segundos desde una fecha
SubSeconds(<fecha>, <número>)
SubYears
Resta un número de años a partir de una fecha
SubYears(<fecha>, <número>)
ToDate
Convierte una fecha y hora como fecha
ToDate(<fecha + hora>)
ToDateTime
Convierte una cadena en una fecha + hora.
ToDateTime(<cadena>)
ToDateTimeWithTimezone
Convierte una cadena en una fecha + huso horario.
Ejemplo: ToDateTimeWithTimezone ("2019-02-19 08:09:00", "Asia/Teherán")
ToDateTimeWithTimezone(<cadena>)
TruncDate
Redondea una fecha y hora hacia el segundo más cercano
TruncDate(@lastModified, <número de segundos>)
TruncDateTZ
Redondea una fecha y hora con una precisión determinada expresada en segundos
TruncDateTZ(<fecha>, <número de segundos>, <zona horaria>)
TruncQuarter
Redondea una fecha al trimestre
TruncQuarter(<fecha>)
TruncTime
Redondea la parte de tiempo hasta el segundo más cercano
TruncTime(<fecha>, <número de segundos>)
TruncWeek
Redondea una fecha a la semana
TruncWeek(<fecha>)
TruncYear
Redondea una fecha y hora al 1 de enero del año
TruncYear(<fecha>)
WeekDay
Devuelve el número que representa el día de la semana de la fecha
WeekDay(<fecha>)
Year
Devuelve el número que representa el año de la fecha
Year(<fecha>)
YearAndMonth
Devuelve el número que representa el año y el mes de la fecha
YearAndMonth(<fecha>)
YearsDiff
Devuelve el número de años entre las dos fechas
YearsDiff(<fecha de finalización>, <fecha de inicio>)
YearsOld
Devuelve la edad en años de una fecha
YearsOld(<fecha>)

Geomarketing

Las funciones de geomarketing se utilizan para manipular los valores geográficos.

Nombre
Descripción
Sintaxis
Distance
Devuelve la distancia en kilómetros entre dos puntos definidos por su longitud y latitud (expresada en grados)
Distance(<Longitud A>, <Latitud A>, <Longitud B>, <Latitud B>)

Numérico

Las funciones de valores numéricos se utilizan para convertir texto en números.

Nombre
Descripción
Sintaxis
Abs
Devuelve el valor absoluto de un número
Abs(<número>)
Ceil
Devuelve el menor entero que sea mayor o igual que un número
Ceil(<número>)
Floor
Devuelve el mayor entero que sea menor o igual que un número
Floor(<número>)
Greatest
Devuelve el número mayor de dos números
Greatest(<número 1>, <número 2>)
Least
Devuelve el número menor de dos números
Least(<número 1>, <número 2>)
Mod
Devuelve el resto de la división del entero de n1 entre n2
Mod(<número 1>, <número 2>)
Percent
Devuelve la proporción de dos números expresado como un porcentaje
Percent(<número 1>, <número 2>)
Aleatorio
Devuelve un valor aleatorio
Aleatorio()
Round
Redondea un número a “n” decimales
Redondeo(<número>, <número de decimales>)
Sign
Devuelve el signo del número
Sign(<número>)
ToDouble
Convierte un entero en flotante
ToDouble(<número>)
ToInt64
Convierte un flotante en un entero de 64 bits
ToInt64(<número>)
ToInteger
Convierte un flotante en un entero
ToInteger(<número>)
Trunc
Trunca decimales de “n1” a “n2”
Trunc(<n1>, <n2>)

Otros

Esta tabla contiene las funciones restantes disponibles.

Nombre
Descripción
Sintaxis
Case
Devuelve el valor 1 si la condición está verificada. De lo contrario, devuelve el valor 2
Case(When(<condición>, <valor 1>), Else(<valor 2>))
ClearBit
Elimina el indicador del valor
ClearBit(<identificador>, <indicador>)
Coalesce
Devuelve el valor 2 si el valor 1 es cero o nulo, de lo contrario devuelve el valor 1
Coalesce(<valor 1>, <valor 2>)
Decode
Devuelve el valor 3 si el valor 1 = valor 2; en caso contrario, devuelve el valor 4
Decode(<valor 1>, <valor 2>, <valor 3>, <valor 4>)
Else
Devuelve el valor 1 (solo puede utilizarse como parámetro de la función case)
Else(<valor 1>)
GetEmailDomain
Extrae el dominio de una dirección de correo electrónico
GetEmailDomain(<valor>)
GetMirrorURL
Recupera la URL del servidor de la página espejo
GetMirrorURL(<valor>)
Iif
Devuelve el valor 1 si la expresión es verdadera; en caso contrario, devuelve el valor 2
Iif(<condición>, <valor 1>, <valor 2>)
IsBitSet
Indica si el indicador se encuentra en el valor
IsBitSet(<identificador>, <indicador>)
IsEmptyString
Devuelve el valor 2 si la cadena está vacía; en caso contrario, devuelve el valor 3
IsEmptyString(<cadena>, <valor 2>, <valor 3>)
NoNull
Devuelve la cadena vacía si el argumento es NULL
NoNull(<valor>)
RowId
Devuelve el número de línea
RowId
SetBit
Fuerza la marca en el valor
SetBit(<identificador>, <indicador>)
ToBoolean
Convierte un número en Boolean
ToBoolean(<número>)
When
Devuelve el valor 1 si la expresión está verificada. De lo contrario, devuelve el valor 2 (solo puede utilizarse como parámetro de la función case)
When(<condición>, <valor 1>)
newUUID
Devuelve un UUID nuevo.
newUUID

Cadena

Las funciones de cadena se utilizan para manipular un conjunto de cadenas.

Nombre
Descripción
Sintaxis
AllNonNull2
Indica si todos los parámetros no son nulos y no están vacíos.
AllNonNull2(<cadena>, <cadena>)
AllNonNull3
Indica si todos los parámetros no son nulos y no están vacíos.
AllNonNull3(<cadena>, <cadena>, <cadena>)
ASCII
Devuelve el valor ASCII del primer carácter de la cadena
Ascii(<cadena>)
Char
Devuelve el carácter correspondiente al código ASCII “n”.
Char(<número>)
Charindex
Devuelve la posición de la cadena 2 en la cadena 1
Charindex(<cadena>, <cadena>)
DataLength
Devuelve el número de caracteres de una cadena
DataLength(<Cadena>)
GetLine
Muestra la línea nth (de 1 a n) de la cadena.
GetLine(<cadena>)
IfEquals
Devuelve el tercer parámetro si los dos primeros parámetros son iguales; de lo contrario, devuelve el último parámetro
IfEquals(<cadena>, <cadena>, <cadena>, <cadena>)
IsMemoNull
Indica si la nota transferida como parámetro es nula
IsMemoNull(<Memo>)
JuxtWords
Concatena las dos cadenas pasadas como parámetros. Se agrega un espacio entre cada cadena en el valor devuelto.
JuxtWords(<cadena>, <cadena>)
JuxtWords3
Concatena las tres cadenas pasadas como parámetros. Se agrega un espacio entre cada cadena en el valor devuelto.
JuxtWords3(<cadena>, <cadena>, <cadena>)
LPad
Devuelve la cadena completa a la izquierda
LPad(<cadena>, <número>, <carácter>)
Left
Devuelve los primeros “n” caracteres de la cadena
Left(<cadena>, <número>)
Length
Devuelve la longitud de la cadena
Length(<cadena>)
Lower
Devuelve la cadena en minúscula
Lower(<cadena>)
Ltrim
Elimina los espacios a la izquierda de la cadena
Ltrim(<cadena>)
Md5Digest
Devuelve una representación hexadecimal de la clave MD5 de una cadena
Md5Digest(<cadena>)
MemoContains
Especifica si la nota contiene la cadena transferida como parámetro
MemoContains(<Memo>, <cadena>)
RPad
Devuelve la cadena completa a la derecha
RPad(<cadena>, <número>, <carácter>)
Replace
Reemplaza todas las ocurrencias de un valor de cadena especificado (segundo parámetro) con otro valor de cadena (tercer parámetro) en una cadena (primer parámetro)
Replace(<cadena>, <cadena>, <cadena>)
Right
Devuelve los últimos “n” caracteres de la cadena
Right(<cadena>)
Rtrim
Elimina los espacios a la derecha de la cadena
Rtrim(<cadena>)
Sha256Digest
Calcula el hash SHA256 estándar para una cadena UTF8 determinada
Sha256Digest(<cadena>)
Sha384Digest
Calcula el hash SHA384 estándar para una cadena UTF8 determinada
Sha384Digest(<cadena>)
Sha512Digest
Calcula el hash SHA512 estándar para una cadena UTF8 determinada
Sha512Digest(<cadena>)
Smart
Devuelve la cadena con la primera letra de cada palabra en mayúscula
Smart(<cadena>)
Substring
Extrae la subcadena que comienza en el carácter n1 de la cadena con una longitud de n2
Substring(<cadena>, <desajuste>, <longitud>)
ToIntlString
Convierte el número en una cadena
ToIntlString(<número>)
ToString
Convierte el número en una cadena
ToString(<número>)
Upper
Devuelve la cadena en mayúsculas
Upper(<cadena>)
VirtualLink
Devuelve la clave externa de un vínculo transferido como parámetro si los otros dos parámetros son iguales
VirtualLink(<número>, <número>, <número>)
VirtualLinkStr
Devuelve la clave externa (texto) de un enlace transferido como parámetro si los otros dos parámetros son iguales
VirtualLinkStr(<cadena>, <número>, <número>)
encryption_aescbcDecrypt
Descifra un valor cifrado en formato HEX con el prefijo “x” (primer parámetro) utilizando una clave en formato HEX (segundo parámetro) y un vector de inicialización en formato HEX (tercer parámetro)
encryption_aescbcDecrypt(<cadena>, <cadena>, <cadena>)
encryption_aescbcEncrypt
Codifica utilizando el algoritmo AES (modo de bloque CBC) una cadena de caracteres (primer parámetro) con una clave (segundo parámetro) y un vector de inicialización (tercer parámetro). La clave y el vector de inicialización deben proporcionarse en una representación hexadecimal (comenzando por \x). El resultado será hexadecimal sin \x.
Tenga en cuenta que el tamaño de la clave puede ser de 128 bits, 192 bits, 256 bits (16, 24, 32 caracteres hexadecimales), pero le recomendamos que utilice 256 bits y una IV aleatoria de la misma longitud que la clave.
encryption_aescbcEncrypt(<string>, <string>, <string>)
Por ejemplo: encryption_aescbcEncrypt(johndoe@example.com, "\\x0123456789ABCDEF0123456789ABCDEF", "\\x0123456789ABCDEFFEDCBA9876543210")

Agregados

Las funciones de agregación solo están disponibles cuando se agregan datos adicionales desde la actividad Query de un flujo de trabajo.

Las funciones agregadas se utilizan para realizar cálculos en un conjunto de valores.

Nombre
Descripción
Sintaxis
Avg, Average
Devuelve el promedio en una columna numérica.
Avg(<valor>)
Count, Count (except NULL)
Cuenta los valores no nulos en una columna.
Count(<valor>)
CountAll, Count all
Cuenta todos los valores (incluidos los valores nulos y duplicados).
CountAll()
Countdistinct, Distinct count
Cuenta los distintos valores no nulos en una columna.
Countdistinct(<valor>)
Max, Max
Devuelve el valor máximo de una columna numérica, de cadena o de fecha.
Max(<valor>)
Min, Min
Devuelve el valor mínimo de una columna numérica, de cadena o de fecha.
Min(<valor>)
StringAgg, acumulado de cadenas
Devuelve la concatenación de los valores de una columna de tipo cadena, separados por el carácter del segundo argumento (el separador predeterminado es una coma).
StringAgg(<string values="">,<separator>)
Sum, Sum
Devuelve la suma de los valores de una columna numérica.
Sum(<valor>)

Representación

Las funciones de representación se utilizan para ordenar valores.

Nombre
Descripción
Sintaxis
Desc
Aplica un orden descendente
Desc(<valor 1>)
OrderBy
Ordena el resultado dentro de la partición
OrderBy(<valor 1>)
PartitionBy
Particiona el resultado de una consulta en una tabla
PartitionBy(<valor 1>)
RowNum
Genera un número de línea basado en la partición de tabla y en una secuencia de ordenación. Esta función no es compatible con MySQL
RowNum(PartitionBy(<valor 1>), OrderBy(<valor 1>))

En esta página