Tableau 函数(按字母顺序)

本参考中的 Tableau 函数按字母顺序进行组织。单击某个字母可跳转到列表中的该位置。您也可以使用 Ctrl+F(在 Mac 上为 Command-F)打开一个搜索框,用于查找特定函数。

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z


A

ABS

语法ABS(number)
输出数字(正数)
定义返回给定 <number> 的绝对值。
示例
ABS(-7) = 7
ABS([Budget Variance])

第二个示例返回“Budget Variance”(预算差异)字段中包含的所有数字的绝对值。

说明另请参见 SIGN

ACOS

语法ACOS(number)
输出数字(以弧度表示的角度)
定义返回给定 <number> 的反余弦(角度)。
示例
ACOS(-1) = 3.14159265358979
说明反函数 COS 以弧度为单位的角度作为参数,并返回余弦值。

AND

语法<expr1> AND <expr2>
定义对两个表达式执行逻辑合取运算。(如果两边都为 true,则逻辑测试返回 true。)
输出布尔值
示例
IF [Season] = "Spring" AND "[Season] = "Fall" 
THEN "It's the apocalypse and footwear doesn't matter"
END

“如果(Season = Spring)和(Season = Fall)同时为 true,则返回“It's the apocalypse and footwear doesn't matter。”

说明

通常与 IFIIF 一起使用。另请参见 NOT或者

如果两个表达式都为 TRUE(即不为 FALSENULL),则结果为 TRUE。如果任一表达式为 NULL,则结果为 NULL。在所有其他情况下,结果都为 FALSE

如果所创建的计算中的 AND 比较结果显示在工作表上,则 Tableau 显示 TRUEFALSE。如果要更改此情况,请使用设置格式对话框中的“设置格式”区域。

注意AND 运算符使用短路计算。这表示如果第一个表达式计算为 FALSE,则根本不会计算第二个表达式。如果第二个表达式在第一个表达式为 FALSE 时产生错误,则这可能十分有用,因为在这种情况下从不计算第二个表达式。

AREA

语法AREA(Spatial Polygon, 'units')
输出数字
定义返回 <spatial polygon> 的总表面积。
示例
AREA([Geometry], 'feet')
说明

支持的单位名称(计算时必须用引号括起来,例如'miles'):

  • :meters、metres、m
  • 公里:kilometers、kilometres、km
  • 英里:miles、mi
  • 英尺:feet、ft

ASCII

语法ASCII(string)
输出数字
定义返回 <string> 的第一个字符的 ASCII 码。
示例
ASCII('A') = 65
说明这是 CHAR 函数的反函数。

ASIN

语法ASIN(number)
输出数字(以弧度表示的角度)
定义返回给定 <number> 的反正弦(角度)。
示例
ASIN(1) = 1.5707963267949
说明反函数 SIN 以弧度为单位的角度作为参数,并返回正弦值。

ATAN

语法ATAN(number)
输出数字(以弧度表示的角度)
定义返回给定 <number> 的反正切(角度)。
示例
ATAN(180) = 1.5652408283942
说明

反函数 TAN 以弧度为单位的角度作为参数,并返回正切值。

另请参见 ATAN2COT

ATAN2

语法ATAN2(y number, x number)
输出数字(以弧度表示的角度)
定义返回两个数字(<y number><x number>)之间的反正切(角度)。结果以弧度表示。
示例
ATAN2(2, 1) = 1.10714871779409
说明另请参见 ATANTANCOT

ATTR

语法ATTR(expression)
定义如果它的所有行都有一个值,则返回 <expression> 的值。否则返回星号。会忽略 Null 值。

AVG

语法AVG(expression)
定义返回 <expression> 中所有值的平均值。会忽略 Null 值。
说明AVG 只能用于数字字段。

返回顶部

B

BUFFER

语法BUFFER(Spatial Point, distance, 'units')
输出几何图形
定义返回以 <spatial point> 为中心的多边形形状,半径由 <distance><unit> 值确定。
示例
BUFFER([Spatial Point Geometry], 25, 'mi')
BUFFER(MAKEPOINT(47.59, -122.32), 3, 'km')
说明

支持的单位名称(计算时必须用引号括起来,例如'miles'):

  • :meters、metres、m
  • 公里:kilometers、kilometres、km
  • 英里:miles、mi
  • 英尺:feet、ft

返回顶部

C

CASE

语法CASE <expression>
WHEN <value1> THEN <then1>
WHEN <value2> THEN <then2>
...
[ELSE <default>]
END
输出取决于 <then> 值的数据类型。
定义

expression 进行求值,并将其与指定选项(<value1><value2> 等)进行比较。遇到一个与表达式匹配的 value 时,CASE 返回相应的 return。如果未找到匹配值,则返回(可选)默认值。如果不存在默认值并且没有任何值匹配,则会返回 Null。

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

“看看“Season”字段。如果值为 Summer,则返回 Sandals。如果值为 Winter,则返回 Boots。如果计算中的选项均不匹配“Season”字段中的选项,则返回 Sneakers。”

说明

另请参见 IFIIF

WHENTHENELSEEND 结合使用。

提示:很多时候,您可以使用组来获得与复杂 CASE 函数相同的结果,或者使用 CASE 来替换本机分组功能,例如前面的示例。您可能想测试哪个更适合您的场景。

CEILING

语法CEILING(number)
输出整数
定义<number> 舍入为值相等或更大的最近整数。
示例
CEILING(2.1) = 3
说明另请参见 FLOORROUND
数据库限制

CEILING 可通过以下连接器使用:Microsoft Excel、文本文件、统计文件、已发布数据源、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。

CHAR

语法CHAR(number)
输出字符串
定义返回通过 ASCII 代码 <number> 编码的字符。
示例
CHAR(65) = 'A'
说明这是 ASCII 函数的反函数。

COLLECT

语法COLLECT(spatial)
定义将参数字段中的值组合在一起的聚合计算。会忽略 Null 值。
说明COLLECT 只能用于空间字段。

CONTAINS

语法CONTAINS(string, substring)
输出布尔值
定义如果给定 <string> 包含指定 <substring>,则返回 true。
示例
CONTAINS("Calculation", "alcu") = true
说明另请参见逻辑函数(链接在新窗口中打开) IN 以及附加函数文档(链接在新窗口中打开)中支持的正则表达式。

CORR

语法CORR(expression1, expression2)
输出从 -1 到 1 的数字
定义返回两个表达式的皮尔森相关系数。
示例
example
说明

皮尔森相关系数衡量两个变量之间的线性关系。结果范围为 -1 至 +1(包括 -1 和 +1),其中 1 表示精确的正向线性关系,0 表示方差之间没有线性关系,而 −1 表示精确的反向关系。

CORR 结果的平方等于线性趋势线模型的 R 平方值。请参见“趋势线模型术语”(链接在新窗口中打开)

与表范围 LOD 表达式一起使用:

您可以使用 CORR,通过表范围的详细级别表达式(链接在新窗口中打开)来可视化解聚散点图中的相关性。例如:

{CORR(Sales, Profit)}

借助详细级别表达式,关联将在所有行上运行。如果您使用像 CORR(Sales, Profit)(不带两边的方括号可使其成为详细级别表达式)这样的公式,视图将显示散点图中每个单独的点与其他每个点(未定义)的关联。

数据库限制

CORR适用于以下数据源:Tableau 数据提取、Cloudera Hive、EXASolution、Firebird(版本 3.0 及更高版本)、Google BigQuery、Hortonworks Hadoop Hive、IBM PDA (Netezza)、Oracle、PostgreSQL、Presto、SybaseIQ、Teradata、Vertica。

对于其他数据源,请考虑提取数据或使用 WINDOW_CORR。请参见“表计算函数”(链接在新窗口中打开)

COS

语法COS(number)

number 参数是以弧度表示的角度。

输出数字
定义返回角度的余弦。
示例
COS(PI( ) /4) = 0.707106781186548
说明

