Funciones de Tableau (por categorías)

Las funciones de Tableau de esta referencia están organizadas por categorías. Haga clic en una categoría para explorar sus funciones. O pulse Ctr+F (Comando - F en Mac) para abrir un cuadro de búsqueda que puede utilizar para buscar una función específica en la página.

Funciones numéricas

ABS

SintaxisABS(number)
ResultadoNúmero (positivo)
DefiniciónDevuelve el valor absoluto del <number> dado.
Ejemplo
ABS(-7) = 7
ABS([Budget Variance])

El segundo ejemplo devuelve el valor absoluto para todos los números que el Discordancia campo Varianza de presupuesto.

NotasConsulte también SIGN.

ACOS

SintaxisACOS(number)
ResultadoNúmero (ángulo en radianes)
DefiniciónDevuelve el arcocoseno (ángulo) del <number> dado.
Ejemplo
ACOS(-1) = 3.14159265358979
NotasLa función inversa, COS, toma el ángulo en radianes como argumento y devuelve el coseno.

ASIN

SintaxisASIN(number)
ResultadoNúmero (ángulo en radianes)
DefiniciónDevuelve el arcoseno (ángulo) de un <number> dado.
Ejemplo
ASIN(1) = 1.5707963267949
NotasLa función inversa, SIN, toma el ángulo en radianes como argumento y devuelve el seno.

ATAN

SintaxisATAN(number)
ResultadoNúmero (ángulo en radianes)
DefiniciónDevuelve el arcotangente (ángulo) de un <number> dado.
Ejemplo
ATAN(180) = 1.5652408283942
Notas

La función inversa, TAN, toma el ángulo en radianes como argumento y devuelve la tangente.

Consulte también ATAN2 y COT.

ATAN2

SintaxisATAN2(y number, x number)
ResultadoNúmero (ángulo en radianes)
DefiniciónIndica el arcotangente (ángulo) entre dos números (x e y). El resultado está en radianes.
Ejemplo
ATAN2(2, 1) = 1.10714871779409
NotasConsulte también ATAN, TAN y COT.

CEILING

SintaxisCEILING(number)
ResultadoEntero
DefiniciónRedondea un <number> al entero más cercano de valor igual o superior.
Ejemplo
CEILING(2.1) = 3
NotasConsulte también FLOOR y ROUND.
Limitaciones de la base de datos

CEILING está disponible a través de los siguientes conectores: Microsoft Excel, Text File, Statistical File, Published Data Source, Amazon EMR Hadoop Hive, Amazon Redshift, Cloudera Hadoop, DataStax Enterprise, Google Analytics, Google BigQuery, Hortonworks Hadoop Hive, MapR Hadoop Hive, Microsoft SQL Server, Salesforce, Spark SQL.

COS

SintaxisCOS(number)

El argumento numérico es el ángulo en radianes.

ResultadoNúmero
DefiniciónIndica el coseno de un ángulo.
Ejemplo
COS(PI( ) /4) = 0.707106781186548
Notas

La función inversa, ACOS, toma el coseno como argumento y devuelve el ángulo en radianes.

Consulte también PI. Para convertir un ángulo de grados a radianes, use RADIANS.

COT

SintaxisCOT(number)

El argumento numérico es el ángulo en radianes.

ResultadoNúmero
DefiniciónIndica la cotangente de un ángulo.
Ejemplo
COT(PI( ) /4) = 1
NotasConsulte también ATAN, TAN y PI. Para convertir un ángulo de grados a radianes, use RADIANS.

DEGREES

SintaxisDEGREES(number)

El argumento numérico es el ángulo en radianes.

ResultadoNúmero (grados)
DefiniciónConvierte un ángulo en radianes a grados.
Ejemplo
DEGREES(PI( )/4) = 45.0
Notas

La función inversa, RADIANS, toma un ángulo en grados y lo devuelve en radianes.

Consulte también PI().

DIV

SintaxisDIV(integer1, integer2)
ResultadoEntero
DefiniciónDevuelve la parte entera de una operación de división en la que <integer1> se divide entre <integer2>.
Ejemplo
DIV(11,2) = 5

EXP

SintaxisEXP(number)
ResultadoNúmero
DefiniciónDevuelve e elevado a la potencia del <number> dado.
Ejemplo
EXP(2) = 7.389
EXP(-[Growth Rate]*[Time])
NotasConsulte también LN.

FLOOR

SintaxisFLOOR(number)
ResultadoEntero
DefiniciónRedondea un número al <number> más cercano de valor igual o inferior.
Ejemplo
FLOOR(7.9) = 7
NotasConsulte también CEILING y ROUND.
Limitaciones de la base de datos

FLOOR está disponible a través de los siguientes conectores: Microsoft Excel, Text File, Statistical File, Published Data Source, Amazon EMR Hadoop Hive, Cloudera Hadoop, DataStax Enterprise, Google Analytics, Google BigQuery, Hortonworks Hadoop Hive, MapR Hadoop Hive, Microsoft SQL Server, Salesforce, Spark SQL.

HEXBINX

SintaxisHEXBINX(number, number)
ResultadoNúmero
DefiniciónAsigna unas coordenadas x, y a la coordenada x de la agrupación hexagonal más cercana. Las agrupaciones tienen una longitud lateral de 1, por lo que es necesario escalar las entradas correctamente.
Ejemplo
HEXBINX([Longitude]*2.5, [Latitude]*2.5)
NotasHEXBINX y HEXBINY son funciones de agrupación y trazado para agrupaciones hexagonales. Las agrupaciones hexagonales son una opción eficaz y elegante para mostrar los datos en un plano x/y como un mapa. Dado que los grupos son hexagonales, cada uno se aproxima a un círculo y minimiza las variaciones en la distancia entre el punto de datos y el centro de la agrupación. Esto hace que la agrupación sea más precisa e informativa.

HEXBINY

SintaxisHEXBINY(number, number)
ResultadoNúmero
DefiniciónAsigna unas coordenadas x, y a la coordenada y de la agrupación hexagonal más cercana. Las agrupaciones tienen una longitud lateral de 1, por lo que es necesario escalar las entradas correctamente.
Ejemplo
HEXBINY([Longitude]*2.5, [Latitude]*2.5)
NotasConsulte también HEXBINX.

LN

SintaxisLN(number)
Resultado

Número

La salida es Null si el argumento es menor o igual a cero.

DefiniciónDevuelve el logaritmo natural de un <number>.
Ejemplo
LN(50) = 3.912023005
NotasConsulte también EXP y LOG.

LOG

SintaxisLOG(number, [base])

Si el argumento base opcional no está presente, se utiliza la base 10.

ResultadoNúmero
DefiniciónIndica el logaritmo de un número para la base dada.
Ejemplo
LOG(16,4) = 2
NotasConsulte también POWER LN.

MAX

SintaxisMAX(expression) o MAX(expr1, expr2)
ResultadoEl mismo tipo de datos que el argumento, o NULL  si alguna parte del argumento es nula.
Definición

Indica el máximo de dos argumentos, los cuales deben ser del mismo tipo de datos.

MAX se puede aplicar también a un solo campo como una agregación.

Ejemplo
MAX(4,7) = 7
MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021#
MAX([Name]) = "Zander"
Notas

Para cadenas

MAX suele ser el valor que aparece en último lugar en orden alfabético.

Para las fuentes de datos de bases de datos, el valor de cadena MAX es el valor más alto en la secuencia de orden definido por la base de datos para esta columna.

Para fechas

Para las fechas, MAX es la fecha más reciente. Si MAX es una agregación, el resultado no tendrá una jerarquía de fechas. Si MAX es una comparación, el resultado conservará la jerarquía de fechas.

Como agregación

MAX(expression) es una función agregada y devuelve un solo resultado agregado. Se muestra como AGG(expression) en la visualización.

Como comparación

MAX(expr1, expr2) compara los dos valores y devuelve un valor de nivel de fila.

Consulte también MIN.

MIN

SintaxisMIN(expression) o MIN(expr1, expr2)
ResultadoEl mismo tipo de datos que el argumento, o NULL  si alguna parte del argumento es nula.
Definición

Indica el mínimo de dos argumentos, los cuales deben ser del mismo tipo de datos.

MIN se puede aplicar también a un solo campo como una agregación.

Ejemplo
MIN(4,7) = 4
MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986#
MIN([Name]) = "Abebi"
Notas

Para cadenas

MIN suele ser el valor que aparece en primer lugar en orden alfabético.

Para las fuentes de datos de bases de datos, el valor de cadena MIN es el valor más bajo en la secuencia de orden definido por la base de datos para esta columna.

Para fechas

Para las fechas, MIN es la fecha más anterior. Si MIN es una agregación, el resultado no tendrá una jerarquía de fechas. Si MIN es una comparación, el resultado conservará la jerarquía de fechas.

Como agregación

MIN(expression) es una función agregada y devuelve un solo resultado agregado. Se muestra como AGG(expression) en la visualización.

Como comparación

MIN(expr1, expr2) compara los dos valores y devuelve un valor de nivel de fila.

Consulte también MAX.

PI

SintaxisPI()
ResultadoNúmero
DefiniciónDevuelve la constante numérica pi: 3,14159...
Ejemplo
PI() = 3.14159
NotasÚtil para funciones trigonométricas que toman su entrada en radianes. Consulte también RADIANS.

POWER

SintaxisPOWER(number, power)
ResultadoNúmero
DefiniciónEleva el <number> a la <power> especificada.
Ejemplo
POWER(5,3) = 125
POWER([Temperature], 2)
NotasTambién puede usar el símbolo ^, como en 5^3 = POWER(5,3) = 125

Consulte también EXP, LOG y SQUARE.

RADIANS

SintaxisRADIANS(number)
ResultadoNúmero (ángulo en radianes)
DefiniciónConvierte el <number> dado en grados a radianes.
Ejemplo
RADIANS(180) = 3.14159
NotasLa función inversa, DEGREES, toma un ángulo en radianes y lo devuelve en grados.

ROUND

SintaxisROUND(number, [decimals])
ResultadoNúmero
Definición

Redondea <number> a una cantidad de dígitos especificada.

El argumento opcional decimals especifica la cantidad de puntos decimales de precisión que se incluyen en el resultado final. Si se omiten los decimals, el número se redondea al entero más cercano.

Ejemplo
ROUND(1/3, 2) = 0.33
Notas

Algunas bases de datos, como SQL Server, permiten especificar una longitud negativa, donde -1 redondea el número a decenas, -2 lo redondea a centenas y así sucesivamente. Esto no es cierto en todas las bases de datos. Por ejemplo, no es cierto en Excel o Access.

Consejo: Debido a que ROUND puede tener problemas debido a la representación subyacente de los números en punto flotante, como 9,405 redondeando a 9,40, puede ser preferible formatear el número con el número deseado de puntos decimales en lugar de redondearlo. Dar formato a 9,405 con dos decimales producirá el 9,41 esperado.

Consulte también CEILING y FLOOR.

SIGN

SintaxisSIGN(number)
Resultado-1, 0 o 1
DefiniciónDevuelve la firma de un <number>: los posibles valores de devolución son -1 si el número es negativo, 0 si el número es cero, o 1 si el número es positivo.
Ejemplo
SIGN(AVG(Profit)) = -1
NotasConsulte también ABS.

SIN

SintaxisSIN(number)

El argumento numérico es el ángulo en radianes.

ResultadoNúmero
DefiniciónIndica el seno de un ángulo.
Ejemplo
SIN(0) = 1.0
SIN(PI( )/4) = 0.707106781186548
Notas

La función inversa, ASIN, toma el seno como argumento y devuelve el ángulo en radianes.

Consulte también PI. Para convertir un ángulo de grados a radianes, use RADIANS.

SQRT

SintaxisSQRT(number)
ResultadoNúmero
DefiniciónDevuelve la raíz cuadrada de un <number>.
Ejemplo
SQRT(25) = 5
NotasConsulte también SQUARE.

SQUARE

SintaxisSQUARE(number)
ResultadoNúmero
DefiniciónDevuelve el cuadrado de un <number>.
Ejemplo
SQUARE(5) = 25
NotasConsulte también SQRT y POWER.

TAN

SintaxisTAN(number)

El argumento numérico es el ángulo en radianes.

ResultadoNúmero
DefiniciónIndica la tangente de un ángulo.
Ejemplo
TAN(PI ( )/4) = 1.0
NotasConsulte también ATAN, ATAN2,COT y PI. Para convertir un ángulo de grados a radianes, use RADIANS.

ZN

SintaxisZN(expression)
ResultadoCualquiera, o o
Definición

Indica la <expression> si no es null, de lo contrario, indica cero.

Utilice esta función para reemplazar los valores nulos con ceros.

Ejemplo
ZN(Grade) = 0
NotasEsta es una función muy útil cuando se utilizan campos que pueden contener valores nulos en un cálculo. Al incluir el campo en ZN, puede evitar errores causados al calcular con valores nulos.
Funciones de cadena

ASCII

SintaxisASCII(string)
ResultadoNúmero
DefiniciónDevuelve el código ASCII del primer carácter de una <string>.
Ejemplo
ASCII('A') = 65
NotasEste es el inverso de la función CHAR.

CHAR

SintaxisCHAR(number)
ResultadoCadena
DefiniciónDevuelve el carácter codificado por el <number> de código ASCII.
Ejemplo
CHAR(65) = 'A'
NotasEste es el inverso de la función ASCII.

CONTAINS

SintaxisCONTAINS(string, substring)
ResultadoBooleano
DefiniciónIndica true si la cadena dada contiene la subcadena especificada.
Ejemplo
CONTAINS("Calculation", "alcu") = true
NotasConsulte también la función lógica(El enlace se abre en una ventana nueva) IN así como RegEx compatible en la documentación de funciones adicionales(El enlace se abre en una ventana nueva).

ENDSWITH

SintaxisENDSWITH(string, substring)
ResultadoBooleano
DefiniciónIndica true si la cadena dada finaliza con la subcadena especificada. Se ignoran los espacios posteriores en blanco.
Ejemplo
ENDSWITH("Tableau", "leau") = true
NotasConsulte también la RegEx compatibles en la documentación de funciones adicionales(El enlace se abre en una ventana nueva).

FIND

SintaxisFIND(string, substring, [start])
ResultadoNúmero
Definición

Indica la posición de índice de la subcadena en la cadena, o 0 si no se encuentra la subcadena. El primer carácter de la cadena es la posición 1.

Si se agrega el argumento numérico opcional start, la función ignora cualquier instancia de subcadena que aparece antes de la posición de inicio.

Ejemplo
FIND("Calculation", "alcu") = 2
FIND("Calculation", "Computer") = 0
FIND("Calculation", "a", 3) = 7
FIND("Calculation", "a", 2) = 2
FIND("Calculation", "a", 8) = 0
NotasConsulte también la RegEx compatibles en la documentación de funciones adicionales(El enlace se abre en una ventana nueva).

FINDNTH

