Cuando comience a crear sus propias métricas y atributos personalizados, con frecuencia usará funciones que le ayudan a realizar comparaciones, cálculos y manipulaciones de la información de su negocio.
Explore ofrece muchas funciones para ayudarle a trabajar con, por ejemplo, fechas, cadenas de texto, cálculos y más. Este artículo sirve de referencia para ayudarle a descubrir las funciones que tiene a su disposición y cómo usarlas.
En este artículo se tratan los siguientes temas:
Primeros pasos
Al crear una métrica o atributo calculado estándar, se pueden buscar y seleccionar funciones. En la ventana de edición de fórmulas, puede comenzar a escribir el nombre de una función o hacer clic en Agregar bajo Funciones y elegir una función de la lista.
Cuando la función es agregada a una fórmula, aparece con los valores estándar. Estos se tienen que reemplazar con los valores que se desean usar en la fórmula. En este ejemplo, el objetivo es devolver solo los tickets que tengan líneas de asunto que comiencen con "[Marcado]".
- En el menú de cálculos (
), haga clic en Atributo calculado estándar. - Póngale un nombre. En este ejemplo se usa El asunto comienza con [Marcado].
- Bajo Funciones, haga clic en Agregar.
- En la ventana de la fórmula, escriba IF.
- Bajo Funciones, haga clic en Agregar.
- Busque LEFTPART. Utilice el cuadro de búsqueda, haga clic en Filtrar para incluir los valores hasta la categoría Texto, o desplácese por la lista hasta encontrar la función que desee.
- Junto a LEFTPART, haga clic en +.
- Ahora verá la fórmula IF LEFTPART(_text,_number). Cambie el parámetro _text al atributo Asunto del ticket. Resalte _text y luego elija Asunto del ticket en el menú Campos, o bien corrija la fórmula manualmente para agregar el atributo.
La fórmula ahora dirá IF LEFTPART([Asunto del ticket],_number)
- Cambie el _number del texto al número de caracteres que desea comparar. [Marcado] tiene nueve caracteres, así que ingrese 9.
La fórmula ahora dirá IF LEFTPART([Asunto del ticket],_9)
- Por último, agregue la condición que estamos buscando; en este caso, el texto "[Marcado]". La fórmula final dirá:
IF LEFTPART([Asunto del ticket],9)="[Marcado]" THEN [ID del ticket] ENDIF
Ahora, cuando use este atributo en su informe, devolverá solo los tickets que tengan una línea de asunto que comience con "[Marcado]".
Si desea más ayuda y ejemplos, consulte Escritura de fórmulas de Explore.
Operadores matemáticos básicos
Además de las funciones anteriores, también se pueden usar los siguientes operadores matemáticos básicos para realizar cálculos y conectar texto:
| Operador | Descripción |
| + | Agregar dos valores numéricos, o unir dos cadenas de texto |
| - | Sustraer un valor de otro |
| * | Multiplicar dos valores |
| / | Dividir un valor entre otro |
| = | Probar si un valor es igual a otro valor |
| != | Probar si un valor no es igual a otro valor |
| > |
Probar si el primer valor es mayor que el siguiente valor (x>y) |
| < |
Probar si el primer valor es menor que el siguiente valor (x<y) |
| >= |
Probar si el primer valor es mayor o igual que el siguiente valor (x>y) |
| <= |
Probar si el primer valor es menor o igual que el siguiente valor (x<=y) |
| % | Calcula el resto después de dividir un valor entre otro Ejemplo: 5%2 devuelve 1, 20%3 devuelve 2 |
Funciones lógicas
Estas funciones dan gran flexibilidad para analizar y presentar la información exactamente como se desea.
| Función | Descripción |
| Expresión condicional IF THEN ELSE | Permite evaluar los valores lógicos. Formato: IF (condición) THEN (valor si verdadero) ELSE (valor si falso) ENDIF Si desea información a fondo sobre esta función, consulte Uso de la función IF THEN ELSE. |
| AND | Devuelve TRUE si las dos expresiones proporcionadas son TRUE. Ejemplo: IF ([Canal del ticket]="Correo electrónico") AND ([Correo electrónico del remitente]="fred@fredco.com") THEN [ID del ticket] ENDIF Devuelve todos los tickets que se recibieron por correo electrónico desde fred@freedco.com. |
| OR | Devuelve TRUE si por lo menos una de las expresiones proporcionadas es TRUE. Ejemplo: IF ([Canal del ticket]="Correo electrónico") OR ([Canal del ticket]="Voz") THEN [ID del ticket] ENDIF Devuelve todos los tickets que se recibieron a través de los canales de correo electrónico o voz. |
| NOT | Invierte el valor lógico de la expresión proporcionada. Ejemplo: IF NOT([Canal del ticket]="Correo electrónico") THEN [ID del ticket] ENDIF Devuelve todos los tickets que no se recibieron a través del canal de correo electrónico. |
| TRUE | Devuelve el valor lógico "TRUE". |
| FALSE | Devuelve el valor lógico "FALSE". |
| IN(_param,_array) | Devuelve TRUE si el primer parámetro especificado se encuentra en la matriz especificada en el segundo parámetro. Ejemplos: IN(200,ARRAY(100,200,300,400)) devuelve TRUE IN(250,ARRAY(20,40,60,80)) devuelve FALSE |
| Expresión condicional SWITCH | SWITCH proporciona una alternativa más fácil de comprender que las declaraciones IF THEN ELSE que tienen muchas ramas. SWITCH (_tested_element) { CASE _value1: _return_value CASE _value2: _return_value DEFAULT: _default_return_value } Si desea información a fondo sobre esta función, consulte Adición de varias expresiones condicionales con SWITCH. |
Funciones de atributos
Estas funciones permiten realizar operaciones básicas para cuantificar el número de atributos devueltos por un informe. También se pueden realizar operaciones más avanzadas para “fijar” o extender el nivel de agregación de los cálculos.
| Función | Descripción |
| COUNT_VALUES(_attribute) | Cuenta el número de valores del atributo proporcionado. Se incluyen los valores repetidos. Se puede usar como una condición en las métricas y atributos calculados, pero no se puede utilizar en la cláusula THEN de una métrica calculada. Ejemplo: IF COUNT_VALUES([ID del ticket])>30 THEN 1 ELSE 0 ENDIF El ejemplo de arriba devuelve 1 cuando hay más de 30 tickets, y 0 cuando hay menos de 30.
Sugerencia: Si desea crear una métrica que cuente el número de los valores de un atributo, la fórmula de la métrica sería simplemente [Atributo]. Luego puede aplicar el agregador COUNT como se hace normalmente.
|
| DCOUNT_VALUES(_attribute) | Cuenta el número específico de los distintos valores del atributo proporcionado. Se puede usar como una condición en las métricas y atributos calculados, pero no se puede utilizar en la cláusula THEN de una métrica calculada. Ejemplo: IF COUNT_VALUES([Nombre de organización])>100 THEN 1 ELSE 0 ENDIF El ejemplo de arriba devuelve 1 cuando hay más de 100 organizaciones únicas, y 0 cuando hay menos de 100.
Sugerencia: Si desea crear una métrica que cuente el número de valores únicos de un atributo, la fórmula de la métrica sería simplemente [Atributo]. Luego puede aplicar el agregador D_COUNT como se hace normalmente.
|
| ATTRIBUTE_FIX(agregador(nombre de métrica), atributo1, atributo2) |
Devuelve el valor de agregador(nombre de métrica) agregado en función de los atributos especificados (en este ejemplo atributo1 y atributo2). Ningún otro atributo puede afectar los resultados de esta métrica. Los atributos calculados no se pueden usar dentro de la función ATTRIBUTE_FIX. Ejemplo: ATTRIBUTE_FIX(MED(Tiempo de primera respuesta (min), [Ticket creado - Año], [Ticket creado - Mes) Si desea más ayuda y ejemplos, consulte Trabajar con las funciones de nivel de agregación. |
| ATTRIBUTE_ADD(agregador(nombre de métrica), atributo1, atributo2) |
Devuelve el valor de agregador(nombre de métrica) agregado en función de todos los atributos del informe, además de atributo1 y atributo2. Los atributos calculados no se pueden usar dentro de la función ATTRIBUTE_ADD. Ejemplo: ATTRIBUTE_ADD(MED(Tiempo de primera respuesta (min), [Ticket creado - Año], [Ticket creado - Mes]) Si desea más ayuda y ejemplos, consulte Trabajar con las funciones de nivel de agregación. |
Funciones de etiquetas
Estas funciones ayudan a verificar si las etiquetas están presentes o ausentes. Esto puede incluir etiquetas de tickets, etiquetas de llamadas, o cualquier otra cosa que use etiquetas.
| Función | Descripción |
| INCLUDES_ALL([atributo de etiqueta], "etiqueta1", "etiqueta2") | Devuelve TRUE si todas las etiquetas especificadas se incluyen en el atributo de etiqueta. Ejemplos: INCLUDES_ALL([Etiquetas de ticket], "Londres", "Milán") devuelve TRUE si un ticket contiene las etiquetas "Londres" y "Milán". NOT INCLUDES_ALL ([Etiquetas de ticket], "Londres", "Milán") devuelve TRUE si un ticket no contiene ambas etiquetas "Londres" y "Milán". Si desea ver más ejemplos de cómo se usa esta función, consulte Uso de etiquetas en la generación de informes. |
| INCLUDES_ANY([atributo de etiqueta], "etiqueta1", "etiqueta2") | Devuelve TRUE si cualquiera de las etiquetas especificadas se incluyen en el atributo de etiqueta. Ejemplos: INCLUDES_ANY([Etiquetas de ticket], "Londres", "Milán") devuelve TRUE si un ticket contiene las etiquetas "Londres" o "Milán". NOT INCLUDES_ANY ([Etiquetas de ticket], "Londres", "Milán") devuelve TRUE si un ticket no contiene ninguna de las dos etiquetas "Londres" o "Milán". Si desea ver más ejemplos de cómo se usa esta función, consulte Uso de etiquetas en la generación de informes. |
Funciones de texto
Estas funciones le permiten realizar operaciones que buscan y evalúan texto. También puede modificar el texto usando fórmulas y patrones creados por usted.
Si desea ver ejemplos de cómo usar algunas de estas funciones de texto (como CONTAINS, LEFTPART, SUBSTR, FIND y LENGTH), consulte Receta de Explore: Informes sobre campos desplegables anidados.
| Función | Descripción |
| CONTAINS(_text,_text_to_search) | Devuelve TRUE si el primer parámetro especificado contiene el segundo como subcadena. Ejemplo: CONTAINS([Nombre de remitente],"Sandra")
|
| ENDSWITH(_text,_text_to_search) | Devuelve TRUE si el primer texto proporcionado termina con el segundo texto proporcionado. Ejemplo: ENDSWITH([Estado de EE.UU.],"ippi") devuelve TRUE para Mississippi, pero FALSE para Delaware. |
| FIND(_text,_text_to_find,_number_start_index) |
Devuelve el índice, en el primer texto especificado, de la primera instancia del segundo texto especificado (desde el startIndex especificado). Devuelve -1 si no se encuentra el segundo texto especificado. El índice del primer carácter de una cadena es 0. Ejemplos: Si [Modo de envío]="Urgent" entonces FIND([ShipMode","Norm",0) devuelve -1 Si [Modo de envío]="Normal" entonces FIND([ShipMode","ma",0) devuelve 3 Si [Modo de envío]="Urgent" entonces FIND([ShipMode","ge",2) devuelve 0 |
| LEFTPART(_text,_number) | Devuelve el _number de caracteres del texto proporcionado, empezando por la izquierda. Ejemplo: Si [Departamento]="Documentación técnica" entonces LEFTPART([Departamento],9) devuelve "Documenta" |
| LENGTH(_text) | Devuelve la longitud (número de caracteres) del texto proporcionado. Ejemplo: LENGTH([Categoría de producto]) devuelve la longitud de cada valor del atributo Categoría de producto. |
| LOWERCASE(_text) | Convierte y devuelve el texto proporcionado en minúscula. |
| LTRIM(_text) | Devuelve el valor del atributo proporcionado con los espacios en blanco de la izquierda eliminados. Ejemplo: LTRIM([Name]) devolvería "Pedro " si [Nombre] es " Pedro " |
| REPLACE(_text,_text_to_replace,_text_to_replace_with) | Devuelve una copia de _text en la cual todas las instancias de _text_to_replace han sido reemplazadas por _text_to_replace_with. Ejemplo: IF [Estado de EE.UU.]="nueva York" entonces REPLACE([Estado de EE.UU.],"n","N") devuelve "Nueva York" |
| RIGHTPART(_text,_number) | Devuelve el _number de caracteres del texto proporcionado, empezando por la derecha. Ejemplo: Si [Departamento]="Documentación técnica" entonces RIGHTPART([Departamento],13) devuelve "técnica" |
| RTRIM(_text) | Devuelve el valor del atributo proporcionado con los espacios en blanco de la derecha eliminados. Ejemplo: RTRIM([Nombre]) devolvería " Pedro" si [Nombre] es " Pedro " |
| STARTSWITH(_text,_text_to_search) | Devuelve TRUE si el primer texto proporcionado comienza con el segundo texto proporcionado. Ejemplo: STARTSWITH([Estado de EE.UU.],"Miss") devuelve TRUE para Mississippi, pero FALSE para Delaware. |
| IS_POSITIVE(_text) | Analiza el texto y devuelve el valor TRUE si es un número positivo y FALSE si es un número negativo. |
| SUBSTR(_text,_number_start_index,_number_end_index) |
Devuelve la parte de _text formado por el carácter especificado por startIndex (el primer entero especificado) y todos los caracteres hasta endIndex-1 (el segundo entero especificado). Ejemplo: SUBSTR("Web marketing",0,3) devuelve "Web" |
| TRIM(_text) | Devuelve el valor del atributo proporcionado con los espacios en blanco de la izquierda y derecha eliminados. Ejemplo: TRIM([Nombre]) devolvería "Pedro" si [Nombre] es " Pedro ". |
| UPPERCASE(_text) | Convierte y devuelve el texto proporcionado en mayúsculas. |
| STRING(_number) | Convierte el número proporcionado en una cadena. |
| LPAD(_text,_length,_pad) | Rellena el texto a la izquierda de _text con _pad hasta que la cadena tenga _length. Ejemplo: LPAD("1",7,"?") devuelve "??????1" |
| RPAD(_text,_length,_pad) | Rellena el texto a la derecha de _text con _pad hasta que la cadena tenga _length. Ejemplo: RPAD("1",7,"?") devuelve "1??????" |
| LINK(_url,_label) | Devuelve un vínculo de HTML que apunta al URL proporcionado. Si desea ver un ejemplo, consulte Receta de Explore: Configurar vínculos a tickets en los que se puede hacer clic. |
Funciones regex
Una expresión regular (a veces conocida como regex o regexp) es una secuencia de caracteres que definen un patrón de búsqueda. Explore admite el uso de expresiones regulares para realizar los siguientes cálculos en las fórmulas:
| Función | Descripción |
| REGEXP_MATCH(_text,_regexp) | Devuelve TRUE si el texto coincide con la expresión regular. |
| REGEXP_EXTRACT(_text,_regexp) | Devuelve la parte del texto que coincide con el grupo de captura en la expresión regular. Si desea ver un ejemplo de cómo usar esta función, consulte ¿Puedo informar sobre el dominio de correo electrónico del usuario en Explore? |
| REGEXP_REPLACE(_text,_regexp,_replace_text) | Devuelve una cadena donde cualquier subcadena de texto que coincida con la expresión regular se sustituye por replace_text. Ejemplo: REGEXP_REPLACE("Hello","lo","p") devuelve "Help" |
Si desea más información sobre las expresiones regulares, consulte esta página de Wikipedia.
Funciones de fecha
Explore permite crear, comparar y realizar cálculos de las fechas y horas. Estas funciones son especialmente útiles porque lo más probable es que pase mucho tiempo examinando la información de su compañía durante un intervalo de fechas seleccionado.
| Función | Descripción |
| DATE(_text) | Convierte el texto ingresado en una fecha con una marca de tiempo UTC. El texto especificado puede adoptar distintos formatos, pero debe incluir por lo menos el mes, el día y el año. Ejemplos:
|
| DATE_EQUAL(_date,_date) | Devuelve TRUE si las dos fechas especificadas son iguales. Ejemplo: IF DATE_EQUAL([Ticket creado - Mes],[Ticket resuelto - Mes]) THEN [ID del ticket] ENDIF Devuelve todos los tickets que se resolvieron en el mismo mes en que fueron creados. El año no está incluido en este ejemplo, de modo que devolvería un ticket que fue creado en junio de 2018 y resuelto en junio de 2020. |
| DATE_NOT_EQUAL(_date,_date) | Devuelve TRUE si las dos fechas especificadas no son iguales. Ejemplo: IF DATE_EQUAL([Ticket creado - Mes],[Ticket resuelto - Mes]) THEN [ID del ticket] ENDIF Devuelve todos los tickets que no se resolvieron en el mismo mes en que fueron creados. |
| DATE_LESS(_date,_date) | Devuelve TRUE si la primera fecha es anterior a la segunda. Ejemplo: IF DATE_LESS([Ticket asignado - Fecha],[Vencimiento del ticket - Fecha - Fecha]) THEN [ID del ticket] ENDIF Devuelve todos los tickets asignados antes de la fecha de vencimiento. |
| DATE_LESS_OR_EQUAL(_date,_date) | Devuelve TRUE si la primera fecha es anterior o igual a la segunda. Ejemplo: IF DATE_LESS_OR_EQUAL([Ticket asignado - Fecha],[Vencimiento del ticket - Fecha - Fecha]) THEN [ID del ticket] ENDIF Devuelve todos los tickets asignados antes de la fecha de vencimiento o en la misma fecha. |
| DATE_GREATER(_date,_date) | Devuelve TRUE si la primera fecha es posterior a la segunda. Ejemplo: IF DATE_GREATER([Ticket asignado - Fecha],[Vencimiento del ticket - Fecha - Fecha]) THEN [ID del ticket] ENDIF Devuelve todos los tickets asignados después de la fecha de vencimiento. |
| DATE_GREATER_OR_EQUAL(_date,_date) | Devuelve TRUE si la primera fecha es posterior o igual a la segunda. Ejemplo: IF DATE_GREATER_OR_EQUAL([Ticket asignado - Fecha],[Vencimiento del ticket - Fecha - Fecha]) THEN [ID del ticket] ENDIF Devuelve todos los tickets asignados después de la fecha de vencimiento o en la misma fecha. |
| DATE_ADD(_date,_date_part,_increment) |
Devuelve la fecha dada usando la zona horaria del usuario y actualizada con el incremento especificado. El parámetro _date_part podría ser, por ejemplo, “year”, “quarter”, “month”, “day”, “hour”, etc. El incremento especificado debe ser un valor entero, pero puede ser negativo. |
| DATE_DIFF(_date,_date,_date_part) | Devuelve la diferencia relativa o exacta entre dos fechas en el formato seleccionado. En la función _date_part puede ser uno de los siguientes: Para diferencias relativas (números enteros):
Para valores exactos:
Ejemplos: DATE_DIFF("2011/10/22","2008/01/06","year") devuelve 3 (2011-2008) DATE_DIFF("2011/10/22","2008/01/06","nb_of_years") devuelve 4 (cantidad real de años) DATE_DIFF("2019/03/06","2019/03/05","day") devuelve 1 DATE_DIFF("2019/03/06","2017/03/05","nb_of_days") devuelve 731 |
| DATE_FORMAT(_date,_format) | Devuelve la fecha especificada usando la zona horaria del usuario en el formato proporcionado. Si desea ver una lista de formatos que se pueden usar, consulte Formato de fechas. |
| TODAY() | Devuelve la fecha actual en la zona horaria del usuario. |
| NOW() | Devuelve la fecha y hora actuales en la zona horaria del usuario (en horas, minutos y segundos). |
| CURRENT_YEAR() | Devuelve el año en curso. |
| CURRENT_HALFYEAR() | Devuelve el semestre actual en forma de texto, como "S1" o "S2". |
| CURRENT_QUARTER() | Devuelve el trimestre actual en forma de texto, como "T1", "T2", "T3" o "T4". |
| CURRENT_MONTH() | Devuelve el mes actual (por ejemplo, "enero", "febrero"). |
| CURRENT_MONTH_NUMERIC() | Devuelve el mes actual en forma de número (por ejemplo, "1" para enero, "2" para febrero). |
| CURRENT_DAY() | Devuelve el día actual en forma de número. |
| CURRENT_WEEKDAY() | Devuelve el día de la semana actual en forma de texto (por ejemplo, "lunes", "martes"). |
| CURRENT_WEEKDAY_NUMERIC() | Devuelve el día de la semana actual en forma de número (por ejemplo, "0" para domingo, "1" para lunes). |
| CURRENT_HOUR() | Devuelve la hora actual en la zona horaria del usuario y en forma de número. |
| CURRENT_MINUTE() | Devuelve el minuto actual en la zona horaria del usuario y en forma de número. |
| CURRENT_SECOND() | Devuelve el segundo actual en la zona horaria del usuario y en forma de número. |
| YEAR(_date) | Devuelve el año de la fecha proporcionada. |
| MONTH(_date) | Devuelve el mes de la fecha proporcionada en forma de texto (por ejemplo, "enero", "febrero"). |
| MONTH_NUMERIC(_date) | Devuelve el mes de la fecha proporcionada en forma de número (por ejemplo, "1" para enero, "2" para febrero). |
| DAY(_date) | Devuelve el día de la fecha proporcionada. |
| WEEKDAY(_date) | Devuelve el día de la fecha proporcionada en forma de cadena (por ejemplo, "lunes", "martes"). |
| WEEKDAY_NUMERIC(_date) | Devuelve el día de la fecha proporcionada en forma de número (por ejemplo, "1" para domingo, "2" para lunes). |
| HOURS(_date) | Devuelve la hora de la fecha proporcionada. |
| MINUTES(_date) | Devuelve el minuto de la fecha proporcionada. |
| SECONDS(_date) | Devuelve el segundo de la fecha proporcionada. |
| WEEK_NUMBER(_date) | Devuelve el número de la semana asociado con la fecha proporcionada. Consulte Comprender cómo el inicio de semana afecta los números de las semanas. |
| WEEK_NUMBER_MONDAY(_date) | Devuelve el número de la semana asociado con la fecha proporcionada, para las semanas que empiezan en lunes. |
| WEEK_NUMBER_FRIDAY(_date) | Devuelve el número de la semana asociado con la fecha proporcionada, para las semanas que empiezan en viernes. |
| WEEK_NUMBER_SATURDAY(_date) | Devuelve el número de la semana asociado con la fecha proporcionada, para las semanas que empiezan en sábado. |
| WEEK_NUMBER_SUNDAY(_date) | Devuelve el número de la semana asociado con la fecha proporcionada, para las semanas que empiezan en domingo. |
| START_OF_QUARTER(_date) | Devuelve el principio del trimestre para la fecha proporcionada. |
| END_OF_QUARTER(_date) | Devuelve el fin del trimestre para la fecha proporcionada. |
| START_OF_MONTH(_date) | Devuelve el principio del mes para la fecha proporcionada. |
| END_OF_MONTH(_date) | Devuelve el fin del mes para la fecha proporcionada. |
| START_OF_WEEK(_date) | Devuelve el principio de la semana para la fecha proporcionada. Consulte Definir el inicio de la semana para informes y filtros. |
| END_OF_WEEK(_date) | Devuelve el fin de la semana para la fecha proporcionada. Consulte Definir el inicio de la semana para informes y filtros. |
| START_OF_WEEK_MONDAY(_date) | Devuelve el principio de la semana que coincide con la fecha proporcionada, para las semanas que empiezan en lunes. |
| END_OF_WEEK_MONDAY(_date) | Devuelve el fin de la semana que coincide con la fecha proporcionada, para las semanas que empiezan en lunes. |
| START_OF_WEEK_FRIDAY(_date) | Devuelve el principio de la semana que coincide con la fecha proporcionada, para las semanas que empiezan en viernes. |
| END_OF_WEEK_FRIDAY(_date) | Devuelve el fin de la semana que coincide con la fecha proporcionada, para las semanas que empiezan en viernes. |
| START_OF_WEEK_SATURDAY(_date) | Devuelve el principio de la semana que coincide con la fecha proporcionada, para las semanas que empiezan en sábado. |
| END_OF_WEEK_SATURDAY(_date) | Devuelve el fin de la semana que coincide con la fecha proporcionada, para las semanas que empiezan en sábado. |
| START_OF_WEEK_SUNDAY(_date) | Devuelve el principio de la semana que coincide con la fecha proporcionada, para las semanas que empiezan en domingo. |
| END_OF_WEEK_SUNDAY(_date) | Devuelve el fin de la semana que coincide con la fecha proporcionada, para las semanas que empiezan en domingo. |
| DATE_FROM_ISO | Devuelve una marca de tiempo si el parámetro es una cadena de marca de tiempo estándar ISO. Asume que la marca de tiempo tiene una zona horaria, pero es posible analizar las marcas de tiempo sin información de zona horaria estableciendo el parámetro opcional skip-timezone en TRUE. Ejemplos: DATE_FROM_ISO("2020-07-24T13:42:00Z") DATE_FROM_ISO("2020-07-24T13:42EST") DATE_FROM_ISO("2020-07-24T13:42+05") DATE_FROM_ISO("2020-07-24T13:42," TRUE) |
| DATE_FROM_TIMESTAMP(_timestamp) | Devuelve una fecha a partir de una marca de tiempo UNIX proporcionada en segundos. |
| DATE_FROM_MILLI_TIMESTAMP(_timestamp) | Devuelve una fecha a partir de una marca de tiempo UNIX proporcionada en milisegundos. |
| DATE_TO_TIMESTAMP(_date) | Devuelve una marca de tiempo UNIX en la zona horaria del usuario a partir de una fecha proporcionada. |
| DATE_TO_MILLI_TIMESTAMP(_date) | Devuelve una marca de tiempo UNIX en milisegundos a partir de una fecha proporcionada. |
| SECONDS_TO_TIME(_time) | Convierte los segundos al formato HH:MM:SS. |
| FISCAL_YEAR(_date,_start_month) | Devuelve el año fiscal en función de la fecha y el principio de mes proporcionados. El parámetro month tiene que ser el mes escrito sin abreviarse (por ejemplo, "febrero" y no "feb"). |
| FISCAL_QUARTER(_date,_start_month) | Devuelve el trimestre fiscal en función de la fecha y el principio de mes proporcionados. El parámetro month tiene que ser el mes escrito sin abreviarse (por ejemplo, "febrero" y no "feb"). |
| FISCAL_WEEK_NUMBER(_date,_start_month) | Devuelve el número de la semana fiscal en función de la fecha y el principio de mes proporcionados. El parámetro month tiene que ser el mes escrito sin abreviarse (por ejemplo, "febrero" y no "feb"). |
| WEEKYEAR(_date) | Devuelve el año del número de la semana asociado con la fecha proporcionada. |
| DATE_FIRST(atributo de tiempo) |
Devuelve la primera fecha o marca de tiempo según los atributos agregados al informe y se ve afectado por todos los filtros que se apliquen. Ejemplo: DATE_FIRST([Actualizar - Marca de tiempo]) Devuelve la última marca de tiempo de actualización tomando en cuenta todos los atributos que se hayan añadido al informe. Si desea más ayuda y ejemplos, consulte Trabajar con las funciones de primera y última fecha. |
| DATE_LAST(atributo de tiempo) |
Devuelve la última fecha o marca de tiempo según los atributos agregados al informe y se ve afectado por todos los filtros que se apliquen. Ejemplo: DATE_LAST([Actualizar - Marca de tiempo]) Devuelve la última marca de tiempo de actualización tomando en cuenta todos los atributos que se hayan añadido al informe. Si desea más ayuda y ejemplos, consulte Trabajar con las funciones de primera y última fecha. |
| DATE_FIRST_FIX(atributo de tiempo, atributo1, atributo2, ...) |
Devuelve la primera fecha o marca de tiempo según los atributos especificados en la función. Los atributos que se añadan al informe no afectarán el cálculo, pero se tomarán en cuenta todos los filtros que se apliquen. Ejemplo: DATE_FIRST_FIX([Actualizar - Marca de tiempo], [ID del ticket de actualización]) Devuelve la primera marca de tiempo de actualización por ticket, independientemente de los atributos del informe. Si desea más ayuda y ejemplos, consulte Trabajar con las funciones de primera y última fecha. |
| DATE_LAST_FIX(atributo de tiempo, atributo1, atributo2, ...) |
Devuelve la última fecha o marca de tiempo según los atributos especificados en la función. Los atributos que se añadan al informe no afectarán el cálculo, pero se tomarán en cuenta todos los filtros que se apliquen. Ejemplo: DATE_LAST_FIX([Actualizar - Marca de tiempo], [ID del ticket de actualización]) Devuelve la última marca de tiempo de actualización por ticket, independientemente de los atributos del informe. Si desea más ayuda y ejemplos, consulte Trabajar con las funciones de primera y última fecha. |
Formato de fechas
La función DATE_FORMAT representa las marcas de tiempo completas como diferentes tipos de fechas. Cada formato está representado por una letra diferente. La letra asociada se ingresa en la parte del formato de la función DATE_FORMAT. Las letras deben escribirse entre comillas dobles. Se pueden combinar los componentes de fecha y hora para mostrar más información sobre una fecha.
Por ejemplo, para cambiar el formato predeterminado (2015-01-27T13:21:10) del atributo Ticket creado - Marca de tiempo a un formato de estilo de Estados Unidos (Ene 27, 2015 01:21 PM), use esta fórmula:
DATE_FORMAT([Ticket created - Timestamp],"Mon DD, YYYY hh:MI AM")
En la tabla se muestran los formatos que se pueden usar. En los ejemplos se usa la marca de tiempo 2017-11-03T15:18:25.
| Componente de fecha u hora | Letra | Ejemplos con 2017-11-03T15:18:25 |
| Año | YYYY | 2017 |
| Año | YY | 17 |
| Trimestre | Q | P4 |
| Número del mes | MM | 11 |
| Nombre del mes | Mon | Nov |
| Nombre del mes | Month | Noviembre |
| Semana del año (1-53) | WW | 44 |
| Semana del mes (1-5) | W | 1 |
| Número de día del año (01-366) | DDD | 307 |
| Número de día del mes (01-31) | DD | 3 |
| Nombre del día de la semana | Day | Viernes |
| Nombre del día de la semana | Dy | vie |
| Hora del día (01-12) | hh | 3 |
| Hora del día (1-23) | HH | 15 |
| Minutos | MI | 18 |
| Segundos | SS | 25 |
| Milisegundo (000-999) | MS | 0 |
| Indicador de meridiano (a. m. o p. m.) | a. m. | p. m. |
Funciones numéricas
Estas funciones permiten realizar distintos cálculos matemáticos usando la información de los informes.
| Función | Descripción |
| ABS(_number) | Devuelve el valor absoluto del número proporcionado.
Ejemplos: El valor absoluto de 1 es 1 El valor absoluto de -7,3 es 7,3 |
| BETWEEN(_number,_number,_number) | Devuelve TRUE si el primer número proporcionado se encuentra entre los dos otros números. Ejemplo: BETWEEN(SUM(Ganancia),500,1500) devuelve TRUE si SUM(Ganancia) es igual a, o se encuentra entre 500 y 1500. |
| CEIL(_number) | Devuelve el límite superior del número proporcionado. El límite superior de un número es el entero más alto igual o más cercano a ese número. Ejemplos: El límite superior de 125,4 es 126 El límite superior de -63,2 es -63 CEILING(SUM(Tiempo de primera resolución (min))) devuelve el entero más alto más cercano a cada tiempo de primera resolución almacenado en el atributo. |
| EXP(_number) | Devuelve el valor de la base del logaritmo natural (e) a la potencia del exponente proporcionado. Ejemplo: EXP(SUM(Precio por unidad)) devuelve el logaritmo natural de cada valor de la métrica SUM(Precio por unidad). |
| FLOOR(_number) | Devuelve el límite inferior del número proporcionado. El límite inferior de un número es el entero más bajo igual o más cercano a ese número. Ejemplos: El límite inferior de 125,4 es 125 El límite inferior de -63,2 es -64 FLOOR(SUM(Tiempo de primera resolución (min))) devuelve el entero más bajo más cercano a cada tiempo de primera resolución almacenado en el atributo. |
| INTEGER(_param) | Devuelve el entero del número no entero proporcionado. Ejemplo: INTEGER(1.56) devuelve 1 |
| IS_NUMBER(_param) | Devuelve TRUE si el parámetro dado es un número (entero o decimal) y FALSE si no lo es. Ejemplos:
|
| MAXIMUM(_number,_number) | Devuelve el valor más grande de los dos parámetros proporcionados. MAXIMUM(SUM(Ingresos),SUM(Gastos)) devuelve el valor más grande entre Ingresos y Gastos. |
| MINIMUM(_number,_number) | Devuelve el valor más pequeño de los dos parámetros proporcionados. MINIMUM(SUM(Ingresos),SUM(Gastos)) devuelve el valor más pequeño entre Ingresos y Gastos. |
| NUMBER(_param) |
Devuelve la representación numérica del parámetro dado (o NaN si no puede mostrarse como número). Ejemplos: NUMBER("3.14116") devuelve 3.14116 NUMBER([Categoría de caja]) devuelve el número del valor actual del atributo Categoría de caja. |
| PI() |
Devuelve la constante matemática del radio de la circunferencia de un círculo a su diámetro, expresada como PI. El valor es 3,141592653589793. |
| POWER(_number,_number) | Calcula y devuelve el primer número proporcionado a la potencia del segundo número proporcionado. Ejemplo: Si SUM(Precio por unidad)=2 entonces POWER(SUM(Precio por unidad),3) devuelve 8 |
| RANDOM() |
Devuelve un número n seudo-aleatorio, siendo 0 <= n <1. Si necesita un número entero aleatorio, use la fórmula Round(Random()*100). |
| ROUND(_number) |
Redondea el valor del número proporcionado al entero más próximo (hacia arriba o hacia abajo). En caso de equidistancia, el valor se redondea hacia arriba. |
| SIGN(_number) |
Devuelve -1 si el número es negativo, 0 si es cero o 1 si es positivo. |
| SQRT(_number) | Calcula y devuelve la raíz cuadrada del número proporcionado. |
| SQUARE(_number) | Calcula y devuelve el cuadrado del número proporcionado. |
| LN(_number) | Devuelve el logaritmo natural del número proporcionado. |
| LOG10(_number) | Devuelve el logaritmo en base 10 del número proporcionado. |
| LOG2(_number) | Devuelve el logaritmo en base 2 del número proporcionado. |
| LOG(_base,_number) | Devuelve el logaritmo del número proporcionado en la base proporcionada. |
Funciones trigonométricas
Estas funciones ayudan a crear fórmulas avanzadas para medir ángulos y distancias.
| Función | Descripción |
| ACOS(_number) | Calcula el arco coseno del número especificado, expresado en radianes. |
| ASIN(_number) | Calcula el arcoseno del número especificado, expresado en radianes. |
| ATAN(_number) | Devuelve el valor, expresado en radianes, del ángulo cuya tangente esté especificada en el parámetro. El valor devuelto se encuentra entre PI/2 negativo y PI/2 positivo. |
| ATAN2(_number,_number) | Devuelve el ángulo del punto Y/X en radianes cuando se mide en sentido antihorario desde el eje X de un círculo (siendo 0,0 el centro del círculo). El valor devuelto está entre PI positivo y PI negativo. Ingrese la coordenada Y como el primer parámetro. |
| COS(_number) | Calcula el coseno del número especificado, expresado en radianes. |
| DEGREES(_number) | Convierte el número dado en radianes a grados. |
| RADIANS(_number) | Convierte el número dado en grados a radianes. |
| SIN(_number) | Calcula el seno del número especificado, expresado en radianes. |
| TAN(_number) | Devuelve la tangente del ángulo especificado. |