反函数 ACOS 以余弦为参数并返回以弧度表示的角度。

另请参见 PI

COT

语法COT(number)

number 参数是以弧度表示的角度。

输出数字
定义返回角度的余切。
示例
COT(PI( ) /4) = 1
说明另请参见 ATANTANPI

COUNT

语法COUNT(expression)
定义返回项目数。不对 Null 值计数。

COUNTD

语法COUNTD(expression)
定义返回组中不同项目的数量。不对 Null 值计数。

COVAR

语法COVAR(expression1, expression2)
定义返回两个表达式的样本协方差。
说明

协方差对两个变量的共同变化方式进行量化。正协方差指明两个变量趋向于向同一方向移动,平均来说,即一个变量的较大值趋向于与另一个变量的较大值对应。样本协方差使用非空数据点的数量 n - 1 来规范化协方差计算,而不是使用总体协方差(可用于 COVARP 函数)所使用的 n。当数据是用于估算较大总体的协方差的随机样本时,则样本协方差是合适的选择。

如果 <expression1><expression2> 相同(例如, COVAR([profit], [profit])),COVAR 将返回一个值,指明值分布的广泛程度。

COVAR(X, X) 的值等于 VAR(X)的值,也等于 STDEV(X)^2 的值。

数据库限制

COVAR适用于以下数据源:Tableau 数据提取、Cloudera Hive、EXASolution、Firebird(版本 3.0 及更高版本)、Google BigQuery、Hortonworks Hadoop Hive、IBM PDA (Netezza)、Oracle、PostgreSQL、Presto、SybaseIQ、Teradata、Vertica。

对于其他数据源,请考虑提取数据或使用 WINDOW_COVAR。请参见“表计算函数”(链接在新窗口中打开)

COVARP

语法COVARP(expression 1, expression2)
定义返回两个表达式的总体协方差。
说明

协方差对两个变量的共同变化方式进行量化。正协方差指明两个变量趋向于向同一方向移动,平均来说,即一个变量的较大值趋向于与另一个变量的较大值对应。总体协方差等于样本协方差除以 (n-1)/n,其中 n 是非空数据点的总数。如果存在可用于所有相关项的数据,则总体协方差是合适的选择,与之相反,在只有随机项子集的情况下,样本协方差(及 COVAR 函数)较为适合。

如果 <expression1><expression2> 相同(例如, COVARP([profit], [profit])),COVARP 将返回一个值,指明值分布的广泛程度。注意:COVARP(X, X) 注意:的值等于 VARP(X)的值,也等于 STDEVP(X)^2 的值。

数据库限制

COVARP 适用于以下数据源:Tableau 数据提取、Cloudera Hive、EXASolution、Firebird(版本 3.0 及更高版本)、Google BigQuery、Hortonworks Hadoop Hive、IBM PDA (Netezza)、Oracle、PostgreSQL、Presto、SybaseIQ、Teradata、Vertica

对于其他数据源,请考虑提取数据或使用 WINDOW_COVAR。请参见“表计算函数”(链接在新窗口中打开)

返回顶部

D

DATE

将字符串和数字表达式转换为日期的类型转换函数,只要它们是可识别的格式。

