Editar expresiones

Última actualización: 11 de abril de 2025

La edición de una expresión implica la introducción manual de condiciones para formar una regla. Este modo permite utilizar funciones avanzadas, que permiten manipular los valores utilizados para llevar a cabo consultas específicas, como la manipulación de fechas, cadenas, campos numéricos y ordenación.

IMPORTANT
La sección siguiente proporciona información sobre cómo trabajar con el editor de expresiones para generar reglas. Tenga en cuenta que la sintaxis utilizada para generar reglas difiere de la utilizada para agregar personalización.

Trabajo con el editor de expresiones

El editor de expresiones está disponible en el botón del modelador de consultas Editar expresión, disponible para los campos Atributo y Valor al configurar una condición personalizada.

Acceso desde el campo AtributoAcceso desde el campo Value
Editor de expresiones para el campo de atributos Editor de expresiones para el campo Valor

El editor de expresiones proporciona lo siguiente:

  • Un campo de entrada (1) donde se define la expresión.
  • Una lista de campos (2) disponibles que se pueden usar en la expresión y que corresponden a la dimensión de segmentación de la consulta.
  • Funciones de ayuda (3), ordenadas por categoría.

Edite la expresión introduciendo una expresión directamente en el campo de entrada. Para añadir un campo o una función de ayuda, coloque el cursor en la expresión donde desee añadirla y haga clic en el botón +.

Interfaz del editor de expresiones

Cuando la expresión esté lista, haga clic en el botón Confirmar. La expresión se muestra en el campo seleccionado. Para editarlo, abra el editor de expresiones y realice los cambios deseados.

El ejemplo siguiente muestra una expresión configurada para el campo Value. Para editarlo, abra el editor de expresiones con el botón Editar expresión.

Ejemplo de expresión de edición para el campo Valor

Funciones de ayuda

La herramienta de edición de consultas le permite utilizar funciones avanzadas para realizar filtros complejos según los resultados deseados y los tipos de datos manipulados. Estas son las funciones disponibles:

Agregado

Las funciones agregadas realizan cálculos en un conjunto de valores.

NombreDescripciónSintaxis
AvgDevuelve el promedio de una columna de tipo numéricoAvg(<value>)
RecuentoCuenta los valores no nulos de una columnaCount(<value>)
CountAllCuenta los valores devueltos (todos los campos)CountAll()
CountdistinctCuenta los distintos valores no nulos de una columnaCountdistinct(<value>)
MaxDevuelve el valor máximo de una columna numérica, cadena o tipo de fechaMax(<value>)
MinDevuelve el valor mínimo de una columna de número, cadena o tipo de fechaMin(<value>)
StdDevDevuelve la desviación estándar de una columna de número, cadena o fechaStdDev(<value>)
StringAggDevuelve la concatenación de los valores de una columna de tipo de cadena, separados por el carácter del segundo argumentoStringAgg(<Valor>, <Cadena>)
SumDevuelve la suma de los valores de una columna de número, cadena o fecha.Sum(<value>)

Fecha

Las funciones de fecha manipulan los valores de fecha y hora.