SintaxisFINDNTH(string, substring, occurrence)
ResultadoNúmero
DefiniciónIndica la posición de la aparición número n de la subcadena dentro de la cadena especificada, donde n se define mediante el argumento de aparición.
Ejemplo
FINDNTH("Calculation", "a", 2) = 7
Notas

FINDNTH no está disponible en todas las fuentes de datos.

Consulte también la RegEx compatibles en la documentación de funciones adicionales(El enlace se abre en una ventana nueva).

LEFT

Sintaxis LEFT(string, number)
ResultadoCadena
DefiniciónDevuelve el <number> de caracteres que se encuentra en el extremo izquierdo de la cadena.
Ejemplo
LEFT("Matador", 4) = "Mata"
NotasConsulte también MID y RIGHT.

LEN

SintaxisLEN(string)
ResultadoNúmero
DefiniciónIndica la longitud de la cadena.
Ejemplo
LEN("Matador") = 7
NotasNo confundir con la función espacial(El enlace se abre en una ventana nueva) LENGTH.

LOWER

SintaxisLOWER(string)
ResultadoCadena
DefiniciónDevuelve la <string> proporcionada con todos los caracteres en minúscula.
Ejemplo
LOWER("ProductVersion") = "productversion"
NotasConsulte también UPPER y PROPER.

LTRIM

Sintaxis LTRIM(string)
ResultadoCadena
DefiniciónDevuelve la <string> proporcionada con todos los espacios iniciales eliminados.
Ejemplo
LTRIM(" Matador ") = "Matador "
NotasConsulte también RTRIM.

MAX

SintaxisMAX(expression) o MAX(expr1, expr2)
ResultadoEl mismo tipo de datos que el argumento, o NULL  si alguna parte del argumento es nula.
Definición

Indica el máximo de dos argumentos, los cuales deben ser del mismo tipo de datos.

MAX se puede aplicar también a un solo campo como una agregación.

Ejemplo
MAX(4,7) = 7
MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021#
MAX([Name]) = "Zander"
Notas

Para cadenas

MAX suele ser el valor que aparece en último lugar en orden alfabético.

Para las fuentes de datos de bases de datos, el valor de cadena MAX es el valor más alto en la secuencia de orden definido por la base de datos para esta columna.

Para fechas

Para las fechas, MAX es la fecha más reciente. Si MAX es una agregación, el resultado no tendrá una jerarquía de fechas. Si MAX es una comparación, el resultado conservará la jerarquía de fechas.

Como agregación

MAX(expression) es una función agregada y devuelve un solo resultado agregado. Se muestra como AGG(expression) en la visualización.

Como comparación

MAX(expr1, expr2) compara los dos valores y devuelve un valor de nivel de fila.

Consulte también MIN.

MID