语法DATE(expression)
输出日期
定义在给定数字、字符串或日期 <expression> 的情况下返回日期。
示例
DATE([Employee Start Date])
DATE("September 22, 2018") 
DATE("9/22/2018")
DATE(#2018-09-22 14:52#)
说明

DATEPARSE 不同,不需要提供模式,因为 DATE 会自动识别许多标准日期格式。但是,如果 DATE 不能识别输入,请尝试使用 DATEPARSE 并指定格式。

MAKEDATE 是另一个类似的函数,但是 MAKEDATE 要求输入年、月和日的数值。

DATEADD

将指定数量的日期部分(月、日等)添加到开始日期。

语法DATEADD(date_part, interval, date)
输出日期
定义返回指定日期,该日期的指定 <date_part 中添加了指定的数字 <interval>。例如,将开始日期增加 3 个月或 12 天。
示例

将所有的到期日推迟一周

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

将 2021 年 2 月 20 日加上 280 天

DATEADD('day', 280, #2/20/21#) = #November 27, 2021#
说明支持 ISO 8601 日期。

DATEDIFF

返回两个日期之间的日期部分(周、年等)的数量。

语法DATEDIFF(date_part, date1, date2, [start_of_week])
输出整数
定义返回 date1date2 之差(以 date_part 的单位表示)。例如,减去某人加入和离开乐队的日期,就可以知道他们在乐队里呆了多久。
示例

1986 年 3 月 25 日到 2021 年 2 月 20 日之间的天数

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

一个人在乐队里呆了几个月

DATEDIFF('month', [date joined band], [date left band])
说明支持 ISO 8601 日期。

DATENAME

以离散字符串形式返回指定日期部分的名称。

语法DATENAME(date_part, date, [start_of_week])
输出字符串
定义以字符串形式返回日期的 <date_part>
示例
DATENAME('year', #3/25/1986#) = "1986"
DATENAME('month', #1986-03-25#) = "March"
说明

支持 ISO 8601 日期。

一个非常类似的计算是 DATEPART,它以连续整数的形式返回指定日期部分的值。DATEPART 可能更快,因为它是一个数值运算。

通过更改计算结果的属性(维度或度量、连续或离散)和日期格式,可以将 DATEPARTDATENAME 的结果格式设置为相同。

反函数是 DATEPARSE,它接受一个字符串值并将其格式化为日期。

DATEPARSE

以日期形式返回特定格式的字符串。

语法DATEPARSE(date_format, date_string)
输出日期
定义<date_format> 参数将描述 <date_string> 字段的排列方式。由于可通过各种方式对字符串字段进行排序,因此 <date_format> 必须完全匹配。有关完整解释,请参见“将字段转换为日期字段”(链接在新窗口中打开)
示例
DATEPARSE('yyyy-MM-dd', "1986-03-25") = #March 25, 1986#
说明

DATE是一个类似的函数,可以自动识别许多标准的日期格式。如果 DATE 不能识别输入模式,DATEPARSE 可能是更好的选择。

MAKEDATE 是另一个类似的函数,但是 MAKEDATE 要求输入年、月和日的数值。

反函数是 DATEPART(整数输出)和 DATENAME(字符串输出),它将日期分开并返回其各部分的值。

数据库限制

DATEPARSE 可通过以下连接器获得:非旧版 Excel 和文本文件连接、Amazon EMR Hadoop Hive、Cloudera Hadoop、Google 表格、Hortonworks Hadoop Hive、MapR Hadoop Hive、MySQL、Oracle、PostgreSQL 以及 Tableau 数据提取。有些格式可能并非适用于所有连接。

Hive 变体不支持 DATEPARSE。仅支持 Denodo、Drill 和 Snowflake。

DATEPART

以整数形式返回指定日期部分的名称。

语法DATEPART(date_part, date, [start_of_week])
输出整数
定义以整数形式返回日期的 <date_part>
示例
DATEPART('year', #1986-03-25#) = 1986
DATEPART('month', #1986-03-25#) = 3
说明

支持 ISO 8601 日期。

一个非常类似的计算是 DATENAME,它以离散字符串的形式返回指定日期部分的名称。DATEPART 可能更快,因为它是一个数值运算。通过更改字段的属性(维度或度量、连续或离散)和日期格式,可以将 DATEPARTDATENAME 的结果格式设置为相同。

反函数是 DATEPARSE,它接受一个字符串值并将其格式化为日期。

DATETIME

语法DATETIME(expression)
输出日期时间
定义在给定数字、字符串或日期表达式的情况下返回日期时间。
示例
DATETIME("April 15, 2005 07:59:00") = April 15, 2005 07:59:00

DATETRUNC

可以将此函数视为日期舍入。它获取特定的日期,并返回该日期在所需的特定程度上的版本。由于每个日期都必须有日、月、季度和年的值,因此 DATETRUNC 将这些值设置为指定日期部分之前每个日期部分的最小值。有关详细信息,请参考见示例。

语法DATETRUNC(date_part, date, [start_of_week])
输出日期
定义<date_part>指定的准确度截断 <date>。此函数返回新日期。例如,以月份级别截断处于月份中间的日期时,此函数返回当月的第一天。
示例
DATETRUNC('day', #9/22/2018#) = #9/22/2018#
DATETRUNC('iso-week', #9/22/2018#) = #9/17/2018#

(包含 2018 年 9 月 22 日的一周中的星期一)

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

(包含 2018 年 9 月 22 日的季度的第一天)

注意:对于周和 iso 周,start_of_week 有作用。ISO 周始终从星期一开始。对于本例的区域设置,未指定的 start_of_week 意味着一周从星期日开始。

说明

支持 ISO 8601 日期。

例如,您不应使用 DATETRUNC 来停止在可视化项中显示日期时间字段的时间。如果要截断日期的显示而不是舍入其精度,请调整格式(链接在新窗口中打开)

举例来说,如果在可视化项中格式为显示秒,DATETRUNC('day', #5/17/2022 3:12:48 PM#) 将显示为 5/17/2022 12:00:00 AM

DAY

以整数形式返回一个月中的第几天 (1-31)。

语法DAY(date)
输出整数
定义以整数的形式返回给定 <date> 的天。
示例
Day(#September 22, 2018#) = 22
说明另请参见 WEEKMONTH季度YEAR 以及 ISO 等效值

DEGREES

语法DEGREES(number)

number 参数是以弧度表示的角度。

输出数字(度)
定义将以弧度表示的角度转换为度数。
示例
DEGREES(PI( )/4) = 45.0
说明

反函数 RADIANS 获取以度为单位的角度并返回以弧度为单位的角度。

另请参见 PI()

DISTANCE

语法DISTANCE(<SpatialPoint1>, <SpatialPoint2>, 'units')
输出数字
定义以指定 units 返回两点之间的距离测量值。
示例
DISTANCE([Origin Point],[Destination Point], 'km')
说明

支持的单位名称(计算中必须用引号引起来):

  • :meters、metres、m
  • 公里:kilometers、kilometres、km
  • 英里:miles、mi
  • 英尺:feet、ft
数据库限制此函数只能使用实时连接创建,但在将数据源转换为数据提取的情况下将继续工作。

DIV

语法DIV(integer1, integer2)
输出整数
定义返回将 <integer1> 除以 <integer2> 的除法运算的整数部分。
示例
DIV(11,2) = 5

DOMAIN

DOMAIN(string_url)

仅在连接到 Google BigQuery 时才受支持。有关详细信息,请参见“其他函数”(链接在新窗口中打开)

返回顶部

E

ELSE

语法CASE <expression>
WHEN <value1> THEN <then1>
WHEN <value2> THEN <then2>
...
[ELSE <default>]
END
定义IFCASE 表达式的一个可选部分,用于指定如果没有一个测试表达式为 true 则返回的默认值。
示例
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
说明

CASEWHENIFELSEIFTHENEND 一起使用

ELSE 对于 CASEIF 是可选的。在计算中,其中ELSE未指定,如果没有<test> 为 true 时,整体计算将返回 null。

ELSE不需要条件(例如 [Season] = "Winter")并且可以被认为是 null 处理的一种形式。

ELSEIF

语法[ELSEIF <test2> THEN <then2>]
定义IF 表达式的一个可选部分,用于指定初始 IF 之外的附加条件。
示例
IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots'
ELSEIF [Season] = "Spring" THEN 'Sneakers'
ELSEIF [Season] = "Autumn" THEN 'Sneakers'
ELSE 'Bare feet'
END
说明

IFTHENELSEEND 一起使用

ELSEIF 可以被认为是额外的 IF 子句。ELSEIF 是可选的,并且可以重复多次。

ELSE 不同,ELSEIF 需要一个条件(例如 [Season] = "Winter")。

END

定义用于结束一个 IFCASE 表达式。
示例
IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots'
ELSE 'Sneakers' 
END

“如果 Season = Summer,,则返回 Sandals。否则,请查看下一个表达式。如果 Season = Winter,则返回 Boots。如果两个表达式都不为 true,则返回 Sneakers。”

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

“看看“Season”字段。如果值为 Summer,则返回 Sandals。如果值为 Winter,则返回 Boots。如果计算中的选项均不匹配“Season”字段中的选项,则返回 Sneakers。”

说明

CASEWHENIFELSEIFTHENELSE 一起使用。

ENDSWITH

ENDSWITH

语法ENDSWITH(string, substring)
输出布尔值
定义如果给定 <string> 以指定 <substring> 结尾,则返回 true。会忽略尾随空格。
示例
ENDSWITH("Tableau", "leau") = true
说明另请参见附加函数文档(链接在新窗口中打开)中支持的正则表达式。

EXCLUDE

有关详细信息,请参见详细级别表达式(链接在新窗口中打开)

EXP

语法EXP(number)
输出数字
定义返回 e 的给定 <number> 次幂。
示例
EXP(2) = 7.389
EXP(-[Growth Rate]*[Time])
说明另请参见 LN

返回顶部

F

FIND

语法FIND(string, substring, [start])
输出数字
定义

返回 <substring><string> 中的索引位置,如果未找到子字符串,则返回 0。字符串中第一个字符的位置为 1。

如果添加了可选参数 start,则函数会忽略在起始位置之前出现的任何子字符串的实例。

示例
FIND("Calculation", "alcu") = 2
FIND("Calculation", "Computer") = 0
FIND("Calculation", "a", 3) = 7
FIND("Calculation", "a", 2) = 2
FIND("Calculation", "a", 8) = 0
说明另请参见附加函数文档(链接在新窗口中打开)中支持的正则表达式。

FINDNTH

语法FINDNTH(string, substring, occurrence)
输出数字
定义返回指定 <string> 内的第 n 个 <substring> 的位置,其中 n 由 <occurence> 参数定义。
示例
FINDNTH("Calculation", "a", 2) = 7
说明

所有数据源都不可使用 FINDNTH

另请参见附加函数文档(链接在新窗口中打开)中支持的正则表达式。

FIRST

FIRST()

有关详细信息,请参见表计算函数(链接在新窗口中打开)

FIXED

有关详细信息,请参见详细级别表达式(链接在新窗口中打开)

FLOAT

语法FLOAT(expression)
输出浮点数(小数)
定义将其参数转换为浮点数。
示例
FLOAT(3) = 3.000
说明另请参见 INT,它返回一个整数。

FLOOR

语法FLOOR(number)
输出整数
定义<number> 舍入为值相等或更小的最近整数。
示例
FLOOR(7.9) = 7
说明另请参见 CEILINGROUND
数据库限制

FLOOR 可通过以下连接器使用:Microsoft Excel、文本文件、统计文件、已发布数据源、Amazon EMR Hadoop Hive、Cloudera Hadoop、DataStax Enterprise、Google Analytics、Google BigQuery、Hortonworks Hadoop Hive、MapR Hadoop Hive、Microsoft SQL Server、Salesforce、Spark SQL。

FULLNAME

语法FULLNAME( )
输出字符串
定义

返回当前用户的全名。

示例
FULLNAME( )

此函数返回当前已登录用户的全名,例如“Hamlin Myrer”。

[Manager] = FULLNAME( )

如果经理“Hamlin Myrer”已登录,则仅当视图中的“Manager”字段包含“Dave Hallsten”时,此示例才会返回 TRUE。

说明

此函数检查:

  • Tableau CloudTableau Server:已登录用户的全名
  • Tableau Desktop:用户的本地或网络全名

用户筛选器

用作筛选器时,计算字段(例如 [Username field] = FULLNAME( ))可用于创建用户筛选器,该筛选器仅显示与登录到服务器的人员相关的数据。

返回顶部

G

GET_JSON_OBJECT

GET_JSON_OBJECT(JSON string, JSON path)

在连接到 Hadoop Hive 时受支持。有关详细信息,请参见“其他函数”(链接在新窗口中打开)

GROUP_CONCAT

GROUP_CONCAT(expression)

仅在连接到 Google BigQuery 时才受支持。有关详细信息,请参见“其他函数”(链接在新窗口中打开)

返回顶部

H

HEXBINX

语法HEXBINX(number, number)
输出数字
定义将 x、y 坐标映射到最接近的六边形数据桶的 x 坐标。数据桶的边长为 1,因此,可能需要相应地缩放输入。
示例
HEXBINX([Longitude]*2.5, [Latitude]*2.5)
说明HEXBINX HEXBINY 是用于六边形数据桶的分桶和标绘函数。六边形数据桶是对 x/y 平面(例如地图)中的数据进行可视化的有效而简洁的选项。由于数据桶是六边形的,因此每个数据桶都非常近似于一个圆,并最大程度地减少了从数据点到数据桶中心的距离变化。这使得聚类分析更加准确并且能提供有用的信息。

HEXBINY

语法HEXBINY(number, number)
输出数字
定义将 x、y 坐标映射到最接近的六边形数据桶的 y 坐标。数据桶的边长为 1,因此,可能需要相应地缩放输入。
示例
HEXBINY([Longitude]*2.5, [Latitude]*2.5)
说明另请参见 HEXBINX

HOST

HOST(string_url)

仅在连接到 Google BigQuery 时才受支持。有关详细信息,请参见“其他函数”(链接在新窗口中打开)

返回顶部

I

IF

语法IF <test1> THEN <then1>
[ELSEIF <test2> THEN <then2>...]
[ELSE <default>]
END
输出取决于 <then> 值的数据类型。
定义

测试一系列表达式,同时为第一个为 true 的 <test> 返回 <then> 值。

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

“如果 Season = Summer,,则返回 Sandals。否则,请查看下一个表达式。如果 Season = Winter,则返回 Boots。如果两个表达式都不为 true,则返回 Sneakers。”

说明

另请参见 IFIIF

ELSEIFTHENELSEEND 一起使用

IFNULL

语法IFNULL(expr1, expr2)
输出取决于 <expr> 值的数据类型。
定义

如果 <expr1> 不为 null,则返回该表达式,否则返回 <expr2>

示例
IFNULL([Assigned Room], "TBD")

“如果“Assigned Room”(分配的房间)字段不为 null,则返回其值。如果“Assigned Room”(分配的房间)字段为 null,则返回 TBD。”

说明

ISNULL 进行比较。IFNULL 始终返回一个值。ISNULL 返回一个布尔值(true 或 false)。

另请参见 ZN

IIF

语法IIF(<test>, <then>, <else>, [<unknown>])
输出取决于表达式中值的数据类型。
定义检查是否满足条件(<test>),并在 test 为 true 时返回 <then>,在 test 为 false 时返回 <else>,如果 test 为 null 则为可选值 <unknown>。如果未指定可选的 unknown,IIF 将返回 null。
示例
IIF([Season] = 'Summer', 'Sandals', 'Other footwear')

“如果 Season = Summer,,则返回 Sandals。否则返回 Other footwear”

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

“如果 Season = Summer,,则返回 Sandals。否则,请查看下一个表达式。如果 Season = Winter,则返回 Boots。如果两者均不为 true,则返回 Sneakers。”

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

“如果 Season = Summer,,则返回 Sandals。否则,请查看下一个表达式。如果 Season = Winter,则返回 Boots。如果没有一个表达式为 true,则返回 Sneakers。”

说明

另请参见 IFCASE

IIF 没有等同于 ELSEIF(如 IF)或重复 WHEN 子句(如 CASE)的语句。相反,可以通过将 IIF 语句嵌套为 <unknown> 元素来按顺序计算多个测试。返回第一个(最外面的)true。

也就是说,在下面的计算中,结果将是红色,而不是橙色,因为一旦 A=A 计算为 true,表达式就会停止计算:

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

IN

语法<expr1> IN <expr2>
输出布尔值(True 或 False)
定义如果 <expr1> 中的任何值与 <expr2> 中的任何值匹配,则返回 TRUE
示例
SUM([Cost]) IN (1000, 15, 200)

“Cost 字段的值是 1000、15 还是 200?”

[Field] IN [Set]

“该字段的值是否存在于集合中?”

说明

<expr2> 中的值可以是集、文本值列表或合并字段。

另请参见 WHEN

INCLUDE

有关详细信息,请参见详细级别表达式(链接在新窗口中打开)

INDEX

INDEX( )

有关详细信息,请参见表计算函数(链接在新窗口中打开)

INT

语法INT(expression)
输出整数
定义将其参数转换为整数。对于表达式,此函数将结果截断为最接近于 0 的整数。
示例
INT(8/3) = 2
INT(-9.7) = -9
说明

字符串转换为整数时会先转换为浮点数,然后舍入。

另请参见 FLOAT,它返回一个小数。
另请参见 ROUNDCEILINGFLOOR

INTERSECTS

语法INTERSECTS (<geometry1>, <geometry2>)
输出布尔值
定义返回 true 或 false,指示两个几何图形是否在空间中重叠。
说明支持的组合:点/多边形、线/多边形和多边形/多边形。

ISDATE

检查字符串是否为有效的日期格式。

语法ISDATE(string)
输出布尔值
定义如果给定 <string> 为有效日期,则返回 true。
示例
ISDATE(09/22/2018) = true
ISDATE(22SEP18) = false
说明所需的参数必须是字符串。ISDATE 不能用于日期数据类型的字段,计算将返回错误。

ISFULLNAME

语法ISFULLNAME("User Full Name")
输出布尔值
定义

如果当前用户的全名与指定的全名匹配,则返回 TRUE;如果不匹配,则返回 FALSE

示例
ISFULLNAME("Hamlin Myrer")
说明

<"User Full Name"> 参数必须是文字字符串,而非字段。

此函数检查:

  • Tableau CloudTableau Server:已登录用户的全名
  • Tableau Desktop:用户的本地或网络全名

ISMEMBEROF

语法ISMEMBEROF("Group Name")
输出布尔值或 null
定义

如果当前使用 Tableau 的用户是与给定字符串匹配的组的成员,则返回 TRUE,如果他们不是成员,则返回 FALSE,如果他们未登录,则返回 NULL

示例
ISMEMBEROF('Superstars')
ISMEMBEROF('domain.lan\Sales')
说明

<"Group Full Name"> 参数必须是文字字符串,而非字段。

如果用户已登录 Tableau CloudTableau Server,组成员身份由 Tableau 组确定。如果给定字符串是“All Users”,该函数将返回 TRUE

ISMEMBEROF( ) 函数也将接受 Active Directory 域。必须使用组名称在计算中声明 Active Directory 域。

ISNULL

语法ISNULL(expression)
输出布尔值(True 或 False)
定义

如果 <expression> 为 NULL(未包含有效数据),则返回 true。

示例
ISNULL([Assigned Room])

“Assigned Room(分配的房间)字段是否为 null?”

说明

IFNULL 进行比较。IFNULL 始终返回一个值。ISNULL 返回一个布尔值。

另请参见 ZN

ISOQUARTER

语法ISOQUARTER(date)
输出整数
定义以整数的形式返回给定 <date> 的基于 ISO8601 周的季度。
示例
ISOQUARTER(#1986-03-25#) = 1
说明另请参见 ISOWEEKISOWEEKDAYISOYEAR, 以及 -ISO 等效值。

ISOWEEK

语法ISOWEEK(date)
输出整数
定义以整数的形式返回给定 <date> 基于 ISO8601 周的周。
示例
ISOWEEK(#1986-03-25#) = 13
说明另请参见 ISOWEEKDAYISOQUARTERISOYEAR, 以及 -ISO 等效值。

ISOWEEKDAY

语法ISOWEEKDAY(date)
输出整数
定义以整数的形式返回给定 <date> 的基于 ISO8601 周的工作日。
示例
ISOWEEKDAY(#1986-03-25#) = 2
说明另请参见 ISOWEEKISOQUARTERISOYEAR, 以及 -ISO 等效值

ISOYEAR

语法ISOYEAR(date)
输出整数
定义以整数的形式返回给定日期的基于 ISO8601 周的年。
示例
ISOYEAR(#1986-03-25#) = 1,986
说明另请参见 ISOWEEKISOWEEKDAYISOQUARTER, 以及 -ISO 等效值。

ISUSERNAME

语法ISUSERNAME("username")
输出布尔值
定义如果当前用户的用户名与指定的 <username> 匹配,则返回 TRUE;如果不匹配,则返回 FALSE
示例
ISUSERNAME("hmyrer")
说明

<"username"> 参数必须是文字字符串,而非字段。

此函数检查:

  • Tableau CloudTableau Server:已登录用户的用户名
  • Tableau Desktop:用户的本地或网络用户名

返回顶部

J

返回顶部

K

返回顶部

L

LAST

LAST()

有关详细信息,请参见表计算函数(链接在新窗口中打开)

LEFT

语法 LEFT(string, number)
输出字符串
定义返回字符串最左侧一定 <number> 的字符。
示例
LEFT("Matador", 4) = "Mata"
说明另请参见 MIDRIGHT

LEN

语法LEN(string)
输出数字
定义返回 <string> 的长度。
示例
LEN("Matador") = 7
说明不要与空间函数 LENGTH 混淆。

LENGTH

语法LENGTH(geometry, 'units')
输出数字
定义使用给定的 <units> 返回 <geometry> 中的一个或多个线串的大地路径长度。
示例
LENGTH([Spatial], 'metres')
说明

如果 geometry 参数没有线串,则结果为 <NaN>,但允许使用其他元素。

不要与字符串函数 LEN 混淆。

LN

语法LN(number)
输出

数字

如果参数小于或等于零,则输出为 Null

定义返回 <number> 的自然对数。
示例
LN(50) = 3.912023005
说明另请参见 EXPLOG

LOG

语法LOG(number, [base])

如果可选的 base 参数不存在,则使用底数 10。

输出数字
定义返回以给定 <base> 为底的 <number> 的对数。
示例
LOG(16,4) = 2
说明另请参见 POWER LN

LOG2

LOG2(number)

仅在连接到 Google BigQuery 时才受支持。有关详细信息,请参见“其他函数”(链接在新窗口中打开)

LOOKUP

LOOKUP(expression, [offest])

有关详细信息,请参见表计算函数(链接在新窗口中打开)

LOWER

语法LOWER(string)
输出字符串
定义以全小写字符返回提供的 <string>
示例
LOWER("ProductVersion") = "productversion"
说明另请参见 UPPERPROPER

LTRIM

语法 LTRIM(string)
输出字符串
定义返回移除了所有前导空格的所提供的 <string>
示例
LTRIM(" Matador ") = "Matador "
说明另请参见 RTRIM

LTRIM_THIS

LTRIM_THIS(string, string)

仅在连接到 Google BigQuery 时才受支持。有关详细信息,请参见“其他函数”(链接在新窗口中打开)

返回顶部

M

MAKEDATE

语法MAKEDATE(year, month, day)
输出日期
定义返回一个依据指定 <year><month><day> 构造的日期值。
示例
MAKEDATE(1986,3,25) = #1986-03-25#
说明

注意,输入错误的值将被调整为一个日期,例如 MAKEDATE(2020,4,31) = May 1, 2020,而不是返回指出没有 4 月 31 日的错误。

可用于 Tableau 数据提取。检查在其他数据源中的可用性。

MAKEDATE 要求为日期的各个部分输入数字。如果您的数据是应该是日期的字符串,请尝试 DATE 函数。DATE 可自动识别许多标准的日期格式。如果 DATE 不能识别输入,请尝试使用 DATEPARSE

MAKEDATETIME

语法MAKEDATETIME(date, time)
输出日期时间
定义返回合并了 <date><time>的日期时间。日期可以是 date、datetime 或 string 类型。时间必须是 datetime。
示例
MAKEDATETIME("1899-12-30", #07:59:00#) = #12/30/1899 7:59:00 AM#
MAKEDATETIME([Date], [Time]) = #1/1/2001 6:00:00 AM#
说明

此函数仅适用于与 MySQL 兼容的连接(对于 Tableau 为 MySQL 和 Amazon Aurora)。

MAKETIME 是一个类似的函数,可用于 Tableau 数据提取和其他一些数据源。

MAKELINE

语法MAKELINE(SpatialPoint1, SpatialPoint2)
输出几何图形(线)
定义在两点之间生成线标记
示例
MAKELINE(MAKEPOINT(47.59, -122.32), MAKEPOINT(48.5, -123.1))
说明对于构建出发地-目的地地图很有用。

MAKEPOINT

语法MAKEPOINT(latitude, longitude, [SRID])
输出几何图形(点)
定义

将数据从 <latitude><longitude> 列转换为空间对象。

如果添加了可选的 <SRID> 参数,输入可以是其他投影地理坐标。

示例
MAKEPOINT(48.5, -123.1)
MAKEPOINT([AirportLatitude], [AirportLongitude])
MAKEPOINT([Xcoord],[Ycoord], 3493)
说明

MAKEPOINT 无法使用自动生成的纬度和经度字段。数据源必须包含本机坐标。

SRID 是一种空间参考标识符,它使用 ESPG 参考系代码(链接在新窗口中打开)来指定坐标系。如果未指定 SRID,则会假定 WGS84,并将参数视为纬度/经度(以度为单位)。

您可以使用 MAKEPOINT 使数据源具备空间特性,以便可以使用空间联接将其与空间文件联接。有关详细信息,请参见“在 Tableau 中联接空间文件”(链接在新窗口中打开)

MAKETIME

语法MAKETIME(hour, minute, second)
输出日期时间
定义返回一个依据指定 <hour><minute><second> 构造的日期值。
示例
MAKETIME(14, 52, 40) = #1/1/1899 14:52:40#
说明

由于 Tableau 不支持时间数据类型,只支持日期时间,因此输出是日期时间。字段的日期部分将是 1/1/1899。

类似于 MAKEDATETIME 的函数,只适用于 MYSQL 兼容的连接。

MAX

语法MAX(expression)MAX(expr1, expr2)
输出与参数相同的数据类型,或者,如果参数的任何部分为 null,则为 NULL 
定义

返回两个参数(必须为相同数据类型)中的最大值。

MAX 也可以聚合形式应用于单个字段。

示例
MAX(4,7) = 7
MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021#
MAX([Name]) = "Zander"
说明

对于字符串

MAX 通常是按字母顺序排在最后的值。

对于数据库数据源,MAX 字符串值在数据库为该列定义的排序序列中最高。

对于日期

对于日期,MAX 是最近的日期。如果 MAX 是聚合,结果不会有日期层次结构。如果 MAX 是比较,结果将保留日期层次结构。

作为聚合

MAX(expression) 是聚合函数,返回单个聚合结果。这在可视化项中显示为 AGG(expression)

作为比较

MAX(expr1, expr2) 比较这两个值并返回一个行级值。

另请参见 MIN

MEDIAN

语法MEDIAN(expression)
定义返回表达式在所有记录中的中位数。会忽略 Null 值。
说明MEDIAN 只能用于数字字段。
数据库限制

MEDIAN 适用于以下数据源:Access、Amazon Redshift、Cloudera Hadoop、HP Vertica、IBM DB2、IBM PDA (Netezza)、Microsoft SQL Server、MySQL、SAP HANA、Teradata。

对于其他数据源类型,可以将数据提取到数据提取文件以使用此函数。请参见提取数据(链接在新窗口中打开)

MID

语法(MID(string, start, [length])
输出字符串
定义

返回从指定 <start> 位置处开始的字符串t。字符串中第一个字符的位置为 1。

如果添加了可选数字参数 <length>,则返回的字符串仅包含该数量的字符。

示例
MID("Calculation", 2) = "alculation"
MID("Calculation", 2, 5) ="alcul"
说明另请参见附加函数文档(链接在新窗口中打开)中支持的正则表达式。

MIN

语法MIN(expression)MIN(expr1, expr2)
输出与参数相同的数据类型,或者,如果参数的任何部分为 null,则为 NULL 
定义

返回两个参数(必须为相同数据类型)中的最小值。

MIN 也可以聚合形式应用于单个字段。

示例
MIN(4,7) = 4
MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986#
MIN([Name]) = "Abebi"
说明

对于字符串

MIN 通常是按字母顺序排列在前面的值。

对于数据库数据源,MIN 字符串值在数据库为该列定义的排序序列中最低。

对于日期

对于日期,MIN 是最早的日期。如果 MIN 是聚合,结果不会有日期层次结构。如果 MIN 是比较,结果将保留日期层次结构。

作为聚合

MIN(expression) 是聚合函数,返回单个聚合结果。这在可视化项中显示为 AGG(expression)

作为比较

MIN(expr1, expr2) 比较这两个值并返回一个行级值。

另请参见 MAX

模型扩展程序

有关详细信息,请参见表计算函数(链接在新窗口中打开)

  • MODEL_EXTENSION_BOOL
  • MODEL_EXTENSION_INT
  • MODEL_EXTENSION_REAL
  • MODEL_EXTENSION_STR

MODEL_PERCENTILE

语法MODEL_PERCENTILE(
model_specification (optional),
target_expression,
predictor_expression(s))
定义返回期望值小于或等于观察标记的概率(介于 0 和 1 之间),由目标表达式和其他预测因子定义。这是后验预测分布函数,也称为累积分布函数 (CDF)。
示例
MODEL_PERCENTILE( SUM([Sales]),COUNT([Orders]))

MODEL_QUANTILE

语法MODEL_QUANTILE(
model_specification (optional),
quantile,
target_expression,
predictor_expression(s))
定义以指定的分位数返回由目标表达式和其他预测因子定义的可能范围内的目标数值。这是后验预测分位数。
示例
MODEL_QUANTILE(0.5, SUM([Sales]), COUNT([Orders]))

MONTH

语法MONTH(date)
输出整数
定义以整数形式返回给定 <date> 的月份。
示例
MONTH(#1986-03-25#) = 3
说明另请参见 DAYWEEK季度YEAR 以及 ISO 等效值

返回顶部

N

NOT

语法NOT <expression>
输出布尔值(True 或 False)
定义对一个表达式执行逻辑非运算。
示例
IF NOT [Season] = "Summer" 
THEN 'Don't wear sandals'
ELSE 'Wear sandals' 
END

“如果 Season 不等于 Summer,则返回 Don't wear sandals。否则,返回 Wear sandals。”

说明

通常与 IFIIF 一起使用。另请参见 本参考中的 Tableau 函数按字母顺序进行组织。单击某个字母可跳转到列表中的该位置。您也可以使用 Ctrl+F(在 Mac 上为 Command-F)打开一个搜索框,用于查找特定函数。或者

NOW

语法NOW()
输出日期时间
定义返回当前本地系统日期和时间。
示例
NOW() = 1986-03-25 1:08:21 PM
说明

NOW 不接受参数。

另请参见返回日期而不是日期时间的类似计算 TODAY

如果数据源是实时连接,则系统日期和时间可能位于另一个时区。有关如何解决此问题的详细信息,请参见知识库

返回顶部

O

或者

语法<expr1> OR <expr2>
输出布尔值(True 或 False)
定义对两个表达式执行逻辑析取操作。
示例
IF [Season] = "Spring" OR [Season] = "Fall" 
THEN "Sneakers"
END

“如果 (Season = Spring) 或 (Season = Fall) 为 true,则返回 Sneakers。”

说明

通常与 IFIIF 一起使用。另请参见 本参考中的 Tableau 函数按字母顺序进行组织。单击某个字母可跳转到列表中的该位置。您也可以使用 Ctrl+F(在 Mac 上为 Command-F)打开一个搜索框,用于查找特定函数。NOT

如果任一表达式为 TRUE,则结果为 TRUE。如果两个表达式都为 FALSE,则结果为 FALSE。如果两个表达式都为 NULL,则结果为 NULL

如果所创建的计算中的 OR 将比较结果显示在工作表上,则 Tableau 显示 TRUEFALSE。如果要更改此情况,请使用设置格式对话框中的“设置格式”区域。

注意OR 运算符使用短路计算。这表示如果第一个表达式计算为 TRUE,则根本不会计算第二个表达式。如果第二个表达式在第一个表达式为 TRUE 时产生错误,则这可能十分有用,因为在这种情况下从不计算第二个表达式。

OUTLINE

语法OUTLINE(<spatial polygon>)
输出几何图形
定义将多边形几何图形转换为线串。
说明

对于为轮廓创建单独的图层很有用,该图层的样式可以与填充不同。

支持多边形内的多边形。

返回顶部

P

PARSE_URL

PARSE_URL(string, url_part)

仅在连接到 Cloudera Impala 时受支持。有关详细信息,请参见“其他函数”(链接在新窗口中打开)

PARSE_URL_QUERY

PARSE_URL_QUERY(string, key)

仅在连接到 Cloudera Impala 时受支持。有关详细信息,请参见“其他函数”(链接在新窗口中打开)

PERCENTILE

语法PERCENTILE(expression, number)
定义返回给定 <expression> 中与指定 <number> 对应的百分位值。<number> 必须介于 0 到 1 之间(含 0 和 1),并且必须是数值常量。
示例
PERCENTILE([Score], 0.9)
数据库限制

此函数可用于以下数据源:非旧版 Microsoft Excel 和文本文件连接、数据提取和仅数据提取数据源类型(例如 Google Analytics、OData 或 Salesforce)、Sybase IQ 15.1 及更高版本数据源、Oracle 10 及更高版本的数据源、Cloudera Hive 和 Hortonworks Hadoop Hive 数据源、EXASolution 4.2 及更高版本的数据源。

对于其他数据源类型,可以将数据提取到数据提取文件以使用此函数。请参见提取数据(链接在新窗口中打开)

PI

语法PI()
输出数字
定义返回数字常量 pi:3.14159。
示例
PI() = 3.14159
说明对于以弧度为输入的三角函数非常有用。

POWER

语法POWER(number, power)
输出数字
定义计算 <number> 的指定次 <power>
示例
POWER(5,3) = 125
POWER([Temperature], 2)
说明也可以使用 ^ 符号,例如 5^3 = POWER(5,3) = 125

另请参见 EXPLOGSQUARE

PREVIOUS_VALUE

PREVIOUS_VALUE(expression)

有关详细信息,请参见表计算函数(链接在新窗口中打开)

PROPER

语法PROPER(string)
输出字符串
定义

返回所提供的 <string>,每个单词的第一个字母大写,其余字母小写。

示例
PROPER("PRODUCT name") = "Product Name"
PROPER("darcy-mae") = "Darcy-Mae"
说明

空格和非字母数字字符(如标点符号)被视为分隔符。

另请参见 LOWERUPPER

返回顶部

Q

季度

语法QUARTER(date)
输出整数
定义以整数形式返回给定 <date> 的季度。
示例
QUARTER(#1986-03-25#) = 1
说明另请参见 DAYWEEKMONTHYEAR 以及 ISO 等效值

返回顶部

R

RADIANS

语法RADIANS(number)
输出数字(以弧度表示的角度)
定义将给定 <number> 从度数转换为弧度。
示例
RADIANS(180) = 3.14159
说明反函数 DEGREES 获取以弧度为单位的角度,并返回以度为单位的角度。

RANK 表计算函数

有关详细信息,请参见表计算函数(链接在新窗口中打开)

  • RANK(expression, ['asc' | 'desc'])
  • RANK_DENSE(expression, ['asc' | 'desc'])
  • RANK_MODIFIED(expression, ['asc' | 'desc'])
  • RANK_PERCENTILE(expression, ['asc' | 'desc'])
  • RANK_UNIQUE(expression, ['asc' | 'desc'])

RAWSQL 函数

有关详细信息,请参见直通函数 (RAWSQL)(链接在新窗口中打开)

  • RAWSQL_BOOL("sql_expr", [arg1], … [argN])
  • RAWSQL_DATE("sql_expr", [arg1], … [argN])
  • RAWSQL_DATETIME("sql_expr", [arg1], … [argN])
  • RAWSQL_INT("sql_expr", [arg1], … [argN])
  • RAWSQL_REAL("sql_expr", [arg1], … [argN])
  • RAWSQL_SPATIAL
  • RAWSQL_STR("sql_expr", [arg1], … [argN])
  • RAWSQLAGG_BOOL("sql_expr", [arg1], … [argN])
  • RAWSQLAGG_DATE("sql_expr", [arg1], … [argN])
  • RAWSQLAGG_DATETIME("sql_expr", [arg1], … [argN])
  • RAWSQLAGG_INT("sql_expr", [arg1], … [argN])
  • RAWSQLAGG_REAL("sql_expr", [arg1], … [argN])
  • RAWSQLAGG_STR("sql_expr", [arg1], … [argN])

REGEXP 函数

有关详细信息,请参见“其他函数”(链接在新窗口中打开)

  • REGEXP_EXTRACT(string, pattern)
  • REGEXP_EXTRACT_NTH(string, pattern, index)
  • REGEXP_EXTRACT_NTH(string, pattern, index)
  • REGEXP_MATCH(string, pattern)
  • REGEXP_REPLACE(string, pattern, replacement)

REPLACE

语法REPLACE(string, substring, replacement
输出字符串
定义<string> 中搜索 <substring> 并将其替换为 <replacement>。如果未找到 <substring>,则字符串保持不变。
示例
REPLACE("Version 3.8", "3.8", "4x") = "Version 4x"
说明另请参见附加函数文档(链接在新窗口中打开)中的 REGEXP_REPLACE
语法RIGHT(string, number)
输出字符串
定义返回字符串最右侧一定 <number> 的字符。
示例
RIGHT("Calculation", 4) = "tion"
说明另请参见 LEFTMID

ROUND

语法ROUND(number, [decimals])
输出数字
定义

<number> 舍入为指定位数。

decimals 可选参数指定要在最终结果中包含的小数位数精度。如果省略 decimals,则 number 舍入为最接近的整数。

示例
ROUND(1/3, 2) = 0.33
说明

某些数据库(例如 SQL Server)允许指定负长度,其中 -1 将数字舍入为 10 的倍数,-2 舍入为 100 的倍数,依此类推。此功能并不适用于所有数据库。例如,Excel 和 Access 不具备此功能。

提示:由于 ROUND 可能会因数字的基础浮点表示而遇到问题 — 例如 9.405 四舍五入到 9.40 — 最好将数字格式化为所需的小数位数而不是四舍五入。将 9.405 格式化为两位小数将产生预期的 9.41。

另请参见 CEILINGFLOOR

RTRIM

语法RTRIM(string)
输出字符串
定义返回移除了所有尾随空格的所提供的 <string>
示例
RTRIM(" Calculation ") = " Calculation"
说明另请参见 LTRIMTRIM

RTRIM_THIS

RTRIM_THIS(string, string)

仅在连接到 Google BigQuery 时才受支持。有关详细信息,请参见“其他函数”(链接在新窗口中打开)

RUNNING 表计算函数

有关详细信息,请参见表计算函数(链接在新窗口中打开)

  • RUNNING_AVG(expression)
  • RUNNING_COUNT(expression)
  • RUNNING_MAX(expression)
  • RUNNING_MIN(expression)
  • RUNNING_SUM(expression)

返回顶部

S

SCRIPT 分析扩展程序

有关详细信息,请参见表计算函数(链接在新窗口中打开)

  • SCRIPT_BOOL
  • SCRIPT_INT
  • SCRIPT_REAL
  • SCRIPT_STR

SHAPETYPE

语法SHAPETYPE(<geometry>)
输出字符串
定义返回描述空间几何结构的字符串,例如 Empty、Point、MultiPoint、LineString、MultiLinestring、Polygon、MultiPolygon、Mixed 和不支持
示例
SHAPETYPE(MAKEPOINT(48.5, -123.1)) = "Point"

SIGN

语法SIGN(number)
输出-1、0 或 1
定义返回 <number> 的符号:可能的返回值为:在数字为负时为 -1,在数字为零时为 0,在数字为正时为 1。
示例
SIGN(AVG(Profit)) = -1
说明另请参见 ABS

SIN

语法SIN(number)
输出数字
定义以弧度为单位返回角度的正弦值。
示例
SIN(0) = 1.0
SIN(PI( )/4) = 0.707106781186548
说明

反函数 ASIN 以正弦作为参数并返回以弧度为单位的角度。

另请参见 PI。若要将角度从度数转换为弧度,请使用 RADIANS

SIZE

SIZE()

有关详细信息,请参见表计算函数(链接在新窗口中打开)

SPACE

语法SPACE(number)
输出字符串(具体来说,只是空格)
定义返回由指定数量的重复空格组成的字符串。
示例
SPACE(2) = "  "

SPLIT

语法SPLIT(string, delimiter, token number)
输出字符串
定义返回 <string> 中的一个子字符串,并使用 <delimiter> 字符将字符串分为一系列 <tokens>
示例
SPLIT ("a-b-c-d", "-", 2) = "b"
SPLIT ("a|b|c|d", "|", -2) = "c"
说明

字符串将被解释为分隔符和标记的交替序列。因此,对于字符串 abc-defgh-i-jkl,分隔符字符为“-”,标记为 (1) abc、(2) defgh、(3) i 和 (4) jlk

SPLIT 将返回与标记编号对应的标记。如果标记编号为正,则从字符串的左侧开始计算标记;如果标记编号为负,则从右侧开始计算标记。

另请参见附加函数文档(链接在新窗口中打开)中支持的正则表达式。

数据库限制

可以为以下数据源类型使用拆分和自定义拆分命令:Tableau 数据提取、Microsoft Excel、文本文件、PDF 文件、Salesforce、OData、Microsoft Azure Market Place、Google Analytics(分析)、Vertica、Oracle、MySQL、PostgreSQL、Teradata、Amazon Redshift、Aster 数据、Google Big Query、Cloudera Hadoop Hive、Hortonworks Hive 和 Microsoft SQL Server。

某些数据源在拆分字符串时会有限制。请参见本主题后面的 SPLIT 函数限制。

SQRT

语法SQRT(number)
输出数字
定义返回 <number> 的平方根。
示例
SQRT(25) = 5
说明另请参见 SQUARE

SQUARE

语法SQUARE(number)
输出数字
定义返回 <number> 的平方。
示例
SQUARE(5) = 25
说明另请参见 SQRTPOWER

STARTSWITH

语法STARTSWITH(string, substring)
输出布尔值
定义如果 stringsubstring 开头,则返回 true。会忽略前导空格。
示例
STARTSWITH("Matador, "Ma") = TRUE
说明另请参见附加函数文档(链接在新窗口中打开)中的 CONTAINS 以及支持的正则表达式。

STDEV

语法STDEV(expression)
定义基于群体样本返回给定 <expression> 中所有值的统计标准差。

STDEVP

语法STDEVP(expression)
定义基于有偏差群体返回给定<expression>中所有值的统计标准差。

STR

语法STR(expression)
输出字符串
定义将其参数转换为字符串。
示例
STR([ID])

SUM

语法SUM(expression)
定义返回 <expression> 中所有值的总计。会忽略 Null 值。
说明SUM 只能用于数字字段。

返回顶部

T

TAN

语法TAN(number)

<number> 参数是以弧度表示的角度。

输出数字
定义返回角度的正切。
示例
TAN(PI ( )/4) = 1.0
说明另请参见 ATANATAN2COTPI。若要将角度从度数转换为弧度,请使用 RADIANS

THEN

语法IF <test1> THEN <then1>
[ELSEIF <test2> THEN <then2>...]
[ELSE <default>]
END
定义IFELSEIFCASE表达式的必需部分,用于定义如果特定值或测试为 true 则返回什么结果。
示例
IF [Season] = "Summer" THEN 'Sandals' 
ELSEIF [Season] = "Winter" THEN 'Boots'
ELSE 'Sneakers' 
END

“如果 Season = Summer,,则返回 Sandals。否则,请查看下一个表达式。如果 Season = Winter,则返回 Boots。如果两个表达式都不为 true,则返回 Sneakers。”

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

“看看“Season”字段。如果值为 Summer,则返回 Sandals。如果值为 Winter,则返回 Boots。如果计算中的选项均不匹配“Season”字段中的选项,则返回 Sneakers。”

说明

CASEWHENIFELSEIFTHENELSEEND 一起使用

TIMESTAMP_TO_USEC

TIMESTAMP_TO_USEC(expression)

仅在连接到 Google BigQuery 时才受支持。有关详细信息,请参见“其他函数”(链接在新窗口中打开)

TLD

TLD(string_url)

仅在连接到 Google BigQuery 时才受支持。有关详细信息,请参见“其他函数”(链接在新窗口中打开)

TODAY

语法TODAY()
输出日期
定义返回当前本地系统日期。
示例
TODAY() = 1986-03-25
说明

TODAY 不接受参数。

另请参见返回日期时间而不是日期的类似计算 NOW

如果数据源是实时连接,则系统日期可能位于另一个时区。有关如何解决此问题的详细信息,请参见知识库

TOTAL

TOTAL(expression)

有关详细信息,请参见表计算函数(链接在新窗口中打开)

TRIM

语法TRIM(string)
输出字符串
定义返回移除了前导和尾随空格的所提供的 <string>
示例
TRIM(" Calculation ") = "Calculation"
说明另请参见 LTRIMRTRIM

返回顶部

U

UPPER

语法UPPER(string)
输出字符串
定义以全大写字符返回提供的 <string>
示例
UPPER("Calculation") = "CALCULATION"
说明另请参见 PROPERLOWER

USEC_TO_TIMESTAMP

USEC_TO_TIMESTAMP(expression)

仅在连接到 Google BigQuery 时才受支持。有关详细信息,请参见“其他函数”(链接在新窗口中打开)

USERDOMAIN

语法USERDOMAIN( )
输出字符串
定义返回当前用户的域。
说明

此函数检查:

  • Tableau CloudTableau Server:登录用户的用户域
  • Tableau Desktop:如果用户在域上,则为本地域

USERNAME

语法USERNAME( )
输出字符串
定义返回当前用户的用户名。
示例
USERNAME( )

此函数返回已登录用户的用户名,例如“hmyrer”。

[Manager] = USERNAME( )

如果经理“hmyrer”已登录,则仅当视图中的“Manager”字段包含“hmyrern”时,此示例才会返回 TRUE。

说明

此函数检查:

  • Tableau CloudTableau Server:已登录用户的用户名
  • Tableau Desktop:用户的本地或网络用户名

用户筛选器

用作筛选器时,计算字段(例如 [Username field] = USERNAME( ))可用于创建用户筛选器,该筛选器仅显示与登录到服务器的人员相关的数据。

USER ATTRIBUTE JSON Web 令牌函数

  • USERATTRIBUTE('attribute_name')
  • USERATTRIBUTEINCLUDES('attribute_name', 'expected_value')

有关详细信息,请参见用户函数(链接在新窗口中打开)

返回顶部

V

VAR

语法VAR(expression)
定义基于群体样本返回给定表达式中所有值的统计方差。

VARP

语法VARP(expression)
定义对整个群体返回给定表达式中所有值的统计方差。

返回顶部

W

WEEK

语法WEEK(date)
输出整数
定义以整数形式返回给定 <date> 的周。
示例
WEEK(#1986-03-25#) = 13
说明另请参见 DAYMONTH季度YEAR 以及 ISO 等效值

WHEN

语法CASE <expression>
WHEN <value1> THEN <then1>
WHEN <value2> THEN <then2>
...
[ELSE <default>]
END
定义CASE 表达式的必需部分。查找第一个与 <expression> 匹配的 <value>,并返回对应的 <then>
示例
CASE [Season] 
WHEN 'Summer' THEN 'Sandals'
WHEN 'Winter' THEN 'Boots'
ELSE 'Sneakers'
END

“看看“Season”字段。如果值为 Summer,则返回 Sandals。如果值为 Winter,则返回 Boots。如果计算中的选项均不匹配“Season”字段中的选项,则返回 Sneakers。”

说明

CASETHENELSEEND 一起使用。

CASE 也支持 WHEN IN构造,例如:

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

WHEN IN 中的值可以是集、文本值列表或合并字段。另请参见 IN

窗口表计算

有关详细信息,请参见表计算函数(链接在新窗口中打开)

  • WINDOW_AVG(expression, [start, end])
  • WINDOW_CORR(expression1, expression2, [start, end])
  • WINDOW_COUNT(expression, [start, end])
  • WINDOW_COVAR(expression1, expression2, [start, end])
  • WINDOW_COVARP(expression1, expression2, [start, end])
  • WINDOW_MAX(expression, [start, end])
  • WINDOW_MEDIAN(expression, [start, end])
  • WINDOW_MIN(expression, [start, end])
  • WINDOW_PERCENTILE(expression, number, [start, end])
  • WINDOW_STDEV(expression, [start, end])
  • WINDOW_STDEVP(expression, [start, end])
  • WINDOW_SUM(expression, [start, end])
  • WINDOW_VAR(expression, [start, end])
  • WINDOW_VARP(expression, [start, end])

返回顶部

X

XPATH 函数。

在连接到 Hadoop Hive 时受支持。有关详细信息,请参见直通函数 (RAWSQL)(链接在新窗口中打开)

  • XPATH_BOOLEAN(XML string, XPath expression string)
  • XPATH_DOUBLE(XML string, XPath expression string)
  • XPATH_FLOAT(XML string, XPath expression string)
  • XPATH_INT(XML string, XPath expression string)
  • XPATH_LONG(XML string, XPath expression string)
  • XPATH_SHORT(XML string, XPath expression string)
  • XPATH_STRING(XML string, XPath expression string)

返回顶部

Y

YEAR

语法YEAR(date)
输出整数
定义以整数形式返回给定 <date> 的年份。
示例
YEAR(#1986-03-25#) = 1,986
说明另请参见 DAYWEEKMONTH季度 以及 ISO 等效值

返回顶部

Z

ZN

语法ZN(expression)
输出取决于 <expression> 的数据类型,或者为 0。
定义如果 <expression> 不为 null,则返回该表达式,否则返回零。
示例
ZN([Test Grade])

“如果测试成绩不为 null,则返回其值。如果测试成绩为 null,则返回 0。”

说明

ZNIFNULL 的特殊情况,其中如果表达式为 null,则替代项始终为 0,而不是在计算中指定。

ZN 在执行额外计算时特别有用,并且 null 将使整个计算为 null。但是,请谨慎将这些结果解释为 null 并不总是与 0 同义,并且可能代表缺失数据。

另请参见 ISNULL

返回顶部

另请参见

Tableau 函数(按类别)(链接在新窗口中打开)

Tableau 中的函数(链接在新窗口中打开)

感谢您的反馈!您的反馈已成功提交。谢谢!