NombreDescripciónSintaxis
AddDaysAgrega un número de días a una fechaAddDays(<date>, <number>)
AddHoursAgrega un número de horas a una fechaAddHours(<date>, <number>)
AddMinutesAñade un número de minutos a una fechaAddMinutes(<date>, <number>)
AddMonthsAñade un número de meses a una fechaAddMonths(<date>, <number>)
AddSecondsAñade un número de segundos a una fechaAddSeconds(<date>, <number>)
AddYearsAgrega un número de años a una fechaAddYears(<date>, <number>)
ConvertNTZConvierte la marca de tiempo NTZ (marca de tiempo sin zona horaria) en TZ (marca de tiempo con zona horaria) aplicando la TZ de sesión definidaConvertNTZ(<fecha+hora>)
DateCmpCompara dos fechasDateCmp(<fecha>, <fecha>)
DateOnlyDevuelve solo la fecha (con hora 00:00)DateOnly(<date>)
DíaDevuelve el número que representa el día de la fecha.Day(<date>)
DayOfYearDevuelve el número de día del año de la fechaDayOfYear(<date>)
DaysAgoDevuelve la fecha correspondiente a la fecha actual menos “n” díasDaysAgo(<number>)
DaysAgoIntDevuelve la fecha (entero aaaammdd) correspondiente a la fecha actual menos “n” díasDaysAgoInt(<number>)
DaysDiffDevuelve el número de días entre dos fechasDaysDiff(<end date>, <start date>)
DaysOldDevuelve la edad en días de una fechaDaysOld(<date>)
GetDateDevuelve la fecha del sistema actual del servidorGetDate()
HoraDevuelve la hora de la fechaHour(<date>)
HoursDiffDevuelve el número de horas entre dos fechasHoursDiff(<end date>, <start date>)
MinutoDevuelve los minutos de la fechaMinute(<date>)
MinutesDiffDevuelve el número de minutos entre dos fechasMinutesDiff(<end date>, <start date>)
MesDevuelve el número que representa el mes de la fechaMonth(<date>)
MonthsAgoDevuelve la fecha correspondiente a la fecha actual menos n mesesMonthsAgo(<number>)
MonthsDiffDevuelve el número de meses entre dos fechasMonthsDiff(<end date>, <start date>)
MonthsOldDevuelve la edad en meses de una fechaMonthsOld(<date>)
OldestDevuelve la fecha más antigua de un intervaloOldest(<fecha, fecha>)
SecondDevuelve los segundos de la fechaSecond(<date>)
SecondsDiffDevuelve el número de segundos entre dos fechasSecondsDiff(<end date>, <start date>)
SubDaysResta un número de días a partir de una fechaSubDays(<date>, <number>)
SubHoursResta un número de horas a partir de una fechaSubHours(<date>, <number>)
SubMinutosResta un número de minutos desde una fechaSubMinutes(<date>, <number>)
SubMesesResta un número de meses desde una fechaSubMonths(<date>, <number>)
SubSegundosResta un número de segundos desde una fechaSubSeconds(<date>, <number>)
SubAñosResta un número de años a partir de una fechaSubYears(<date>, <number>)
ToDateConvierte una fecha y hora como fechaToDate(<date + time>)
ToDateTimeConvierte una cadena en una fecha + hora.ToDateTime(<string>)
ToTimestampConvierte una cadena en una marca de tiempoToTimestamp(<cadena>)
ToTimeZoneConvierte una fecha y hora en una zona horariaToTimeZone(<fecha>, <zona horaria>)
TruncDateRedondea una fecha y hora al segundo más cercanoTruncDate(@lastModified, <number of seconds>)
TruncDateTZRedondea una fecha y hora con una precisión determinada expresada en segundosTruncDateTZ(<date>, <number of seconds>, <time zone>)
TruncQuarterRedondea una fecha al trimestreTruncQuarter(<date>)
TruncTimeRedondea la parte de tiempo hasta el segundo más cercanoTruncTime(<date>, <number of seconds>)
TruncWeekRedondea una fecha a la semanaTruncWeek(<date>)
TruncYearRedondea una fecha y hora al 1 de enero del añoTruncYear(<date>)
WeekDayDevuelve un número que representa el día de la semana de la fecha (0=lunes, 6=domingo)WeekDay(<date>)
AñoDevuelve el número que representa el año de la fechaYear(<date>)
AñoYMesDevuelve el número que representa el año y el mes de la fechaYearAndMonth(<date>)
YearsAgoDevuelve el número de años entre una fecha determinada y la fecha actualYearsAgo(<fecha>)
YearsDiffDevuelve el número de años entre dos fechasYearsDiff(<end date>, <start date>)
YearsOldDevuelve la edad en años de una fechaYearsOld(<date>)
NOTE
Tenga en cuenta que la función DateOnly tiene en cuenta la zona horaria del servidor, no la del operador.

Geomarketing

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

NombreDescripciónSyntax
DistanceDevuelve la distancia entre dos puntos definidos por su longitud y latitud, expresada en gradosDistance(<Longitude A>, <Latitude A>, <Longitude B>, <Latitude B>)

Numérico

Las funciones numéricas se utilizan para convertir texto en números.

NombreDescripciónSyntax
AbsDevuelve el valor absoluto de un númeroAbs(<número>)
CeilDevuelve el menor entero que sea mayor o igual que un númeroCeil(<número>)
FloorDevuelve el mayor entero que sea mayor o igual que un númeroFloor(<number>)
GreatestDevuelve el número mayor de dos númerosGreatest(<número 1>, <número 2>)
LeastDevuelve el número menor de dos númerosLeast(<número 1>, <número 2>)
ModDevuelve el resto de la división del entero “n1” entre “n2”Mod(<number 1>, <number 2>)
PercentDevuelve la proporción de dos números expresado como un porcentajePercent(<número 1>, <número 2>)
AleatorioDevuelve un valor aleatorioAleatorio()
RoundRedondea un número a “n” decimalesRedondeo(<número>, <número de decimales>)
SignDevuelve el signo del númeroSign(<número>)
ToDoubleConvierte un entero en flotanteToDouble(<número>)
ToInt64Convierte un flotante en un entero de 64 bitsToInt64(<número>)
ToIntegerConvierte un flotante en un enteroToInteger(<número>)
TruncTrunca decimales de “n1” a “n2”Trunc(<n1>, <n2>)

Otros

Esta tabla contiene las funciones restantes disponibles.