Sintaxis(MID(string, start, [length])
ResultadoCadena
Definición

Devuelve una cadena que empieza en la posición start especificada. El primer carácter de la cadena es la posición 1.

Si se agrega el argumento numérico opcional length, la cadena indicada incluye solo esa cantidad de caracteres.

Ejemplo
MID("Calculation", 2) = "alculation"
MID("Calculation", 2, 5) ="alcul"
NotasConsulte también la RegEx compatibles en la documentación de funciones adicionales(El enlace se abre en una ventana nueva).

MIN

SintaxisMIN(expression) o MIN(expr1, expr2)
ResultadoEl mismo tipo de datos que el argumento, o NULL  si alguna parte del argumento es nula.
Definición

Indica el mínimo de dos argumentos, los cuales deben ser del mismo tipo de datos.

MIN se puede aplicar también a un solo campo como una agregación.

Ejemplo
MIN(4,7) = 4
MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986#
MIN([Name]) = "Abebi"
Notas

Para cadenas

MIN suele ser el valor que aparece en primer lugar en orden alfabético.

Para las fuentes de datos de bases de datos, el valor de cadena MIN es el valor más bajo en la secuencia de orden definido por la base de datos para esta columna.

Para fechas

Para las fechas, MIN es la fecha más anterior. Si MIN es una agregación, el resultado no tendrá una jerarquía de fechas. Si MIN es una comparación, el resultado conservará la jerarquía de fechas.

Como agregación

MIN(expression) es una función agregada y devuelve un solo resultado agregado. Se muestra como AGG(expression) en la visualización.

Como comparación

MIN(expr1, expr2) compara los dos valores y devuelve un valor de nivel de fila.

Consulte también MAX.

PROPER

SintaxisPROPER(string)
ResultadoCadena
Definición

Devuelve la <string> proporcionada con la primera letra de cada palabra en mayúscula y las letras restantes en minúsculas.

Ejemplo
PROPER("PRODUCT name") = "Product Name"
PROPER("darcy-mae") = "Darcy-Mae"
Notas

Los espacios y los caracteres no alfanuméricos, como la puntuación, se tratan como separadores.

Consulte también LOWER y UPPER.

Limitaciones de la base de datosPROPER solo está disponible para algunos archivos planos y en extracciones. Si necesita usar PROPER en una fuente de datos que de otro modo no lo admite, considere usar una extracción.

REPLACE

SintaxisREPLACE(string, substring, replacement
ResultadoCadena
DefiniciónBusca <string> para <substring> y lo reemplaza con <replacement>. Si no se encuentra <substring>, se elimina el cambio a la cadena.
Ejemplo
REPLACE("Version 3.8", "3.8", "4x") = "Version 4x"
NotasConsulte también REGEXP_REPLACE en la documentación de funciones adicionales(El enlace se abre en una ventana nueva).

RIGHT

SintaxisRIGHT(string, number)
ResultadoCadena
DefiniciónDevuelve el <number> de caracteres que se encuentra en el extremo derecho de la cadena.
Ejemplo
RIGHT("Calculation", 4) = "tion"
NotasConsulte también LEFT y MID.

RTRIM

SintaxisRTRIM(string)
ResultadoCadena
DefiniciónDevuelve la <string> proporcionada con todos los espacios posteriores eliminados.
Ejemplo
RTRIM(" Calculation ") = " Calculation"
NotasConsulte también LTRIM y TRIM.

SPACE

SintaxisSPACE(number)
ResultadoCadena (específicamente, solo espacios)
DefiniciónDevuelve una cadena compuesta por el número especificado de espacios repetidos.
Ejemplo
SPACE(2) = "  "

SPLIT

SintaxisSPLIT(string, delimiter, token number)
ResultadoCadena
DefiniciónIndica una subcadena a partir de una cadena (usa un carácter delimitador para dividir la cadena en una secuencia de tokens).
Ejemplo
SPLIT ("a-b-c-d", "-", 2) = "b"
SPLIT ("a|b|c|d", "|", -2) = "c"
Notas

La cadena se interpreta como una secuencia alterna de delimitadores y tokens. Para la cadena abc-defgh-i-jkl, donde el carácter delimitador es “-”, los tokens son (1) abc, (2) defgh, (3) i y (4) jlk.

SPLIT devuelve el token que se corresponde con el número de token. Cuando el número de token es positivo, los tokens se cuentan empezando desde el extremo izquierdo de la cadena; cuando el número de token es negativo, los tokens se cuentan empezando desde la derecha.

Consulte también REGEX compatible en la documentación de funciones adicionales(El enlace se abre en una ventana nueva).

Limitaciones de la base de datos

Los comandos de división y división personalizada están disponibles para los siguientes tipos de fuentes de datos: extracciones de datos de Tableau, Microsoft Excel, archivos de texto, archivos PDF, Salesforce, OData, Microsoft Azure Market Place, Google Analytics, Vertica, Oracle, MySQL, PostgreSQL, Teradata, Amazon Redshift, Aster Data, Google Big Query, Cloudera Hadoop Hive, Hortonworks Hive y Microsoft SQL Server.

Algunas fuentes de datos imponen límites en la división de cadenas. Consulte las limitaciones de la función SPLIT más adelante en este tema.

STARTSWITH

SintaxisSTARTSWITH(string, substring)
ResultadoBooleano
DefiniciónIndica true si la string comienza por la substring. Se ignoran los espacios iniciales en blanco.
Ejemplo
STARTSWITH("Matador, "Ma") = TRUE
NotasConsulte también CONTAINS así como RegEx compatible en la documentación de funciones adicionales(El enlace se abre en una ventana nueva).

TRIM

SintaxisTRIM(string)
ResultadoCadena
DefiniciónDevuelve la <string> proporcionada con los espacios iniciales y posteriores eliminados.
Ejemplo
TRIM(" Calculation ") = "Calculation"
NotasConsulte también LTRIM y RTRIM.

UPPER

SintaxisUPPER(string)
ResultadoCadena
DefiniciónDevuelve la <string> proporcionada con todos los caracteres en mayúscula.
Ejemplo
UPPER("Calculation") = "CALCULATION"
NotasConsulte también PROPER y LOWER.
Funciones de fecha

Nota: Las funciones de fecha no tienen en cuenta el inicio del año fiscal configurado. Consulte Fechas fiscales.

DATE

Escriba la función de conversión que cambia las expresiones de cadenas y números en fechas, siempre que estén en un formato reconocible.

SintaxisDATE(expression)
ResultadoFecha
DefiniciónDevuelve una fecha dada a una expresión de número, cadena o <expression> de fecha.
Ejemplo
DATE([Employee Start Date])
DATE("September 22, 2018") 
DATE("9/22/2018")
DATE(#2018-09-22 14:52#)
Notas

A diferencia de DATEPARSE, no es necesario proporcionar un patrón, ya que DATE reconoce automáticamente muchos formatos de fecha estándar. Si DATE no reconoce la entrada, intente usar DATEPARSE y especifique el formato.

MAKEDATE es otra función similar, pero MAKEDATE requiere la entrada de valores numéricos para el año, el mes y el día.

DATEADD

Agrega un número específico de partes de fecha (meses, días, etc.) a la fecha de inicio.

SintaxisDATEADD(date_part, interval, date)
ResultadoFecha
DefiniciónIndica la <date> con el valor numérico especificado de <interval> ya añadido a la <date_part> especificada de la fecha en cuestión. Por ejemplo, agregar tres meses o 12 días a una fecha de inicio.
Ejemplo

Retrasar todas las fechas de vencimiento por una semana

DATEADD('week', 1, [due date])

Agregar 280 días a la fecha 20 de febrero de 2021

DATEADD('day', 280, #2/20/21#) = #November 27, 2021#
NotasAdmite fechas ISO 8601.

DATEDIFF

Devuelve el número de partes de fechas (semanas, años, etc.) entre dos fechas.

SintaxisDATEDIFF(date_part, date1, date2, [start_of_week])
ResultadoEntero
DefiniciónIndica la diferencia entre <date1> y <date2> que se expresa en unidades de <date_part>. Por ejemplo, restar las fechas en que alguien entró y salió de una banda para ver cuánto tiempo estuvo en la banda.
Ejemplo

Número de días entre el 25 de marzo de 1986 y el 20 de febrero de 2021

DATEDIFF('day', #3/25/1986#, #2/20/2021#) = 12,751

¿Cuántos meses estuvo alguien en una banda?

DATEDIFF('month', [date joined band], [date left band])
NotasAdmite fechas ISO 8601.

DATENAME

Devuelve el nombre de la parte de la fecha especificada como una cadena discreta.

SintaxisDATENAME(date_part, date, [start_of_week])
ResultadoCadena
DefiniciónIndica <date_part> de <date> como una cadena.
Ejemplo
DATENAME('year', #3/25/1986#) = "1986"
DATENAME('month', #1986-03-25#) = "March"
Notas

Admite fechas ISO 8601.

Un cálculo muy similar es DATEPART, que devuelve el valor de la parte de la fecha especificada como un entero continuo. DATEPART puede ser más rápido porque es una operación numérica.

Al cambiar los atributos del resultado del cálculo (dimensión o medida, continua o discreta) y el formato de fecha, los resultados de DATEPART y DATENAME se pueden formatear para que sean idénticos.

Una función inversa es DATEPARSE, que toma un valor de cadena y lo formatea como una fecha.

DATEPARSE

Devuelve cadenas formateadas específicamente como fechas.

SintaxisDATEPARSE(date_format, date_string)
ResultadoFecha
DefiniciónEl argumento <date_format> describe cómo se organiza el campo <date_string>. Debido a la variedad de formas en que se puede ordenar, el campo de cadena <date_format> debe coincidir exactamente. Para ver una explicación completa y los detalles de formato, consulte Convertir un campo en un campo de fecha(El enlace se abre en una ventana nueva)
Ejemplo
DATEPARSE('yyyy-MM-dd', "1986-03-25") = #March 25, 1986#
Notas

DATE es una función similar que reconoce automáticamente muchos formatos de fecha estándar. DATEPARSE puede ser una opción mejor si DATE no reconoce el patrón de entrada.

MAKEDATE es otra función similar, pero MAKEDATE requiere la entrada de valores numéricos para el año, el mes y el día.

Las funciones inversas, que separan las fechas y devuelven el valor de sus partes, son DATEPART (salida de entero) y DATENAME (salida de cadena).

Limitaciones de la base de datos

DATEPARSE está disponible por medio de los siguientes conectores: conexiones de archivos de texto y de Excel no heredadas, Amazon EMR Hadoop Hive, Cloudera Hadoop, Hojas de cálculo de Google, Hortonworks Hadoop Hive, MapR Hadoop Hive, MySQL, Oracle, PostgreSQL y extracciones de Tableau. Algunos formatos pueden no estar disponibles para todas las conexiones.

DATEPARSE no es compatible con las variantes de Hive. Solo se admiten Denodo, Drill y Snowflake.

DATEPART

Devuelve el nombre de la parte de la fecha especificada como un entero.

SintaxisDATEPART(date_part, date, [start_of_week])
ResultadoEntero
DefiniciónIndica <date_part> de <date> como un entero.
Ejemplo
DATEPART('year', #1986-03-25#) = 1986
DATEPART('month', #1986-03-25#) = 3
Notas

Admite fechas ISO 8601.

Un cálculo muy similar es DATENAME, que devuelve el nombre de la parte de la fecha especificada como una cadena discreta. DATEPART puede ser más rápido porque es una operación numérica. Al cambiar los atributos del campo (dimensión o medida, continua o discreta) y el formato de la fecha, los resultados de DATEPART y DATENAME se pueden formatear para que sean idénticos.

Una función inversa es DATEPARSE, que toma un valor de cadena y lo formatea como una fecha.

DATETRUNC

Esta función se puede considerar como un redondeo de fechas. Toma una fecha específica y devuelve una versión de esa fecha en la especificidad deseada. Debido a que cada fecha debe tener un valor para el día, el mes, el trimestre y el año, DATETRUNC establece los valores como el valor más bajo para cada parte de la fecha hasta la parte de la fecha especificada. Consulte el ejemplo para obtener más información.

SintaxisDATETRUNC(date_part, date, [start_of_week])
ResultadoFecha
DefiniciónTrunca la <date> a la precisión especificada por la <date_part>. Esta función indica una fecha nueva. Por ejemplo, al truncar una fecha que está en la mitad del mes en el nivel de mes, esta función indica el primer día del mes.
Ejemplo
DATETRUNC('day', #9/22/2018#) = #9/22/2018#
DATETRUNC('iso-week', #9/22/2018#) = #9/17/2018#

(el lunes de la semana que contiene el 22/09/2018)

DATETRUNC(quarter, #9/22/2018#) = #7/1/2018# 

(el primer día del trimestre que contiene el 22/09/2018)

Nota: Para semana e iso-semana, start_of_week entra en juego. Las iso-semanas siempre comienzan el lunes. Para la configuración regional de este ejemplo, un start_of_week sin especificar significa que la semana comienza el domingo.

Notas

Admite fechas ISO 8601.

No debería usar DATETRUNC para, por ejemplo, dejar de mostrar la hora de un campo de fecha y hora en una visualización. Si desea truncar la visualización de una fecha en lugar de redondear su precisión, ajuste el formato(El enlace se abre en una ventana nueva).

Por ejemplo, DATETRUNC('day', #5/17/2022 3:12:48 PM#), si se formatea en la visualización para mostrar segundos, se mostrará como 5/17/2022 12:00:00 AM. El valor se trunca a día, pero la pantalla pasa a segundos.

DAY

Devuelve el día de del mes (1-31) como un entero.

SintaxisDAY(date)
ResultadoEntero
DefiniciónDevuelve el día de la <date> dada como un entero.
Ejemplo
Day(#September 22, 2018#) = 22
NotasConsulte también WEEK, MONTH, QUARTER, YEARy los equivalentes ISO.

ISDATE

Comprueba si la cadena tiene un formato de fecha válido.

SintaxisISDATE(string)
ResultadoBooleano
DefiniciónDevuelve true si una <string> dada es una fecha válida.
Ejemplo
ISDATE(09/22/2018) = true
ISDATE(22SEP18) = false
NotasEl argumento requerido debe ser una cadena. ISDATE no se puede utilizar para un campo con un tipo de datos de fecha; el cálculo devolverá un error.

ISOQUARTER

SintaxisISOQUARTER(date)
ResultadoEntero
DefiniciónDevuelve el trimestre basado en semanas ISO8601 de una <date> dada como un número entero.
Ejemplo
ISOQUARTER(#1986-03-25#) = 1
NotasConsulte también ISOWEEK, ISOWEEKDAY, ISOYEAR y los no ISO equivalentes.

ISOWEEK

SintaxisISOWEEK(date)
ResultadoEntero
DefiniciónDevuelve la semana basada en semanas ISO8601 de una <date> dada como un número entero.
Ejemplo
ISOWEEK(#1986-03-25#) = 13
NotasConsulte también ISOWEEKDAY, ISOQUARTER, ISOYEAR y los no ISO equivalentes.

ISOWEEKDAY

SintaxisISOWEEKDAY(date)
ResultadoEntero
DefiniciónDevuelve el día de la semana basado en semanas ISO8601 de una <date> dada como un número entero.
Ejemplo
ISOWEEKDAY(#1986-03-25#) = 2
NotasConsulte también ISOWEEK, ISOQUARTER, ISOYEAR y los no ISO equivalentes.

ISOYEAR

SintaxisISOYEAR(date)
ResultadoEntero
DefiniciónDevuelve el año basado en semanas ISO8601 de una determinada <date> como un número entero.
Ejemplo
ISOYEAR(#1986-03-25#) = 1,986
NotasConsulte también ISOWEEK, ISOWEEKDAY, ISOQUARTER y los no ISO equivalentes.

MAKEDATE

SintaxisMAKEDATE(year, month, day)
ResultadoFecha
DefiniciónDevuelve un valor de fecha construido a partir del <year>, <month> y <day> especificados.
Ejemplo
MAKEDATE(1986,3,25) = #1986-03-25#
Notas

Nota: Los valores ingresados incorrectamente se ajustarán a una fecha, como MAKEDATE(2020,4,31) = May 1, 2020 en lugar de devolver un error de que no existe el 31 de abril.

Disponible para las extracciones de datos de Tableau. Compruebe la disponibilidad en otras fuentes de datos.

MAKEDATE requiere entradas numéricas para las partes de una fecha. Si sus datos son una cadena que debería ser una fecha, pruebe la función DATE. DATE reconoce automáticamente muchos formatos de fecha estándar. Si DATE no reconoce la entrada, pruebe a usar DATEPARSE.

MAKEDATETIME

SintaxisMAKEDATETIME(date, time)
ResultadoDatetime
DefiniciónDevuelve una fecha y una hora que combinan una <date> y una <time>. La fecha puede ser de tipo fecha, fecha y hora o cadena. La hora debe ser fecha y hora.
Ejemplo
MAKEDATETIME("1899-12-30", #07:59:00#) = #12/30/1899 7:59:00 AM#
MAKEDATETIME([Date], [Time]) = #1/1/2001 6:00:00 AM#
Notas

Esta función solo está disponible para las conexiones compatibles con MySQL (que en Tableau son MySQL y Amazon Aurora).

MAKETIME es una función similar disponible para las extracciones de datos de Tableau y algunas otras fuentes de datos.

MAKETIME

SintaxisMAKETIME(hour, minute, second)
ResultadoDatetime
DefiniciónDevuelve un valor de fecha construido a partir del <hour>, <minute> y <second> especificados.
Ejemplo
MAKETIME(14, 52, 40) = #1/1/1899 14:52:40#
Notas

Debido a que Tableau no admite un tipo de datos de hora, solo fecha y hora, la salida es una fecha y hora. La porción de fecha del campo será 1/1/1899.

Función similar a MAKEDATETIME, que solo está disponible para conexiones compatibles con MYSQL.

MAX

SintaxisMAX(expression) o MAX(expr1, expr2)
ResultadoEl mismo tipo de datos que el argumento, o NULL si alguna parte del argumento es nula.
Definición

Indica el máximo de dos argumentos, los cuales deben ser del mismo tipo de datos.

MAX se puede aplicar también a un solo campo como una agregación.

Ejemplo
MAX(4,7) = 7
MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021#
MAX([Name]) = "Zander"
Notas

Para cadenas

MAX suele ser el valor que aparece en último lugar en orden alfabético.

Para las fuentes de datos de bases de datos, el valor de cadena MAX es el valor más alto en la secuencia de orden definido por la base de datos para esta columna.

Para fechas

Para las fechas, MAX es la fecha más reciente. Si MAX es una agregación, el resultado no tendrá una jerarquía de fechas. Si MAX es una comparación, el resultado conservará la jerarquía de fechas.

Como agregación

MAX(expression) es una función agregada y devuelve un solo resultado agregado. Se muestra como AGG(expression) en la visualización.

Como comparación

MAX(expr1, expr2) compara los dos valores y devuelve un valor de nivel de fila.

Consulte también MIN.

MIN

SintaxisMIN(expression) o MIN(expr1, expr2)
ResultadoEl mismo tipo de datos que el argumento, o NULL  si alguna parte del argumento es nula.
Definición

Indica el mínimo de dos argumentos, los cuales deben ser del mismo tipo de datos.

MIN se puede aplicar también a un solo campo como una agregación.

Ejemplo
MIN(4,7) = 4
MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986#
MIN([Name]) = "Abebi"
Notas

Para cadenas

MIN suele ser el valor que aparece en primer lugar en orden alfabético.

Para las fuentes de datos de bases de datos, el valor de cadena MIN es el valor más bajo en la secuencia de orden definido por la base de datos para esta columna.

Para fechas

Para las fechas, MIN es la fecha más anterior. Si MIN es una agregación, el resultado no tendrá una jerarquía de fechas. Si MIN es una comparación, el resultado conservará la jerarquía de fechas.

Como agregación

MIN(expression) es una función agregada y devuelve un solo resultado agregado. Se muestra como AGG(expression) en la visualización.

Como comparación

MIN(expr1, expr2) compara los dos valores y devuelve un valor de nivel de fila.

Consulte también MAX.

MONTH

SintaxisMONTH(date)
ResultadoEntero
DefiniciónDevuelve el mes de la <date> dada como un número entero.
Ejemplo
MONTH(#1986-03-25#) = 3
NotasConsulte también DAY, WEEK, QUARTER, YEAR y los equivalentes ISO

NOW

SintaxisNOW()
ResultadoDatetime
DefiniciónDevuelve la fecha y hora actual del sistema.
Ejemplo
NOW() = 1986-03-25 1:08:21 PM
Notas

NOW no acepta argumentos.

Consulte también TODAY, un cálculo similar que devuelve una fecha en lugar de una fecha y una hora.

Si la fuente de datos es una conexión activa, la fecha y la hora del sistema podrían estar en otra zona horaria. Para obtener más información, consulte la Base de conocimientos.

QUARTER

SintaxisQUARTER(date)
ResultadoEntero
DefiniciónDevuelve el trimestre de la <date> dada como un número entero.
Ejemplo
QUARTER(#1986-03-25#) = 1
NotasConsulte también DAY, WEEK, MONTH, YEAR y los equivalentes ISO

TODAY

SintaxisTODAY()
ResultadoFecha
DefiniciónDevuelve la fecha actual del sistema local.
Ejemplo
TODAY() = 1986-03-25
Notas

TODAY no acepta argumentos.

Consulte también NOW, un cálculo similar que devuelve una fecha y hora en lugar de una fecha.

Si la fuente de datos es una conexión activa, la fecha del sistema podría estar en otra zona horaria. Para obtener más información, consulte la Base de conocimientos.

WEEK

SintaxisWEEK(date)
ResultadoEntero
DefiniciónDevuelve la semana de la <date> dada como un número entero.
Ejemplo
WEEK(#1986-03-25#) = 13
NotasConsulte también DAY, MONTH, QUARTER, YEAR y los equivalentes ISO

YEAR

SintaxisYEAR(date)
ResultadoEntero
DefiniciónDevuelve el año de la <date> dada como un número entero.
Ejemplo
YEAR(#1986-03-25#) = 1,986
NotasConsulte también DAY, WEEK, MONTH, QUARTER y los equivalentes ISO

date_part

Muchas funciones de fecha en Tableau toman el argumento date_part, que es una constante de cadena que le dice a la función qué parte de una fecha considerar, como día, semana, trimestre, etc. Los valores date_part válidos que puede usar son:

date_partValores
'year'Año con cuatro dígitos
'quarter'1-4
'month'1-12 o “enero”, “febrero”, etc.
'dayofyear'Día del año; 1 de enero es 1, 1 de febrero es 32, etc.
'day'1-31
'weekday'1-7 o “domingo”, “lunes”, etc.
'week'1-52
'hour'0-23
'minute'0-59
'second'0-60
'iso-year'Año ISO 8601 de cuatro dígitos
'iso-quarter'1-4
'iso-week'1-52 y el inicio de la semana siempre es lunes
'iso-weekday'1-7 y el inicio de la semana siempre es lunes

Funciones lógicas

AND

Sintaxis<expr1> AND <expr2>
DefiniciónRealiza la conjunción lógica de dos expresiones. (Si ambos lados son True, la prueba lógica devuelve True).
ResultadoBooleano (True o False)
Ejemplo
IF [Season] = "Spring" AND "[Season] = "Fall" 
THEN "It's the apocalypse and footwear doesn't matter"
END

"Si tanto (Temporada = Primavera) como (Temporada = Otoño) son true simultáneamente, entonces devuelve: Es el apocalipsis y el calzado no importa".

Notas

A menudo se utiliza con IF y IIF. Consulte también NOT y O.

Si ambas expresiones son TRUE (no son FALSE o NULL), el resultado será TRUE. Si cualquiera de las expresiones es NULL, entonces el resultado es NULL. En todos los demás casos, el resultado será FALSE.

Si crea un cálculo en el cual el resultado de una comparación de AND se muestra en una hoja de trabajo, Tableau muestra TRUE y FALSE. Si desea cambiar esto, use el área Formato en el cuadro de diálogo de formato.

Nota: El operador AND usa evaluación de circuito corto. Esto significa que si la primera expresión se evalúa y es FALSE, entonces la segunda expresión no se evalúa en absoluto. Puede ser útil si la segunda expresión tiene como resultado un error cuando la primera expresión es FALSE, porque la segunda expresión, en este caso, nunca se evalúa.

CASE

SintaxisCASE <expression>
WHEN <value1> THEN <then1>
WHEN <value2> THEN <then2>
...
[ELSE <default>]
END
ResultadoDepende del tipo de datos de los valores <then>.
Definición

Evalúa la expression y la compara con las opciones especificadas (<value1>, <value2>, etc.). Cuando se encuentra un value que coincide con la expresión, CASE devuelve el valor de la return correspondiente. En caso de que no se encuentre ninguna coincidencia, se devolverá la expresión predeterminada. Si no hay ninguna devolución predeterminada y no hay valores que coincidan, se devolverá Null.

Ejemplo
CASE [Season] 
WHEN 'Summer' THEN 'Sandals'
WHEN 'Winter' THEN 'Boots'
ELSE 'Sneakers'
END

"Mire el campo Estación. Si el valor es Verano, devolverá Sandalias. Si el valor es Invierno, devolverá Botas. Si ninguna de las opciones del cálculo coincide con lo que hay en el campo Estación, devolverá Zapatillas".

Notas

Consulte también IF y IIF.

Usado con WHEN, THEN, ELSE y END.

Consejo: Muchas veces puede usar un grupo para obtener los mismos resultados que una función CASE complicada, o usar CASE para reemplazar la funcionalidad de agrupación nativa, como en el ejemplo anterior. Es posible que desee probar cuál es más eficaz para su escenario.

ELSE

SintaxisCASE <expression>
WHEN <value1> THEN <then1>
WHEN <value2> THEN <then2>
...
[ELSE <default>]
END
DefiniciónUna pieza opcional de una expresión IF o CASE utilizada para especificar un valor predeterminado para devolver si ninguna de las expresiones probadas es true.
Ejemplo
IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots'
ELSE 'Sneakers' 
END
CASE [Season] 
WHEN 'Summer' THEN 'Sandals'
WHEN 'Winter' THEN 'Boots'
ELSE 'Sneakers'
END
Notas

Usado con CASE, WHEN, IF, ELSEIF, THEN y END

ELSE es opcional con CASE y IF. En un cálculo donde ELSE no se especifica, si ninguno de los <test>es true, el cálculo general devolverá un valor null.

ELSE no requiere una condición (como [Season] = "Winter") y puede considerarse como una forma de gestión de valores nulos.

ELSEIF

Sintaxis[ELSEIF <test2> THEN <then2>]
DefiniciónUna pieza opcional de una expresión IF utilizada para especificar condiciones adicionales más allá del IF inicial.
Ejemplo
IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots'
ELSEIF [Season] = "Spring" THEN 'Sneakers'
ELSEIF [Season] = "Autumn" THEN 'Sneakers'
ELSE 'Bare feet'
END
Notas

Se usa con IF, THEN, ELSE y END

ELSEIF puede considerarse como cláusulas IF adicionales. ELSEIF es opcional y se puede repetir varias veces.

A diferencia de ELSE, ELSEIF requiere una condición (como [Season] = "Winter").

END

DefiniciónSe utiliza para cerrar una expresión IF o CASE.
Ejemplo
IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots'
ELSE 'Sneakers' 
END

"Si Estación = Verano, devolverá Sandalias. Si no, mire la siguiente expresión. Si Estación = Invierno, devolverá Botas. Si ninguna de las expresiones es true, devolverá Zapatillas".

CASE [Season] 
WHEN 'Summer' THEN 'Sandals'
WHEN 'Winter' THEN 'Boots'
ELSE 'Sneakers'
END

"Mire el campo Estación. Si el valor es Verano, devolverá Sandalias. Si el valor es Invierno, devolverá Botas. Si ninguna de las opciones del cálculo coincide con lo que hay en el campo Estación, devolverá Zapatillas".

Notas

Usado con CASE, WHEN, IF, ELSEIF, THEN y ELSE.

IF

SintaxisIF <test1> THEN <then1>
[ELSEIF <test2> THEN <then2>...]
[ELSE <default>]
END
ResultadoDepende del tipo de datos de los valores <then>.
Definición

Prueba una serie de expresiones que devuelven el valor <then> para la primera <test> true.

Ejemplo
IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots'
ELSE 'Sneakers' 
END

"Si Estación = Verano, devolverá Sandalias. Si no, mire la siguiente expresión. Si Estación = Invierno, devolverá Botas. Si ninguna de las expresiones es true, devolverá Zapatillas".

Notas

Consulte también IF e IIF.

Se usa con ELSEIF, THEN, ELSE y END

IFNULL

SintaxisIFNULL(expr1, expr2)
ResultadoDepende del tipo de datos de los valores <expr>.
Definición

Devuelve <expr1> si no es null, de lo contrario, devuelve <expr2>.

Ejemplo
IFNULL([Assigned Room], "TBD")

"Si el campo Sala asignada no es null, devolverá su valor. Si el campo Sala asignada es null, devolverá TBD".

Notas

Comparar con ISNULL. IFNULL siempre devuelve un valor. ISNULL devuelve un valor booleano (True o False).

Consulte también ZN.

IIF

SintaxisIIF(<test>, <then>, <else>, [<unknown>])
ResultadoDepende del tipo de datos de los valores de la expresión.
DefiniciónComprueba si se cumple una condición (<test>), y devuelve <then> si la prueba es true, <else> si la prueba es false, y un valor opcional para <unknown> si la prueba es null. Si no se especifica la incógnita opcional, IIF devolverá null.
Ejemplo
IIF([Season] = 'Summer', 'Sandals', 'Other footwear')

"Si Estación = Verano, devolverá Sandalias. Si no, devolverá Otro calzado"

IIF([Season] = 'Summer', 'Sandals', 
IIF('Season' = 'Winter', 'Boots', 'Other footwear')
)

"Si Estación = Verano, devolverá Sandalias. Si no, mire la siguiente expresión. Si Estación = Invierno, devolverá Botas. Si ninguna de las dos cosas es true, devolverá Zapatillas".

IIF('Season' = 'Summer', 'Sandals', 
IIF('Season' = 'Winter', 'Boots',
IIF('Season' = 'Spring', 'Sneakers', 'Other footwear')
)
)

"Si Estación = Verano, devolverá Sandalias. Si no, mire la siguiente expresión. Si Estación = Invierno, devolverá Botas. Si ninguna de las expresiones es true, devolverá Zapatillas".

Notas

Consulte también IF eCASE.

IIF no tiene equivalente ELSEIF (como IF) o cláusulas WHEN repetidas (como CASE). En cambio, se pueden evaluar varias pruebas secuencialmente anidando expresiones IIF como el elemento <unknown>. Se devuelve el primer true (el más externo).

Es decir, en el siguiente cálculo, el resultado será Rojo, no Naranja, porque la expresión deja de evaluarse tan pronto como A = A se evalúa como true:

IIF('A' = 'A', 'Red', IIF('B' = 'B', 'Orange', IIF('C' = 'D', 'Yellow', 'Green')))

IN

Sintaxis<expr1> IN <expr2>
ResultadoBooleano (True o False)
DefiniciónDevuelve TRUE si cualquier valor de <expr1> coincide con cualquier valor de <expr2>.
Ejemplo
SUM([Cost]) IN (1000, 15, 200)

"¿El valor del campo Coste es 1000, 15 o 200?"

[Field] IN [Set]

"¿El valor del campo está presente en el conjunto?"

Notas

Los valores en <expr2> pueden ser un conjunto, una lista de valores literales o un campo combinado.

Consulte también WHEN.

ISDATE

SintaxisISDATE(string)
ResultadoBooleano (True o False)
DefiniciónIndica True si una <string> es una fecha válida. La expresión de entrada debe ser un campo de cadena (texto).
Ejemplo
ISDATE("2018-09-22")

“¿La cadena 2018-09-22 tiene una fecha con formato correcto?”

Notas

Lo que se considera una fecha válida depende de la configuración regional(El enlace se abre en una ventana nueva) del sistema que evalúa el cálculo. Por ejemplo:

En los EE. UU:

  • ISDATE("2018-09-22") = TRUE
  • ISDATE("2018-22-09") = FALSE

En el Reino Unido:

  • ISDATE("2018-09-22") = FALSE
  • ISDATE("2018-22-09") = TRUE

ISNULL

SintaxisISNULL(expression)
ResultadoBooleano (True o False)
Definición

Devuelve true si la <expression> es NULL (no contiene datos válidos).

Ejemplo
ISNULL([Assigned Room])

"¿El campo Sala asignada es null?"

Notas

Compárelo con IFNULL. IFNULL siempre devuelve un valor. ISNULL devuelve un booleano.

Consulte también ZN.

MAX

SintaxisMAX(expression) o MAX(expr1, expr2)
ResultadoEl mismo tipo de datos que el argumento, o NULL  si alguna parte del argumento es nula.
Definición

Indica el máximo de dos argumentos, los cuales deben ser del mismo tipo de datos.

MAX se puede aplicar también a un solo campo como una agregación.

Ejemplo
MAX(4,7) = 7
MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021#
MAX([Name]) = "Zander"
Notas

Para cadenas

MAX suele ser el valor que aparece en último lugar en orden alfabético.

Para las fuentes de datos de bases de datos, el valor de cadena MAX es el valor más alto en la secuencia de orden definido por la base de datos para esta columna.

Para fechas

Para las fechas, MAX es la fecha más reciente. Si MAX es una agregación, el resultado no tendrá una jerarquía de fechas. Si MAX es una comparación, el resultado conservará la jerarquía de fechas.

Como agregación

MAX(expression) es una función agregada y devuelve un solo resultado agregado. Se muestra como AGG(expression) en la visualización.

Como comparación

MAX(expr1, expr2) compara los dos valores y devuelve un valor de nivel de fila.

Consulte también MIN.

MIN

SintaxisMIN(expression) o MIN(expr1, expr2)
ResultadoEl mismo tipo de datos que el argumento, o NULL  si alguna parte del argumento es nula.
Definición

Indica el mínimo de dos argumentos, los cuales deben ser del mismo tipo de datos.

MIN se puede aplicar también a un solo campo como una agregación.

Ejemplo
MIN(4,7) = 4
MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986#
MIN([Name]) = "Abebi"
Notas

Para cadenas

MIN suele ser el valor que aparece en primer lugar en orden alfabético.

Para las fuentes de datos de bases de datos, el valor de cadena MIN es el valor más bajo en la secuencia de orden definido por la base de datos para esta columna.

Para fechas

Para las fechas, MIN es la fecha más anterior. Si MIN es una agregación, el resultado no tendrá una jerarquía de fechas. Si MIN es una comparación, el resultado conservará la jerarquía de fechas.

Como agregación

MIN(expression) es una función agregada y devuelve un solo resultado agregado. Se muestra como AGG(expression) en la visualización.

Como comparación

MIN(expr1, expr2) compara los dos valores y devuelve un valor de nivel de fila.

Consulte también MAX.

NOT

SintaxisNOT <expression>
ResultadoBooleano (True o False)
DefiniciónRealiza una negación lógica en una expresión.
Ejemplo
IF NOT [Season] = "Summer" 
THEN 'Don't wear sandals'
ELSE 'Wear sandals' 
END

"Si la temporada no es igual al Verano, entonces devolverá: No uses sandalias. Si no, devolverá: Usa sandalias".

Notas

A menudo se utiliza con IF y IIF. Consulte también DATE y O.

O

Sintaxis<expr1> OR <expr2>
ResultadoBooleano (True o False)
DefiniciónRealiza una disyunción lógica en dos expresiones.
Ejemplo
IF [Season] = "Spring" OR [Season] = "Fall" 
THEN "Sneakers"
END

"Si (Estación = Primavera) o (Estación = Otoño) es true, entonces devolverá Zapatillas".

Notas

A menudo se utiliza con IF y IIF. Consulte también DATE y NOT.

Si cualquiera de las expresiones es TRUE, entonces el resultado es TRUE. Si ambas expresiones son FALSE, entonces el resultado es FALSE. Si ambas expresiones son NULL, entonces el resultado es NULL.

Si crea un cálculo en el cual el resultado de una comparación de OR se muestra en una hoja de trabajo, Tableau muestra TRUE y FALSE. Si desea cambiar esto, use el área Formato en el cuadro de diálogo de formato.

Nota: El operador OR usa evaluación de circuito corto. Esto significa que si la primera expresión se evalúa y es TRUE, entonces la segunda expresión no se evalúa en absoluto. Puede ser útil si la segunda expresión tiene como resultado un error cuando la primera expresión es TRUE, porque la segunda expresión, en este caso, nunca se evalúa.

THEN

SintaxisIF <test1> THEN <then1>
[ELSEIF <test2> THEN <then2>...]
[ELSE <default>]
END
DefiniciónUna parte requerida de una expresión IF, ELSEIF o CASE, utilizada para definir qué resultado devolver si un valor o prueba específica es true.
Ejemplo
IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots'
ELSE 'Sneakers' 
END

"Si Estación = Verano, devolverá Sandalias. Si no, mire la siguiente expresión. Si Estación = Invierno, devolverá Botas. Si ninguna de las expresiones es true, devolverá Zapatillas".

CASE [Season] 
WHEN 'Summer' THEN 'Sandals'
WHEN 'Winter' THEN 'Boots'
ELSE 'Sneakers'
END

"Mire el campo Estación. Si el valor es Verano, devolverá Sandalias. Si el valor es Invierno, devolverá Botas. Si ninguna de las opciones del cálculo coincide con lo que hay en el campo Estación, devolverá Zapatillas".

Notas

Usado con CASE, WHEN, IF, ELSEIF, THEN, ELSE y END

WHEN

SintaxisCASE <expression>
WHEN <value1> THEN <then1>
WHEN <value2> THEN <then2>
...
[ELSE <default>]
END
DefiniciónUna parte requerida de una expresión CASE. Encuentra el primer <value> que coincide con la <expression> y devuelve el <then> correspondiente.
Ejemplo
CASE [Season] 
WHEN 'Summer' THEN 'Sandals'
WHEN 'Winter' THEN 'Boots'
ELSE 'Sneakers'
END

"Mire el campo Estación. Si el valor es Verano, devolverá Sandalias. Si el valor es Invierno, devolverá Botas. Si ninguna de las opciones del cálculo coincide con lo que hay en el campo Estación, devolverá Zapatillas".

Notas

Usado con CASE, THEN, ELSE y END.

CASE también admite construcciones WHEN IN, tales como:

CASE <expression> 
WHEN IN <set1> THEN <then1>
WHEN IN <combinedfield> THEN <then2>
...
ELSE <default>
END

Los valores que compara WHEN IN deben ser un conjunto, una lista de valores literales o un campo combinado. Consulte también IN.

ZN

SintaxisZN(expression)
ResultadoDepende del tipo de datos de la <expression>, o 0.
DefiniciónDevuelve <expression> si no es null, de lo contrario, devuelve cero.
Ejemplo
ZN([Test Grade])

"Si la calificación de la prueba no es null, devolverá su valor. Si la calificación de la prueba es null, devolverá 0".

Notas

ZN es un caso especializado de IFNULL donde la alternativa si la expresión es null es siempre 0 en lugar de especificarse en el cálculo.

ZN es especialmente útil cuando se realizan cálculos adicionales y un valor null haría que todo el cálculo fuera null. Pero tenga cuidado al interpretar estos resultados, null no siempre es sinónimo de 0 y podría representar datos que faltan.

Consulte también ISNULL.

Funciones de agregación

ATTR

SintaxisATTR(expression)
DefiniciónIndica el valor de la expresión si tiene un valor individual para todas las filas. De lo contrario, indica un asterisco. Se ignoran los valores nulos.

AVG

SintaxisAVG(expression)
DefiniciónIndica el promedio de todos los valores de la expresión. Se ignoran los valores nulos.
NotasAVG solo puede utilizarse con campos numéricos.

COLLECT

SintaxisCOLLECT(spatial)
DefiniciónUn cálculo agregado que combina los valores del campo del argumento. Se ignoran los valores nulos.
NotasCOLLECT solo puede utilizarse con campos espaciales.

CORR

SintaxisCORR(expression1, expression2)
ResultadoNúmero de -1 a 1
DefiniciónIndica el coeficiente de correlación de Pearson de dos expresiones.
Ejemplo
example
Notas

La correlación de Pearson mide la relación lineal entre dos variables. Los resultados oscilan entre -1 y +1 (ambos incluidos), donde 1 indica una relación lineal positiva exacta, 0 indica que no hay ninguna relación lineal entre la varianza y −1 es una relación negativa exacta.

El cuadrado de un resultado de CORR es equivalente al valor R cuadrado de un modelo de línea de tendencia lineal. Consulte Términos del modelo de línea de tendencia(El enlace se abre en una ventana nueva).

Utilizar con expresiones LOD con ámbito de tabla:

Puede utilizar CORR para visualizar la correlación en una dispersión desagregada mediante una expresión de nivel de detalle con ámbito de tabla(El enlace se abre en una ventana nueva). Por ejemplo:

{CORR(Sales, Profit)}

Con una expresión de nivel de detalle, la correlación se aplica a todas las filas. Si ha utilizado una fórmula como CORR(Sales, Profit) (sin los paréntesis circundantes para convertirla en una expresión de nivel de detalle), la vista mostraría la correlación de cada punto del diagrama de dispersión con el resto de los puntos, que son indefinidos.

Limitaciones de la base de datos

CORR está disponible con las siguientes fuentes de datos: extracciones de datos de Tableau, Cloudera Hive, EXASolution, Firebird (versión 3.0 y posteriores), Google BigQuery, Hortonworks Hadoop Hive, IBM PDA (Netezza), Oracle, PostgreSQL, Presto, SybaseIQ, Teradata, Vertica.

En cuanto a otras fuentes de datos, plantéese la posibilidad de extraer los datos o de utilizar WINDOW_CORR. Consulte Funciones de cálculo de tablas(El enlace se abre en una ventana nueva).

COUNT

SintaxisCOUNT(expression)
DefiniciónIndica el número de elementos. No se cuentan los valores nulos.

COUNTD

SintaxisCOUNTD(expression)
DefiniciónIndica el número de elementos definidos en un grupo. No se cuentan los valores nulos.

COVAR

SintaxisCOVAR(expression1, expression2)
DefiniciónIndica la covarianza de muestra de dos expresiones.
Notas

La covarianza cuantifica cómo varían conjuntamente dos variables. Una covarianza positiva indica que las variables tienden a desplazarse hacia la misma dirección, como cuando los valores altos de una variable tienden a corresponderse con valores altos de la otra variable, como promedio. La covarianza de muestra utiliza el número de puntos de datos no nulos n - 1 para normalizar el cálculo de la covarianza, en vez de utilizar n, que se utiliza en la covarianza de población (disponible en la función COVARP). La covarianza de muestra es la opción adecuada si los datos representan una muestra aleatoria utilizada para estimar la covarianza de una población elevada.

Si <expression1> y <expression2> son iguales (por ejemplo, COVAR([profit], [profit])), COVAR indica un valor que especifica el alcance de la distribución de los valores.

El valor de COVAR(X, X) es equivalente al valor de VAR(X) y al valor de STDEV(X)^2.

Limitaciones de la base de datos

COVAR está disponible con las siguientes fuentes de datos: extracciones de datos de Tableau, Cloudera Hive, EXASolution, Firebird (versión 3.0 y posteriores), Google BigQuery, Hortonworks Hadoop Hive, IBM PDA (Netezza), Oracle, PostgreSQL, Presto, SybaseIQ, Teradata, Vertica.

En cuanto a otras fuentes de datos, plantéese la posibilidad de extraer los datos o de utilizar WINDOW_COVAR. Consulte Funciones de cálculo de tablas(El enlace se abre en una ventana nueva).

COVARP

SintaxisCOVARP(expression 1, expression2)
DefiniciónIndica la covarianza de población de dos expresiones.
Notas

La covarianza cuantifica cómo varían conjuntamente dos variables. Una covarianza positiva indica que las variables tienden a desplazarse hacia la misma dirección, como cuando los valores altos de una variable tienden a corresponderse con valores altos de la otra variable, como promedio. La covarianza de población es la covarianza de muestra multiplicada por (n-1)/n, donde n es el número total de puntos de datos no nulos. La covarianza de población es la opción adecuada si hay datos disponibles para todos los elementos de interés, a diferencia de cuando solo hay un subconjunto aleatorio de elementos, en cuyo caso se recomienda utilizar la covarianza de muestra (con la función COVAR).

Si <expression1> y <expression2> son iguales (por ejemplo, COVARP([profit], [profit])), COVARP indica un valor que especifica el alcance de la distribución de los valores. Nota: El valor de COVARP(X, X) es equivalente al valor de VARP(X) y al valor de STDEVP(X)^2.

Limitaciones de la base de datos

COVARP está disponible con las siguientes fuentes de datos: extracciones de datos de Tableau, Cloudera Hive, EXASolution, Firebird (versión 3.0 y posteriores), Google BigQuery, Hortonworks Hadoop Hive, IBM PDA (Netezza), Oracle, PostgreSQL, Presto, SybaseIQ, Teradata, Vertica

En cuanto a otras fuentes de datos, plantéese la posibilidad de extraer los datos o de utilizar WINDOW_COVAR. Consulte Funciones de cálculo de tablas(El enlace se abre en una ventana nueva).

MAX

SintaxisMAX(expression) o MAX(expr1, expr2)
ResultadoEl mismo tipo de datos que el argumento, o NULL  si alguna parte del argumento es nula.
Definición

Indica el máximo de dos argumentos, los cuales deben ser del mismo tipo de datos.

MAX se puede aplicar también a un solo campo como una agregación.

Ejemplo
MAX(4,7) = 7
MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021#
MAX([Name]) = "Zander"
Notas

Para cadenas

MAX suele ser el valor que aparece en último lugar en orden alfabético.

Para las fuentes de datos de bases de datos, el valor de cadena MAX es el valor más alto en la secuencia de orden definido por la base de datos para esta columna.

Para fechas

Para las fechas, MAX es la fecha más reciente. Si MAX es una agregación, el resultado no tendrá una jerarquía de fechas. Si MAX es una comparación, el resultado conservará la jerarquía de fechas.

Como agregación

MAX(expression) es una función agregada y devuelve un solo resultado agregado. Se muestra como AGG(expression) en la visualización.

Como comparación

MAX(expr1, expr2) compara los dos valores y devuelve un valor de nivel de fila.

Consulte también MIN.

MEDIAN

SintaxisMEDIAN(expression)
DefiniciónIndica la mediana de una expresión en todos los registros. Se ignoran los valores nulos.
NotasMEDIAN solo puede utilizarse con campos numéricos.
Limitaciones de la base de datos

MEDIAN no está disponible para las siguientes fuentes de datos: Access, Amazon Redshift, Cloudera Hadoop, HP Vertica, IBM DB2, IBM PDA (Netezza), Microsoft SQL Server, MySQL, SAP HANA, Teradata.

En el caso de otros tipos de fuentes de datos, los datos se pueden extraer en un archivo de extracción para usar esta función. Consulte Extraer los datos(El enlace se abre en una ventana nueva).

MIN

SintaxisMIN(expression) o MIN(expr1, expr2)
ResultadoEl mismo tipo de datos que el argumento, o NULL  si alguna parte del argumento es nula.
Definición

Indica el mínimo de dos argumentos, los cuales deben ser del mismo tipo de datos.

MIN se puede aplicar también a un solo campo como una agregación.

Ejemplo
MIN(4,7) = 4
MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986#
MIN([Name]) = "Abebi"
Notas

Para cadenas

MIN suele ser el valor que aparece en primer lugar en orden alfabético.

Para las fuentes de datos de bases de datos, el valor de cadena MIN es el valor más bajo en la secuencia de orden definido por la base de datos para esta columna.

Para fechas

Para las fechas, MIN es la fecha más anterior. Si MIN es una agregación, el resultado no tendrá una jerarquía de fechas. Si MIN es una comparación, el resultado conservará la jerarquía de fechas.

Como agregación

MIN(expression) es una función agregada y devuelve un solo resultado agregado. Se muestra como AGG(expression) en la visualización.

Como comparación

MIN(expr1, expr2) compara los dos valores y devuelve un valor de nivel de fila.

Consulte también MAX.

PERCENTILE

SintaxisPERCENTILE(expression, number)
DefiniciónIndica el valor de percentil de la expresión determinada correspondiente al <number> especificado. <number> debe oscilar entre 0 y 1 (incluido), así como ser una constante numérica.
Ejemplo
PERCENTILE([Score], 0.9)
Limitaciones de la base de datos

Esta función está disponible para las siguientes fuentes de datos: conexiones de archivos de texto y de Microsoft Excel no heredadas, tipos de fuentes de datos de extracción y de solo extracciones (por ejemplo, Google Analytics, OData o Salesforce), fuentes de datos de Sybase IQ 15.1 y posteriores, fuentes de datos de Oracle 10 y posteriores, fuentes de datos de Cloudera Hive y Hortonworks Hadoop Hive, fuentes de datos de EXASolution 4.2 y posteriores.

En el caso de otros tipos de fuentes de datos, los datos se pueden extraer en un archivo de extracción para usar esta función. Consulte Extraer los datos(El enlace se abre en una ventana nueva).

STDEV

SintaxisSTDEV(expression)
DefiniciónIndica la desviación estándar estadística de todos los valores en la expresión dada basado en una muestra de la población.

STDEVP

SintaxisSTDEVP(expression)
DefiniciónIndica la desviación estándar estadística de todos los valores en la expresión dada en base a una población parcial.

SUM

SintaxisSUM(expression)
DefiniciónIndica la suma de todos los valores de la expresión. Se ignoran los valores nulos.
NotasSUM solo puede utilizarse con campos numéricos.

VAR

SintaxisVAR(expression)
DefiniciónIndica la discordancia estadística de todos los valores en la expresión dada basado en una muestra de la población.

VARP

SintaxisVARP(expression)
DefiniciónIndica la discordancia estadística de todos los valores en la expresión dada de toda la población.
Funciones de usuario

FULLNAME( )

SintaxisFULLNAME( )
ResultadoCadena
Definición

Indica el nombre completo del usuario actual.

Ejemplo
FULLNAME( )

Esto devuelve el nombre completo del usuario que ha iniciado sesión, como "Hamlin Myrer".

[Manager] = FULLNAME( )

Si el gerente "Hamlin Myrer" inició sesión, este ejemplo solo devolverá el valor TRUE si el campo Gerente de la vista contiene la cadena "Hamlin Myrer".

Notas

Esta función comprueba:

  • Tableau Cloud y Tableau Server: el nombre completo del usuario que ha iniciado sesión
  • Tableau Desktop: el nombre completo local o de red para el usuario

Filtros de usuario

Cuando se usa como filtro, un campo calculado, como [Username field] = FULLNAME( ), puede usarse para crear un filtro de usuarios que solo muestre datos importantes para la persona que inició sesión en el servidor.

ISFULLNAME

SintaxisISFULLNAME("User Full Name")
ResultadoBooleano
Definición

Devuelve TRUE si el nombre completo del usuario actual coincide con el nombre completo especificado, o FALSE si no coincide.

Ejemplo
ISFULLNAME("Hamlin Myrer")
Notas

La expresión <"User Full Name"> debe ser una cadena literal y no un campo.

Esta función comprueba:

  • Tableau Cloud y Tableau Server: el nombre completo del usuario que ha iniciado sesión
  • Tableau Desktop: el nombre completo local o de red para el usuario

ISMEMBEROF

SintaxisISMEMBEROF("Group Name")
ResultadoBooleano o null
Definición

Devuelve TRUE si la persona que está usando Tableau es miembro de un grupo que coincide con la cadena dada, FALSE si no es miembro, y NULL si no han iniciado sesión.

Ejemplo
ISMEMBEROF('Superstars')
ISMEMBEROF('domain.lan\Sales')
Notas

La expresión <"Group Full Name"> debe ser una cadena literal y no un campo.

Si el usuario ha iniciado sesión en Tableau Cloud o Tableau Server, la membresía del grupo la determinan los grupos de Tableau. La función devolverá TRUE si la cadena dada es "Todos los usuarios"

La función ISMEMBEROF( ) también aceptará dominios de Active Directory. El dominio de Active Directory debe declararse en el cálculo con el nombre del grupo.

Si se realiza un cambio en la pertenencia al grupo de un usuario, el cambio en los datos que se basan en la pertenencia al grupo se refleja en un libro de trabajo o vista con una nueva sesión. La sesión existente reflejará datos obsoletos.

ISUSERNAME

SintaxisISUSERNAME("username")
ResultadoBooleano
DefiniciónIndica TRUE si el nombre del usuario actual coincide con el nombre del usuario especificado. Si no coincide, indicará FALSE.
Ejemplo
ISUSERNAME("hmyrer")
Notas

La expresión <"username"> debe ser una cadena literal y no un campo.

Esta función comprueba:

  • Tableau Cloud y Tableau Server: el nombre del usuario que ha iniciado sesión
  • Tableau Desktop: el nombre de usuario local o de red para el usuario

USERDOMAIN( )

SintaxisUSERDOMAIN( )
ResultadoCadena
DefiniciónDevuelve el dominio del usuario actual.
Notas

Esta función comprueba:

  • Tableau Cloud y Tableau Server: el dominio de usuario del usuario que inició sesión
  • Tableau Desktop: el dominio local si el usuario se encuentra en un dominio

USERNAME( )

SintaxisUSERNAME( )
ResultadoCadena
DefiniciónIndica el nombre de usuario del usuario actual.
Ejemplo
USERNAME( )

Esto devuelve el nombre del usuario que ha iniciado sesión, como “hmyrer”.

[Manager] = USERNAME( )

Si el gerente "hmyrer" inició sesión, este ejemplo solo devolverá el valor TRUE si el campo Gerente de la vista contiene la cadena "hmyrer".

Notas

Esta función comprueba:

  • Tableau Cloud y Tableau Server: el nombre del usuario que ha iniciado sesión
  • Tableau Desktop: el nombre de usuario local o de red para el usuario

Filtros de usuario

Cuando se usa como filtro, un campo calculado, como [Username field] = USERNAME( ), puede usarse para crear un filtro de usuarios que solo muestre datos importantes para la persona que inició sesión en el servidor.

USERATTRIBUTE

Nota: Antes de utilizar esta función, consulte Solo para insertar flujos de trabajo en Tableau Cloud. Para obtener más información, consulte Autenticación y vistas insertadas.(El enlace se abre en una ventana nueva) en la ayuda de la API de inserción v3.

SintaxisUSERATTRIBUTE('attribute_name')
ResultadoCadena o valor nulo
Definición

Si <'attribute_name'> es parte del token web JSON (JWT) pasado a Tableau, el cálculo devuelve el primer valor de <'attribute_name'>.

Devuelve NULL si <'attribute_name'> no existe.

Ejemplo

Supongamos que “Region” es el atributo de usuario que se incluye en el JWT y se pasa a Tableau (mediante la aplicación conectada que ya configuró el administrador de su sitio).

Como autor del libro de trabajo, puede configurar su visualización para filtrar datos según una región específica. En ese filtro, puede hacer referencia al siguiente cálculo.

[Region] = USERATTRIBUTE("Region")

Cuando User2, de la región oeste, ve la visualización insertada, Tableau muestra los datos apropiados solo para la región oeste.

NotasPuede usar la función USERATTRIBUTEINCLUDES si espera que <'attribute_name'> devuelva varios valores.

USERATTRIBUTEINCLUDES

Nota: Antes de utilizar esta función, consulte Solo para insertar flujos de trabajo en Tableau Cloud. Para obtener más información, consulte Autenticación y vistas insertadas.(El enlace se abre en una ventana nueva) en la ayuda de la API de inserción v3.

SintaxisUSERATTRIBUTEINCLUDES('attribute_name', 'expected_value')
ResultadoBooleano
Definición

Devuelve TRUE si las siguientes condiciones son True:

  • <'attribute_name'> es parte del token web JSON (JWT) pasado a Tableau
  • Uno de los valores <'attribute_name'> es igual a <'expected_value'> .

De lo contrario, indica FALSE.

Ejemplo

Supongamos que “Region” es el atributo de usuario que se incluye en el JWT y se pasa a Tableau (mediante la aplicación conectada que ya configuró el administrador de su sitio).

Como autor del libro de trabajo, puede configurar su visualización para filtrar datos según una región específica. En ese filtro, puede hacer referencia al siguiente cálculo.

USERATTRIBUTEINCLUDES('Region', [Region])

Si User2, de la región oeste, accede a la visualización insertada, Tableau verifica si el atributo de usuario Region coincide con uno de los valores del campo [Region]. Cuando es True, la visualización muestra los datos apropiados.

Cuando User3, de la región norte, accede a la misma visualización, no puede ver ningún dato porque no hay coincidencia con los valores del campo [Region].

Cálculos de tablas

FIRST( )


Indica el número de filas desde la fila actual a la primera fila en la participación. Por ejemplo, la siguiente vista muestra ventas por trimestre. Cuando se calcula FIRST() dentro de la división Fecha, la compensación de la primera fila con la segunda fila es -1.

Ejemplo

Cuando el índice de la fila actual es 3, FIRST() = -2.

INDEX( )


Indica el índice de la fila actual en la división sin ordenar con respecto al valor. El índice de la primera fila comienza en 1. Por ejemplo, la siguiente tabla muestra ventas por trimestre. Cuando se calcula INDEX() dentro de la división Fecha, el índice de cada fila es 1, 2, 3, 4..., etc.

Ejemplo

Para la tercera fila de la división, INDEX() = 3.

LAST( )


Indica el número de filas desde la fila actual a la última fila de la división. Por ejemplo, la siguiente tabla muestra ventas por trimestre. Cuando se calcula LAST() dentro de la división Fecha, la compensación de la última fila con la segunda fila es 5.

Ejemplo

Cuando el índice de la fila actual es 3 de 7, LAST() = 4.

LOOKUP(expression, [offset])


Indica el valor de la expresión en una fila objetivo, especificada como compensación relativa desde la fila actual. Use FIRST() + n y LAST() - n como parte de su definición de compensación para un objetivo en relación con la primera/última fila en la división. Si se omite offset, la fila Comparar con debe configurarse en el menú de campo. Esta función indica NULL si la fila objetivo no se puede determinar.

La siguiente vista muestra ventas por trimestre. Cuando se calcula LOOKUP (SUM(Sales), 2) dentro de la división Fecha, cada fila muestra el valor de ventas de 2 trimestres en el futuro.

Ejemplo

LOOKUP(SUM([Profit]), FIRST()+2) calcula la SUM(Profit) en la tercera fila de la división.

Funciones MODEL_EXTENSION

Las funciones de extensión del modelo:

  • MODEL_EXTENSION_BOOL

  • MODEL_EXTENSION_INT

  • MODEL_EXTENSION_REAL

  • MODEL_EXTENSION_STRING

se utilizan para pasar datos a un modelo implementado en un servicio externo como R, TabPy o Matlab. Consulte Extensiones de análisis(El enlace se abre en una ventana nueva).

MODEL_PERCENTILE(target_expression, predictor_expression(s))


Devuelve la probabilidad (entre 0 y 1) de que el valor esperado sea menor o igual que la marca observada, definida por la expresión de destino y otros predictores. Esta es la función de distribución predictiva posterior, también conocida como función de distribución acumulativa (CDF).

Esta función es la inversa de MODEL_QUANTILE. Para obtener información sobre las funciones de modelado predictivo, consulte Funciones de modelado predictivo en Tableau.

Ejemplo

La siguiente fórmula devuelve el cuantil de la marca para la suma de ventas, ajustado para el recuento de pedidos.

MODEL_PERCENTILE(SUM([Sales]), COUNT([Orders]))

MODEL_QUANTILE(quantile, target_expression, predictor_expression(s))


Devuelve un valor numérico de destino dentro del intervalo probable definido por la expresión de destino y otros predictores, en un cuantil especificado. Este es el cuantil predictivo posterior.

Esta función es la inversa de MODEL_PERCENTILE. Para obtener información sobre las funciones de modelado predictivo, consulte Funciones de modelado predictivo en Tableau.

Ejemplo

La siguiente fórmula devuelve la suma media (0,5) de ventas prevista, ajustada para el recuento de pedidos.

MODEL_QUANTILE(0.5, SUM([Sales]), COUNT([Orders]))

PREVIOUS_VALUE(expression)


Indica el valor de este cálculo en la fila anterior. Indica la expresión dada si la fila actual es la primera fila de la división.

Ejemplo

SUM([Profit]) * PREVIOUS_VALUE(1) calcula el producto en ejecución de SUM(Profit).

RANK(expression, ['asc' | 'desc'])


Indica la clasificación de jerarquía para la competencia estándar para la fila actual en la división. Se asignan valores idénticos a clasificaciones distintas. Use el argumento 'asc' | 'desc' opcional para especificar un orden ascendente o descendente. El valor predeterminado es descendente.

Con esta función, el conjunto de valores (6, 9, 9, 14) se clasificaría como (4, 2, 2, 1).

Los valores nulos se ignoran en las funciones de clasificación. No se enumeran y no se cuentan contra el número total de registros en los cálculos de clasificación de percentil.

Para obtener información sobre las diferentes opciones de clasificación, consulte Cálculo Clasificación.

Ejemplo

La siguiente imagen muestra el efecto de las distintas funciones de clasificación (RANK, RANK_DENSE, RANK_MODIFIED, RANK_PERCENTILE y RANK_UNIQUE) en un conjunto de valores. El conjunto de datos contiene información de 14 estudiantes (de StudentA a StudentN); la columna Edad muestra la edad actual de cada estudiante (todos tienen entre 17 y 20 años). Las demás columnas muestran el efecto de cada función de clasificación en el conjunto de valores de edad; en todas se emplea el orden predeterminado (ascendente o descendente) para la función.

RANK_DENSE(expression, ['asc' | 'desc'])


Indica la clasificación densa para la fila actual de la división. Se asignan valores idénticos a una clasificación idéntica, pero no se insertan espacios en la secuencia numérica. Use el argumento 'asc' | 'desc' opcional para especificar un orden ascendente o descendente. El valor predeterminado es descendente.

Con esta función, el conjunto de valores (6, 9, 9, 14) se clasificaría como (3, 2, 2, 1).

Los valores nulos se ignoran en las funciones de clasificación. No se enumeran y no se cuentan contra el número total de registros en los cálculos de clasificación de percentil.

Para obtener información sobre las diferentes opciones de clasificación, consulte Cálculo Clasificación.

RANK_MODIFIED(expression, ['asc' | 'desc'])


Indica la clasificación de competencia modificada para la fila actual de la división. Se asignan valores idénticos a clasificaciones distintas. Use el argumento 'asc' | 'desc' opcional para especificar un orden ascendente o descendente. El valor predeterminado es descendente.

Con esta función, el conjunto de valores (6, 9, 9, 14) se clasificaría como (4, 3, 3, 1).

Los valores nulos se ignoran en las funciones de clasificación. No se enumeran y no se cuentan contra el número total de registros en los cálculos de clasificación de percentil.

Para obtener información sobre las diferentes opciones de clasificación, consulte Cálculo Clasificación.

RANK_PERCENTILE(expression, ['asc' | 'desc'])


Indica la clasificación de percentil para la fila actual de la división. Use el argumento 'asc' | 'desc' opcional para especificar un orden ascendente o descendente. El valor predeterminado es ascendente.

Con esta función, el conjunto de valores (6, 9, 9, 14) se clasificaría como (0.00, 0.67, 0.67, 1.00).

Los valores nulos se ignoran en las funciones de clasificación. No se enumeran y no se cuentan contra el número total de registros en los cálculos de clasificación de percentil.

Para obtener información sobre las diferentes opciones de clasificación, consulte Cálculo Clasificación.

RANK_UNIQUE(expression, ['asc' | 'desc'])


Indica la clasificación única para la fila actual de la división. Se asignan valores idénticos a clasificaciones idénticas. Use el argumento 'asc' | 'desc' opcional para especificar un orden ascendente o descendente. El valor predeterminado es descendente.

Con esta función, el conjunto de valores (6, 9, 9, 14) se clasificaría como (4, 2, 3, 1).

Los valores nulos se ignoran en las funciones de clasificación. No se enumeran y no se cuentan contra el número total de registros en los cálculos de clasificación de percentil.

Para obtener información sobre las diferentes opciones de clasificación, consulte Cálculo Clasificación.

RUNNING_AVG(expression)


Indica el promedio de ejecución de la expresión dada, desde la primera fila de la división hasta la fila actual.

La siguiente vista muestra ventas por trimestre. Cuando se calcula RUNNING_AVG(SUM([Sales]) dentro de la división Fecha, el resultado es un promedio móvil de los valores de venta de cada trimestre.

Ejemplo

RUNNING_AVG(SUM([Profit])) calcula el promedio de ejecución de SUM(Profit).

RUNNING_COUNT(expression)


Indica el conteo de ejecución de la expresión dada, desde la primera fila de la división hasta la fila actual.

Ejemplo

RUNNING_COUNT(SUM([Profit])) calcula el conteo de ejecución de SUM(Profit).

RUNNING_MAX(expression)


Indica el máximo de ejecución de la expresión dada, desde la primera fila de la división hasta la fila actual.

Ejemplo

RUNNING_MAX(SUM([Profit])) calcula el máximo de ejecución de SUM(Profit).

RUNNING_MIN(expression)


Indica el mínimo de ejecución de la expresión dada, desde la primera fila de la división hasta la fila actual.

Ejemplo

RUNNING_MIN(SUM([Profit])) calcula el mínimo de ejecución de SUM(Profit).

RUNNING_SUM(expression)


Indica la suma de ejecución de la expresión dada, desde la primera fila de la división hasta la fila actual.

Ejemplo

RUNNING_SUM(SUM([Profit])) calcula la suma de ejecución de SUM(Profit)

SIZE()


Indica el número de filas que hay en la división. Por ejemplo, la siguiente vista muestra ventas por trimestre. En la división Fecha, hay siete filas, por lo que el Size() de la división Fecha es 7.

Ejemplo

SIZE() = 5 cuando la división actual contiene cinco filas.

Funciones SCRIPT_

Las funciones del script:

  • SCRIPT_BOOL

  • SCRIPT_INT

  • SCRIPT_REAL

  • SCRIPT_STRING

se utilizan para pasar datos a un servicio externo como R, TabPy o Matlab. Consulte Extensiones de análisis(El enlace se abre en una ventana nueva).

TOTAL(expression)


Indica el total para la expresión dada en una división de cálculo de tablas.

Ejemplo

Supongamos que partimos de esta vista:

Abrimos el editor de cálculos y creamos un campo nuevo con el nombre Totalidad:

Luego colocamos Totalidad en Texto para reemplazar SUM(Ventas). La vista cambia y suma los valores basados en el valor predeterminado de Computar usando:

Esto suscita una cuestión: ¿qué es el valor predeterminado de Computar usando? Al hacer clic con el botón derecho (Control + clic en un Mac) en Totalidad en el panel Datos y elegir Editar, aparece un dato nuevo adicional:

El valor predeterminado de Computar usando es Tabla (a lo largo). El resultado es que Totalidad suma los valores de cada fila de la tabla. Por lo tanto, el valor que vemos en cada fila es la suma de los valores de la versión original de la tabla.

Los valores de la fila 2011/Q1 en la tabla original eran 8601 $, 6579 $, 44 262 $ y 15 006 $. Los valores que hay en la tabla después de reemplazar SUM(Ventas) por Totalidad son todos 74 448 $, que es la suma de los valores originales.

Fíjese en el triángulo que aparece junto a Totalidad después de colocarlo en Texto:

Esto indica que este campo usa un cálculo de tablas. Puede hacer clic con el botón derecho en el campo y elegir Editar cálculo de tablas para redirigir la función a otro valor de Computar usando. Por ejemplo, lo puede establecer en Tabla (vertical). En este caso, la tabla tendría este aspecto:

TOTAL(expression)


Indica el total para la expresión dada en una división de cálculo de tablas.

Ejemplo

Supongamos que partimos de esta vista:

Abrimos el editor de cálculos y creamos un campo nuevo con el nombre Totalidad:

Luego colocamos Totalidad en Texto para reemplazar SUM(Ventas). La vista cambia y suma los valores basados en el valor predeterminado de Computar usando:

Esto suscita una cuestión: ¿qué es el valor predeterminado de Computar usando? Al hacer clic con el botón derecho (Control + clic en un Mac) en Totalidad en el panel Datos y elegir Editar, aparece un dato nuevo adicional:

El valor predeterminado de Computar usando es Tabla (a lo largo). El resultado es que Totalidad suma los valores de cada fila de la tabla. Por lo tanto, el valor que vemos en cada fila es la suma de los valores de la versión original de la tabla.

Los valores de la fila 2011/Q1 en la tabla original eran 8601 $, 6579 $, 44 262 $ y 15 006 $. Los valores que hay en la tabla después de reemplazar SUM(Ventas) por Totalidad son todos 74 448 $, que es la suma de los valores originales.

Fíjese en el triángulo que aparece junto a Totalidad después de colocarlo en Texto:

Esto indica que este campo usa un cálculo de tablas. Puede hacer clic con el botón derecho en el campo y elegir Editar cálculo de tablas para redirigir la función a otro valor de Computar usando. Por ejemplo, lo puede establecer en Tabla (vertical). En este caso, la tabla tendría este aspecto:

WINDOW_CORR(expression1, expression2, [start, end])


Indica el coeficiente de correlación de Pearson de dos expresiones en la ventana. La ventana se define como compensaciones de la fila actual. Use FIRST()+n y LAST()-n para compensaciones de la primera o última fila de la división. Si se omite el comienzo y el final, se utiliza la división completa.

La correlación de Pearson mide la relación lineal entre dos variables. Los resultados oscilan entre -1 y +1 (ambos incluidos), donde 1 indica una relación lineal positiva exacta, como cuando un cambio positivo en una variable implica un cambio positivo de la magnitud correspondiente en el otro; 0 indica que no hay ninguna relación lineal entre la varianza y −1 es una relación negativa exacta.

Existe una función de agregación equivalente: CORR. Consulte Funciones de Tableau (alfabéticamente)(El enlace se abre en una ventana nueva).

Ejemplo

La siguiente fórmula indica la correlación de Pearson de SUM(Profit) y SUM(Sales) desde las cinco filas anteriores hasta la fila actual.

WINDOW_CORR(SUM[Profit]), SUM([Sales]), -5, 0)

WINDOW_COUNT(expression, [start, end])


Indica el conteo de la expresión dentro de la ventana. La ventana se define mediante las compensaciones de la fila actual. Use FIRST()+n y LAST()-n para compensaciones de la primera o última fila de la división. Si se omite el comienzo y el final, se usa la división completa.

Ejemplo

WINDOW_COUNT(SUM([Profit]), FIRST()+1, 0) calcula el conteo de SUM(Profit) desde la segunda fila hasta la actual

WINDOW_COVAR(expression1, expression2, [start, end])


Indica la covarianza de muestra de dos expresiones en la ventana. La ventana se define como compensaciones de la fila actual. Use FIRST()+n y LAST()-n para compensaciones de la primera o última fila de la división. Si se omiten los argumentos inicial y final, la ventana será la división completa.

La covarianza de muestra utiliza el número de puntos de datos no nulos n - 1 para normalizar el cálculo de la covarianza, en vez de utilizar n, que se utiliza en la covarianza de población (con la función WINDOW_COVARP). La covarianza de muestra es la opción adecuada si los datos representan una muestra aleatoria utilizada para estimar la covarianza de una población elevada.

Existe una función de agregación equivalente: COVAR. Consulte Funciones de Tableau (alfabéticamente)(El enlace se abre en una ventana nueva).

Ejemplo

La siguiente fórmula indica la covarianza de muestra de SUM(Profit) y SUM(Sales) desde las dos filas anteriores hasta la fila actual.

WINDOW_COVAR(SUM([Profit]), SUM([Sales]), -2, 0)

WINDOW_COVARP(expression1, expression2, [start, end])


Indica la covarianza de población de dos expresiones en la ventana. La ventana se define como compensaciones de la fila actual. Use FIRST()+n y LAST()-n para compensaciones de la primera o última fila de la división. Si se omite el comienzo y el final, se utiliza la división completa.

La covarianza de población es la covarianza de muestra multiplicada por (n-1)/n, donde n es el número total de puntos de datos no nulos. La covarianza de población es la opción adecuada si hay datos disponibles para todos los elementos de interés, a diferencia de cuando solo hay un subconjunto aleatorio de elementos, en cuyo caso se recomienda utilizar la covarianza de muestra (con la función WINDOW_COVAR).

Existe una función de agregación equivalente: COVARP. Funciones de Tableau (alfabéticamente)(El enlace se abre en una ventana nueva).

Ejemplo

La siguiente fórmula indica la covarianza de población de SUM(Profit) y SUM(Sales) desde las dos filas anteriores hasta la fila actual.

WINDOW_COVARP(SUM([Profit]), SUM([Sales]), -2, 0)

WINDOW_MEDIAN(expression, [start, end])


Indica la mediana de la expresión dentro de la ventana. La ventana se define mediante las compensaciones de la fila actual. Use FIRST()+n y LAST()-n para compensaciones de la primera o última fila de la división. Si se omite el comienzo y el final, se usa la división completa.

Por ejemplo, la siguiente vista muestra las ganancias trimestrales. Una mediana de ventana en la división Fecha indica las ganancias medias en todas las fechas.

Ejemplo

WINDOW_MEDIAN(SUM([Profit]), FIRST()+1, 0) calcula la mediana de SUM(Profit) desde la segunda fila hasta la actual.

WINDOW_MAX(expression, [start, end])


Indica el máximo de la expresión dentro de la ventana. La ventana se define mediante las compensaciones de la fila actual. Use FIRST()+n y LAST()-n para compensaciones de la primera o última fila de la división. Si se omite el comienzo y el final, se usa la división completa.

Por ejemplo, la siguiente vista muestra ventas por trimestre. Un máximo de ventana en la división Fecha indica las ventas máximas en todas las fechas.

Ejemplo

WINDOW_MAX(SUM([Profit]), FIRST()+1, 0) calcula el máximo de SUM(Profit) desde la segunda fila hasta la actual.

WINDOW_MIN(expression, [start, end])


Indica el mínimo de la expresión dentro de la ventana. La ventana se define mediante las compensaciones de la fila actual. Use FIRST()+n y LAST()-n para compensaciones de la primera o última fila de la división. Si se omite el comienzo y el final, se usa la división completa.

Por ejemplo, la siguiente vista muestra ventas por trimestre. Un mínimo de ventana en la división Fecha indica las ventas mínimas en todas las fechas.

Ejemplo

WINDOW_MIN(SUM([Profit]), FIRST()+1, 0) calcula el mínimo de SUM(Profit) desde la segunda fila hasta la actual.

WINDOW_PERCENTILE(expression, number, [start, end])


Indica el valor que corresponde al percentil especificado en la ventana. La ventana se define mediante las compensaciones de la fila actual. Use FIRST()+n y LAST()-n para compensaciones de la primera o última fila de la división. Si se omite el comienzo y el final, se usa la división completa.

Ejemplo

WINDOW_PERCENTILE(SUM([Profit]), 0.75, -2, 0) indica el percentil n.º 75 de SUM(Profit) desde las dos filas anteriores hasta la actual.

WINDOW_STDEV(expression, [start, end])


Indica la desviación estándar de muestra de la expresión dentro de la ventana. La ventana se define mediante las compensaciones de la fila actual. Use FIRST()+n y LAST()-n para compensaciones de la primera o última fila de la división. Si se omite el comienzo y el final, se usa la división completa.

Ejemplo

WINDOW_STDEV(SUM([Profit]), FIRST()+1, 0) calcula la desviación estándar de SUM(Profit) desde la segunda fila hasta la actual.

WINDOW_STDEVP(expression, [start, end])


Indica la desviación estándar parcial de la expresión dentro de la ventana. La ventana se define mediante las compensaciones de la fila actual. Use FIRST()+n y LAST()-n para compensaciones de la primera o última fila de la división. Si se omite el comienzo y el final, se usa la división completa.

Ejemplo

WINDOW_STDEVP(SUM([Profit]), FIRST()+1, 0) calcula la desviación estándar de SUM(Profit) desde la segunda fila hasta la actual.

WINDOW_SUM(expression, [start, end])


Indica la suma de la expresión dentro de la ventana. La ventana se define mediante las compensaciones de la fila actual. Use FIRST()+n y LAST()-n para compensaciones de la primera o última fila de la división. Si se omite el comienzo y el final, se usa la división completa.

Por ejemplo, la siguiente vista muestra ventas por trimestre. Una suma de ventana calculada en la división Fecha indica la suma de las ventas en todos los trimestres.

Ejemplo

WINDOW_SUM(SUM([Profit]), FIRST()+1, 0) calcula la suma de SUM(Profit) desde la segunda fila hasta la actual.

WINDOW_VAR(expression, [start, end])


Indica la discordancia de muestra de la expresión dentro de la ventana. La ventana se define mediante las compensaciones de la fila actual. Use FIRST()+n y LAST()-n para compensaciones de la primera o última fila de la división. Si se omite el comienzo y el final, se usa la división completa.

Ejemplo

WINDOW_VAR((SUM([Profit])), FIRST()+1, 0) calcula la discordancia de SUM(Profit) desde la segunda fila hasta la actual.

WINDOW_VARP(expression, [start, end])


Indica la discordancia parcial de la expresión dentro de la ventana. La ventana se define mediante las compensaciones de la fila actual. Use FIRST()+n y LAST()-n para compensaciones de la primera o última fila de la división. Si se omite el comienzo y el final, se usa la división completa.

Ejemplo

WINDOW_VARP(SUM([Profit]), FIRST()+1, 0) calcula la discordancia de SUM(Profit) desde la segunda fila hasta la actual.

Funciones de paso (RAWSQL)

Se pueden usar estas funciones de paso RAWSQL para enviar expresiones SQL directamente a la base de datos sin que Tableau las interprete primero. Si tiene funciones de base de datos personalizadas que Tableau no conoce, puede usar las funciones de paso para llamar a estas funciones personalizadas.

Por lo general, la base de datos no comprenderá los nombres de campo que se muestran en Tableau. Debido a que Tableau no interpreta las expresiones SQL que incluye en las funciones de paso, el uso de los nombres de campo de Tableau en su expresión puede causar errores. Puede usar una sintaxis de sustitución para insertar el nombre de campo o la expresión correctos de un cálculo de Tableau en SQL de paso. Por ejemplo, imagine que tiene una función que calcula la mediana de un conjunto de valores, puede llamar a esa función en la columna de Tableau [Sales] de la siguiente forma:

RAWSQLAGG_REAL(“MEDIAN(%1)”, [Sales])

Debido a que Tableau no interpreta la expresión, debe definir la agregación. Puede usar las funciones de RAWSQLAGG que se describen a continuación cuando use expresiones agregadas.

Las funciones de paso RAWSQL podrían no funcionar con fuentes de datos publicadas o con extracciones si contienen relaciones.

Funciones de RAWSQL

Las siguientes funciones de RAWSQL están disponibles en Tableau.

RAWSQL_BOOL(“sql_expr”, [arg1], …[argN])


Indica un resultado booleano de una expresión de SQL dada. La expresión SQL se pasa directamente a la base de datos subyacente. Use %n en la expresión SQL como una sintaxis de sustitución para los valores de la base de datos.

Ejemplo

En el ejemplo, %1 es igual a [Sales] y %2 es igual a [Profit].

RAWSQL_BOOL(“IIF( %1 > %2, True, False)”, [Sales], [Profit])

RAWSQL_DATE(“sql_expr”, [arg1], …[argN])


Indica un resultado de fecha de una expresión de SQL dada. La expresión SQL se pasa directamente a la base de datos subyacente. Use %n en la expresión SQL como una sintaxis de sustitución para los valores de la base de datos.

Ejemplo

En este ejemplo, %1 es igual a [Order Date].

RAWSQL_DATE(“%1”, [Order Date])

RAWSQL_DATETIME(“sql_expr”, [arg1], …[argN])


Indica un resultado de fecha y hora de una expresión de SQL dada. La expresión SQL se pasa directamente a la base de datos subyacente. Use %n en la expresión SQL como una sintaxis de sustitución para los valores de la base de datos. En este ejemplo, %1 es igual a [Delivery Date].

Ejemplo

RAWSQL_DATETIME(“MIN(%1)”, [Delivery Date])

RAWSQL_INT(“sql_expr”, [arg1], …[argN])


Indica un resultado íntegro de una expresión de SQL dada. La expresión SQL se pasa directamente a la base de datos subyacente. Use %n en la expresión SQL como una sintaxis de sustitución para los valores de la base de datos. En este ejemplo, %1 es igual a [Sales].

Ejemplo

RAWSQL_INT(“500 + %1”, [Sales])

RAWSQL_REAL(“sql_expr”, [arg1], …[argN])


Indica un resultado numérico desde una expresión de SQL dada que se pasa directamente a base de datos subyacente. Use %n en la expresión SQL como una sintaxis de sustitución para los valores de la base de datos. En este ejemplo, %1 es igual a [Sales].

Ejemplo

RAWSQL_REAL(“-123.98 * %1”, [Sales])

RAWSQL_SPATIAL


Indica un espacial de una expresión de SQL dada que se pasa directamente a la fuente de datos subyacente. Use %n en la expresión SQL como una sintaxis de sustitución para los valores de la base de datos.

Ejemplo

En este ejemplo, %1 es igual a [Geometry].

RAWSQL_SPATIAL("%1", [Geometry])

RAWSQL_STR(“sql_expr”, [arg1], …[argN])


Indica una cadena de una expresión de SQL dada que se pasa directamente a la base de datos subyacente. Use %n en la expresión SQL como una sintaxis de sustitución para los valores de la base de datos. En este ejemplo, %1 es igual a [Customer Name].

Ejemplo

RAWSQL_STR(“%1”, [Customer Name])

RAWSQLAGG_BOOL(“sql_expr”, [arg1], …[argN])


Indica un resultado booleano de una expresión de SQL de agregación dada. La expresión SQL se pasa directamente a la base de datos subyacente. Use %n en la expresión SQL como una sintaxis de sustitución para los valores de la base de datos.

Ejemplo

En el ejemplo, %1 es igual a [Sales] y %2 es igual a [Profit].

RAWSQLAGG_BOOL(“SUM( %1) >SUM( %2)”, [Sales], [Profit])

RAWSQLAGG_DATE(“sql_expr”, [arg1], …[argN])


Indica un resultado de fecha de una expresión de SQL de agregación dada. La expresión SQL se pasa directamente a la base de datos subyacente. Use %n en la expresión SQL como una sintaxis de sustitución para los valores de la base de datos. En este ejemplo, %1 es igual a [Order Date].

Ejemplo

RAWSQLAGG_DATE(“MAX(%1)”, [Order Date])

RAWSQLAGG_DATETIME(“sql_expr”, [arg1], …[argN])


Indica un resultado de fecha y hora de una expresión de SQL de agregación dada. La expresión SQL se pasa directamente a la base de datos subyacente. Use %n en la expresión SQL como una sintaxis de sustitución para los valores de la base de datos. En este ejemplo, %1 es igual a [Delivery Date].

Ejemplo

RAWSQLAGG_DATETIME(“MIN(%1)”, [Delivery Date])

RAWSQLAGG_INT(“sql_expr”, [arg1,] …[argN])


Indica un resultado entero de una expresión de SQL de agregación dada. La expresión SQL se pasa directamente a la base de datos subyacente. Use %n en la expresión SQL como una sintaxis de sustitución para los valores de la base de datos. En este ejemplo, %1 es igual a [Sales].

Ejemplo

RAWSQLAGG_INT(“500 + SUM(%1)”, [Sales])

RAWSQLAGG_REAL(“sql_expr”, [arg1,] …[argN])


Indica un resultado numérico desde una expresión de SQL de agregación dada que se pasa directamente a la base de datos subyacente. Use %n en la expresión SQL como una sintaxis de sustitución para los valores de la base de datos. En este ejemplo, %1 es igual a [Sales].

Ejemplo

RAWSQLAGG_REAL(“SUM( %1)”, [Sales])

RAWSQLAGG_STR(“sql_expr”, [arg1,] …[argN])


Indica una cadena de una expresión de SQL de agregación dada que se pasa directamente a la base de datos subyacente. Use %n en la expresión SQL como una sintaxis de sustitución para los valores de la base de datos. En este ejemplo, %1 es igual a [Discount].

Ejemplo

RAWSQLAGG_STR(“AVG(%1)”, [Discount])

Funciones espaciales

Las funciones espaciales le permiten realizar análisis espacial avanzado y combinar archivos espaciales con datos en otros formatos, como archivos de texto u hojas de cálculo.

ÁREA

SintaxisAREA(Spatial Polygon, 'units')
ResultadoNúmero
DefiniciónDevuelve el área de superficie total de un <spatial polygon>.
Ejemplo
AREA([Geometry], 'feet')
Notas

Nombres de unidades compatibles (deben estar entre comillas en el cálculo, como 'miles'):

  • meters: metros, m
  • kilometers: kilómetros, km
  • miles: millas, mi
  • feet: pies, pi

BUFFER

SintaxisBUFFER(Spatial Point, distance, 'units')

BUFFER(Linestring, distance, 'units')

  • meters: metros, m
  • kilometers: kilómetros, km
  • miles: millas, mi
  • feet: pies, pi
ResultadoGeometría
Definición

Para los puntos espaciales, devuelve una forma de polígono centrada sobre un <spatial point>, con un radio determinado por la <distance> y los valores de <unit>.

Para cadenas lineales, calcula los polígonos formados al incluir todos los puntos dentro del radio de distancia desde la cadena lineal.

Ejemplo
BUFFER([Spatial Point Geometry], 25, 'mi')
BUFFER(MAKEPOINT(47.59, -122.32), 3, 'km')
BUFFER(MAKELINE(MAKEPOINT(0, 20),MAKEPOINT (30, 30)),20,'km'))
Notas

Nombres de unidades compatibles (deben estar entre comillas en el cálculo, como 'miles'):

  • meters: metros, m
  • kilometers: kilómetros, km
  • miles: millas, mi
  • feet: pies, pi

DIFFERENCE

SintaxisDIFFERENCE(Spatial, Spatial)
ResultadoPolígono espacial
DefiniciónCalcula las porciones de regiones restantes cuando todas las regiones en el segundo argumento se eliminan del primer argumento en áreas que se superponen. Descarta regiones del segundo argumento en áreas que no se superponen.
Ejemplo
DIFFERENCE(Spatial Polygon1, Spatial Polygon2)
Notas

Admite polígonos y multipolígonos espaciales, no puntos ni líneas espaciales.

DISTANCE

SintaxisDISTANCE(SpatialPoint1, SpatialPoint2, 'units')
ResultadoNúmero
DefiniciónDevuelve la medición de la distancia entre dos puntos de las <unit> especificadas.
Ejemplo
DISTANCE([Origin Point],[Destination Point], 'km')
Notas

Nombres de unidades compatibles (deben estar entre comillas en el cálculo, como 'miles'):

  • meters: metros, m
  • kilometers: kilómetros, km
  • miles: millas, mi
  • feet: pies, pi
Limitaciones de la base de datosEsta función solo se puede crear con una conexión en tiempo real, pero seguirá funcionando si la fuente de datos se convierte en una extracción.

INTERSECTION

SintaxisINTERSECTION (spatial, spatial)
ResultadoPolígono
DefiniciónCalcula y devuelve las porciones de regiones en el segundo argumento que se superponen a las regiones en el primer argumento.
EjemploINTERSECTION (Spatial Polygon1, Spatial Polygon2)
NotasAdmite polígonos y multipolígonos espaciales, no puntos ni líneas espaciales.

INTERSECTS

SintaxisINTERSECTS (geometry1, geometry2)
ResultadoBooleano
DefiniciónDevuelve true o false indicando si dos geometrías se superponen en el espacio.
NotasCombinaciones admitidas: punto/polígono, línea/polígono y polígono/polígono.

MAKELINE

SintaxisMAKELINE(SpatialPoint1, SpatialPoint2)
ResultadoGeometría (línea)
DefiniciónGenera una marca de línea entre dos puntos.
Ejemplo
MAKELINE(MAKEPOINT(47.59, -122.32), MAKEPOINT(48.5, -123.1))
NotasÚtil para construir mapas de origen-destino.

MAKEPOINT

SintaxisMAKEPOINT(latitude, longitude, [SRID])
ResultadoGeometría (punto)
Definición

Convierte los datos de las columnas <latitude> y <longitude> en objetos espaciales.

Si se añade el argumento opcional <SRID>, las entradas pueden ser otras coordenadas geográficas proyectadas.

Ejemplo
MAKEPOINT(48.5, -123.1)
MAKEPOINT([AirportLatitude], [AirportLongitude])
MAKEPOINT([Xcoord],[Ycoord], 3493)
Notas

MAKEPOINT no puede utilizar los campos de latitud y longitud generados automáticamente. La fuente de datos debe contener las coordenadas de forma nativa.

SRID es un identificador de referencia espacial que utiliza los códigos del sistema de referencia ESPG(El enlace se abre en una ventana nueva) para especificar sistemas de coordenadas. Si no se especifica SRID, se asumirá WGS84, y los parámetros se tratarán como latitud/longitud en grados.

Puede utilizar MAKEPOINT para habilitar una fuente de datos espacialmente, de modo que se pueda unir con un archivo espacial mediante una unión espacial. Para obtener más información, consulte Unir archivos espaciales en Tableau.

LENGTH

SintaxisLENGTH(geometry, 'units')
ResultadoNúmero
DefiniciónDevuelve la longitud de la ruta geodésica de la cadena o cadenas lineales en la <geometry> usando las <units> dadas.
Ejemplo
LENGTH([Spatial], 'metres')
NotasEl resultado es <NaN> si el argumento de geometría no tiene cadenas lineales, aunque se permiten otros elementos.

OUTLINE

SintaxisOUTLINE(spatial polygon)
ResultadoGeometría
DefiniciónConvierte una geometría de polígono en cadenas de líneas.
Notas

Es útil para crear una capa separada para un contorno al que se le puede aplicar un estilo diferente al del relleno.

Admite polígonos dentro de multipolígonos.

SHAPETYPE

SintaxisSHAPETYPE(geometry)
ResultadoCadena
DefiniciónDevuelve una cadena que describe la estructura de la <geometry> espacial, como Empty, Point, MultiPoint, LineString, MultiLinestring, Polygon, MultiPolygon, Mixed, and unsupported
Ejemplo
SHAPETYPE(MAKEPOINT(48.5, -123.1)) = "Point"

SYMDIFFERENCE

SintaxisSYMDIFFERENCE(spatial, spatial)
ResultadoGeometría
DefiniciónCalcula cualquier parte de las regiones del segundo argumento que se superpongan con las regiones del primer argumento y descarta ambas. Devuelve las porciones restantes de las regiones de ambos argumentos.
Ejemplo

SYMDIFFERENCE(Spatial Polygon1, Spatial Polygon2)

VALIDATE

SintaxisVALIDATE(spatial geometry)
ResultadoGeometría
DefiniciónConfirma la corrección topológica de la geometría en su valor espacial. Si el valor no se puede utilizar para el análisis debido a problemas como que el perímetro de un polígono se cruza consigo mismo, el resultado será nulo. Si la geometría es correcta, el resultado será la geometría original.
Ejemplo

UNION(VALIDATE([Geometry]))

Funciones adicionales
Si desea obtener más información, consulte Funciones de paso (RAWSQL)(El enlace se abre en una ventana nueva).

Expresiones regulares

REGEXP_REPLACE(string, pattern, replacement)

Indica una copia de la cadena dada en la que el patrón de la expresión regular se sustituye por la cadena de sustitución. Esta función está disponible para fuentes de datos de archivos de texto, Hadoop Hive, Google BigQuery, PostgreSQL, extracciones de datos de Tableau, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (versión 14.1 y posteriores), Snowflake y Oracle.

Para extracciones de datos de Tableau, el patrón y el reemplazo deben ser constantes.

Para obtener información sobre la sintaxis de las expresiones regulares, consulte la documentación de la fuente de datos. En las extracciones de Tableau, la sintaxis de las expresiones regulares se adhiere a los estándares de los ICU (componentes internacionales para Unicode), un proyecto de código abierto de bibliotecas maduras de C/C++ y Java para la compatibilidad con Unicode y para la internacionalización y globalización de software. Consulte la página Expresiones regulares(El enlace se abre en una ventana nueva) en la guía de usuario de ICU en línea.

Ejemplo

REGEXP_REPLACE('abc 123', '\s', '-') = 'abc-123'

REGEXP_MATCH(string, pattern)

Indica true si una subcadena de la cadena especificada coincide con el patrón de la expresión regular. Esta función está disponible para fuentes de datos de archivos de texto, Google BigQuery, PostgreSQL, extracciones de datos de Tableau, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (versión 14.1 y posteriores), Impala 2.3.0 (a través de fuentes de datos de Cloudera Hoop), Snowflake y Oracle.

En el caso de las extracciones de datos de Tableau, el patrón debe ser una constante.

Para obtener información sobre la sintaxis de las expresiones regulares, consulte la documentación de la fuente de datos. En las extracciones de Tableau, la sintaxis de las expresiones regulares se adhiere a los estándares de los ICU (componentes internacionales para Unicode), un proyecto de código abierto de bibliotecas maduras de C/C++ y Java para la compatibilidad con Unicode y para la internacionalización y globalización de software. Consulte la página Expresiones regulares(El enlace se abre en una ventana nueva) en la guía de usuario de ICU en línea.

Ejemplo

REGEXP_MATCH('-([1234].[El.Mercado])-','\[\s*(\w*\.)(\w*\s*\])')=true

REGEXP_EXTRACT(string, pattern)


Indica la parte de una cadena que coincide con el patrón de la expresión regular. Esta función está disponible para fuentes de datos de archivos de texto, Hadoop Hive, Google BigQuery, PostgreSQL, extracciones de datos de Tableau, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (versión 14.1 y posteriores), Snowflake y Oracle.

En el caso de las extracciones de datos de Tableau, el patrón debe ser una constante.

Para obtener información sobre la sintaxis de las expresiones regulares, consulte la documentación de la fuente de datos. En las extracciones de Tableau, la sintaxis de las expresiones regulares se adhiere a los estándares de los ICU (componentes internacionales para Unicode), un proyecto de código abierto de bibliotecas maduras de C/C++ y Java para la compatibilidad con Unicode y para la internacionalización y globalización de software. Consulte la página Expresiones regulares(El enlace se abre en una ventana nueva) en la guía de usuario de ICU en línea.

Ejemplo

REGEXP_EXTRACT('abc 123', '[a-z]+\s+(\d+)') = '123'

REGEXP_EXTRACT_NTH(string, pattern, index)

Indica la parte de una cadena que coincide con el patrón de la expresión regular. La subcadena se empareja con el grupo de captura nth, donde n es el índice determinado. Si el índice es 0, se indica toda la cadena. Esta función está disponible para fuentes de datos de archivos de texto, PostgreSQL, extracciones de datos de Tableau, Microsoft Excel, Salesforce, Vertica, Pivotal Greenplum, Teradata (versión 14.1 y posteriores) y Oracle.

En el caso de las extracciones de datos de Tableau, el patrón debe ser una constante.

Para obtener información sobre la sintaxis de las expresiones regulares, consulte la documentación de la fuente de datos. En las extracciones de Tableau, la sintaxis de las expresiones regulares se adhiere a los estándares de los ICU (componentes internacionales para Unicode), un proyecto de código abierto de bibliotecas maduras de C/C++ y Java para la compatibilidad con Unicode y para la internacionalización y globalización de software. Consulte la página Expresiones regulares(El enlace se abre en una ventana nueva) en la guía de usuario de ICU en línea.

Ejemplo

REGEXP_EXTRACT_NTH('abc 123', '([a-z]+)\s+(\d+)', 2) = '123'

Funciones específicas de Hadoop Hive

Nota: Solo las funciones PARSE_URL y PARSE_URL_QUERY están disponibles para las fuentes de datos de Cloudera Impala.

GET_JSON_OBJECT(JSON string, JSON path)

Indica el objeto JSON de la cadena JSON en función de la ruta JSON.

PARSE_URL(string, url_part)

Indica un componente de la cadena URL determinada donde el componente está definido por parte_url. Los valores parte_url válidos incluyen: 'HOST', 'PATH', 'QUERY', 'REF', 'PROTOCOL', 'AUTHORITY', 'FILE' y 'USERINFO'.

Ejemplo

PARSE_URL('http://www.tableau.com', 'HOST') = 'www.tableau.com'

PARSE_URL_QUERY(string, key)

Indica el valor del parámetro de consulta especificado en la cadena URL determinada. La clave define el parámetro de consulta.

Ejemplo

PARSE_URL_QUERY('http://www.tableau.com?page=1&cat=4', 'page') = '1'

XPATH_BOOLEAN(XML string, XPath expression string)

Indica true si la expresión XPath coincide con un nodo o se evalúa en true.

Ejemplo

XPATH_BOOLEAN('<values> <value id="0">1</value><value id="1">5</value>', 'values/value[@id="1"] = 5') = true

XPATH_DOUBLE(XML string, XPath expression string)

Indica el valor de punto flotante de la expresión XPath.

Ejemplo

XPATH_DOUBLE('<values><value>1.0</value><value>5.5</value> </values>', 'sum(value/*)') = 6.5

XPATH_FLOAT(XML string, XPath expression string)

Indica el valor de punto flotante de la expresión XPath.

Ejemplo

XPATH_FLOAT('<values><value>1.0</value><value>5.5</value> </values>','sum(value/*)') = 6.5

XPATH_INT(XML string, XPath expression string)

Indica el valor numérico de la expresión XPath o cero si esta no se puede evaluar en un número.

Ejemplo

XPATH_INT('<values><value>1</value><value>5</value> </values>','sum(value/*)') = 6

XPATH_LONG(XML string, XPath expression string)

Indica el valor numérico de la expresión XPath o cero si esta no se puede evaluar en un número.

Ejemplo

XPATH_LONG('<values><value>1</value><value>5</value> </values>','sum(value/*)') = 6

XPATH_SHORT(XML string, XPath expression string)

Indica el valor numérico de la expresión XPath o cero si esta no se puede evaluar en un número.

Ejemplo

XPATH_SHORT('<values><value>1</value><value>5</value> </values>','sum(value/*)') = 6

XPATH_STRING(XML string, XPath expression string)

Indica el texto del primer nodo coincidente.

Ejemplo

XPATH_STRING('<sites ><url domain="org">http://www.w3.org</url> <url domain="com">http://www.tableau.com</url></sites>', 'sites/url[@domain="com"]') = 'http://www.tableau.com'

Funciones específicas de Google BigQuery

DOMAIN(string_url)

Dada una cadena URL, indica el dominio como una cadena.

Ejemplo

DOMAIN('http://www.google.com:80/index.html') = 'google.com'

GROUP_CONCAT(expression)

Concatena valores de cada registro en una única cadena delimitada por comas. Esta función actúa como SUM() para las cadenas.

Ejemplo

GROUP_CONCAT(Region) = "Central,East,West"

HOST(string_url)

Dada una cadena URL, indica el nombre de host como una cadena.

Ejemplo

HOST('http://www.google.com:80/index.html') = 'www.google.com:80'

LOG2(number)

Indica el logaritmo de base 2 de un número.

Ejemplo

LOG2(16) = '4,00'

LTRIM_THIS(string, string)

Indica la primera cadena con cualquier ocurrencia inicial de la segunda cadena eliminada.

Ejemplo

LTRIM_THIS('[-Ventas-]','[-') = 'Ventas-]'

RTRIM_THIS(string, string)

Indica la primera cadena con cualquier ocurrencia final de la segunda cadena eliminada.

Ejemplo

RTRIM_THIS('[-Mercado-]','-]') = '[-Mercado'

TIMESTAMP_TO_USEC(expression)

Convierte un tipo de datos TIMESTAMP en una marca de tiempo UNIX en microsegundos.

Ejemplo

TIMESTAMP_TO_USEC(#2012-10-01 01:02:03#)=1349053323000000

USEC_TO_TIMESTAMP(expression)

Convierte una marca de tiempo UNIX en microsegundos en un tipo de datos TIMESTAMP.

Ejemplo

USEC_TO_TIMESTAMP(1349053323000000) = #2012-10-01 01:02:03#

TLD(string_url)

Dada una cadena URL, indica el dominio de nivel superior más cualquier dominio de país/región en la dirección URL.

Ejemplo

TLD('http://www.google.com:80/index.html') = '.com'

TLD('http://www.google.co.uk:80/index.html') = '.co.uk'

 



¿Desea obtener más información acerca de las funciones?

Consulte los temas sobre funciones(El enlace se abre en una ventana nueva).

Consulte también

Funciones de Tableau (alfabéticamente)(El enlace se abre en una ventana nueva)

¡Gracias por sus comentarios!Sus comentarios se han enviado correctamente. ¡Gracias!