NombreDescripciónSyntax
AESEncryptCifrar la cadena proporcionada en el argumentoAESEncrypt(<valor>)
CaseDevuelve el valor 1 si la condición es verdadera. Si no es así, devuelve el valor 2.Case(When(<condition>, <value 1>), Else(<value 2>))
ClearBitElimina el indicador del valorClearBit(<identificador>, <indicador>)
CoalesceDevuelve el valor 2 si el valor 1 es cero o nulo, de lo contrario devuelve el valor 1Coalesce(<valor 1>, <valor 2>)
DecodeDevuelve el valor 3 si el valor 1 = valor 2. Si no devuelve el valor 4.Decode(<value 1>, <value 2>, <value 3>, <value 4>)
ElseDevuelve el valor 1 (solo puede utilizarse como parámetro de la función case)Else(<value 1>, <value 2>)
GetEmailDomainExtrae el dominio de una dirección de correo electrónicoGetEmailDomain(<valor>)
GetMirrorURLRecupera la URL del servidor de la página espejoGetMirrorURL(<valor>)
IifDevuelve el valor 1 si la expresión es verdadera. Si no es así, devuelve el valor 2Iif(<condition>, <value 1>, <value 2>)
IsBitSetIndica si el indicador se encuentra en el valorIsBitSet(<identificador>, <indicador>)
IsEmptyStringDevuelve el valor 2 si la cadena 1 está vacía; en caso contrario, devuelve el valor 3IsEmptyString(<value 1>, <value 2>, <value 3>)
NuevoUUIDDevuelve un identificador únicoNewUUID()
NoNullDevuelve la cadena vacía si el argumento es NULLNoNull(<valor>)
RowIdDevuelve el número de líneaRowId
SetBitFuerza la marca en el valorSetBit(<identificador>, <indicador>)
ToBooleanConvierte un número en BooleanToBoolean(<número>)
WhenDevuelve el valor 1 si la expresión es verdadera. Si no es así, devuelve el valor 2 (solo puede utilizarse como parámetro de la función case)When(<condition>, <value 1>)

Cadena

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

NombreDescripciónSyntax
AllNonNull2Indica si todos los parámetros no son nulos y no están vacíos.AllNonNull2(<string>, <string>)
AllNonNull3Indica si todos los parámetros no son nulos y no están vacíos.AllNonNull3(<string>, <string>, <string>)
AsciiDevuelve el valor ASCII del primer carácter de la cadena.Ascii(<string>)
CharDevuelve el carácter correspondiente al código ASCII “n”.Char(<number>)
CharindexDevuelve la posición de la cadena 2 en la cadena 1.Charindex(<string>, <string>)
dataLengthDevuelve el tamaño en bytes de la cadenadataLength(<string>)
GetLineMuestra la línea nth (de 1 a n) de la cadena.GetLine(<string>)
IfEqualsDevuelve el tercer parámetro si los dos primeros parámetros son iguales. Si no es así, devuelve el último parámetroIfEquals(<string>, <string>, <string>, <string>)
IsMemoNullIndica si la nota transferida como parámetro es nulaIsMemoNull(<memo>)
JuxtWordsConcatena las cadenas transferidas como parámetros. Añade espacios entre las cadenas si es necesario.JuxtWords(<string>, <string>)
JuxtWords3Concatena las cadenas transferidas como parámetros. Añade espacios entre las cadenas si es necesarioJuxtWords3(<string>, <string>, <string>)
LeftDevuelve los primeros “n” caracteres de la cadenaLeft(<string>, <number>)
LengthDevuelve la longitud de la cadenaLength(<string>)
LíneaExtraer línea n de la cadenaLine(<string>,<number>)
LowerDevuelve la cadena en minúsculaLower(<cadena>)
LPadDevuelve la cadena completa a la izquierdaLPad (<Cadena>, <Número>, <Carácter>)
LtrimElimina los espacios a la izquierda de la cadenaLtrim(<string>)
Md5DigestDevuelve una representación hexadecimal de la clave MD5 de una cadenaMd5Digest(<string>)
MemoContainsEspecifica si la nota contiene la cadena transferida como parámetroMemoContains(<memo>, <cadena>)
ValorNodoExtrae el valor de un campo XML de su XPath y de los datos de campoNodeValue (<String>, <String>)
ReplaceReemplaza todas las apariciones de un valor de cadena especificado por otro valor de cadena.Replace(<cadena>,<cadena>,<cadena>)
RightDevuelve los últimos “n” caracteres de la cadenaRight(<cadena>)
RPadDevuelve la cadena completa a la derechaRPad(<cadena>, <número>, <carácter>)
RtrimElimina los espacios a la derecha de la cadenaRtrim(<cadena>)
Sha256DigestRepresentación hexadecimal de la clave SHA256 de una cadena.Sha256Digest (<cadena>)
Sha512DigestRepresentación hexadecimal de la clave SHA512 de una cadena.Sha512Digest (<cadena>)
SmartDevuelve la cadena con la primera letra de cada palabra en mayúsculaSmart(<cadena>)
SubstringExtrae la subcadena que comienza en el carácter “n1” de la cadena y de longitud “n2”Substring(<string>, <offset>, <length>)
ToStringConvierte el número en una cadenaToString(<number>, <number>)
UpperDevuelve la cadena en mayúsculasUpper(<cadena>)
VirtualLinkDevuelve la clave externa de un vínculo transferido como parámetro si los otros dos parámetros son igualesVirtualLink(<número>, <número>, <número>)
VirtualLinkStrDevuelve la clave externa (texto) de un enlace transferido como parámetro si los otros dos parámetros son igualesVirtualLinkStr(<cadena>, <número>, <número>)