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])

第二個範例傳回「預算差異」欄位中包含的所有數字的絕對值。

說明另請參閱 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 一起使用。另請參閱 NOTOR

若兩個運算式均為 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

WHENyou can rerun the query or viewELSEEND 一起使用。

提示:很多時候,可以使用群組來取得與複雜的 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(number)
輸出字串
定義返回透過 ASCII 代碼 <number> 編碼的字元。
範例
CHAR(65) = 'A'
說明這是 ASCII 函數的反函數。

收集

語法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)

數字引數是以弧度表示的角度。

輸出數字
定義返回角度的余弦。
範例
COS(PI( ) /4) = 0.707106781186548
說明

反函數 ACOS 以餘弦作為引數,並傳回以弧度表示的角度。

另請參閱 PI

COT

語法COT(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 是非 null 資料點的總數。如果存在可用於所有相關項目的資料,則母體共變異數是合適的選取,與之相反,在只有隨機項目子集的情況下,樣本共變異數(及 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、Verez

對於其他資料來源,請考慮擷取資料或使用 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>。例如,將開始日期新增三個月或 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# 

(包含 9/22/2018 的那個季度的第一天)

附註:如果是週和 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
說明另請參閱 WEEKMONTHQuarterYEAR,以及 ISO 等值

DEGREES

語法DEGREES(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
說明

CASEWHENIFELSEIFyou can rerun the query or viewEND 一起使用

ELSECASEIF 的可選項。在未指定 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
說明

IFyou can rerun the query or viewELSEEND 一起使用

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 [運動鞋]。」

說明

CASEWHENIFELSEIFyou can rerun the query or viewELSE 一起使用。

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()

有關詳情,請參閱Tableau 計算函數(連結在新視窗開啟)

FIXED

有關詳情,請參閱詳細層級運算式(連結在新視窗開啟)

浮點數

語法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」已登入,則僅檢視中的「經理」欄位包含「Hamlin Myrer」時,此範例才會傳回 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

ELSEIFyou can rerun the query or viewELSEEND 一起使用

IFNULL

語法IFNULL(expr1, expr2)
輸出取決於 <expr> 值的資料類型。
定義

<expr1> 不為 NULL,則傳回該運算式,否則傳回 <expr2>

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

「如果『指派的房間』欄位不是 Null,傳回其值。如果『指派的房間』欄位為 Null,則傳回 TBD。」

說明

ISNULL 進行比較。IFNULL 會始終傳回一個值。ISNULL  <x> 會傳回一個布林值(TRUE 或 FALSE)。

另請參閱 ZN

IIF

語法IIF(<test>, <then>, <else>, [<unknown>])
輸出取決於運算式中值的資料類型。
定義檢查是否符合條件 (<test>),若測試為 TRUE,則傳回 <then>;若測試為 FALSE,則傳回 <else>;若測試為 NULL,則傳回 <unknown> 的可選值。若未指定可選的 unknown,則 IIF 傳回 NULL。
範例
IIF([Season] = 'Summer', 'Sandals', 'Other footwear')

「若 Season = Summer [季節 = 夏季],則傳回 Sandals [涼鞋]。若不是,傳回其他鞋類」

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

「若 Season = Summer [季節 = 夏季],則傳回 Sandals [涼鞋]。如果不是,請看下一個運算式。若 Season = Winter [季節 = 冬季],則傳回 Boots [靴子]。若兩者均不為 TRUE,則傳回『運動鞋』。」

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。

也就是說,在下面的計算中,結果將為 Red [紅色],而不是 Orange [橙色],因為一旦 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)

「『成本』欄位的值是 1000、15 還是 200?」

[Field] IN [Set]

「該欄位的值是否存在於集合中?」

說明

<expr2> 中的值可以為固定的常值清單或合併欄位。

另請參閱 WHEN

INCLUDE

有關詳情,請參閱詳細層級運算式(連結在新視窗開啟)

INDEX

INDEX( )

有關詳情,請參閱Tableau 計算函數(連結在新視窗開啟)

INT

語法INT(expression)
輸出整數
定義將其參數轉換為整數。對於運算式,此函數將結果截斷為最接近於 0 的整數。
範例
INT(8/3) = 2
INT(-9.7) = -9
說明

字串轉換為整數時會先轉換為浮點數,然後舍入。

另請參閱 浮點數,其傳回小數。
另請參閱 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 Cloud 或者 Tableau Server,群組成員資格由 Tableau 群組決定。若指定字串是「All Users」,則函數將傳回 TRUE

ISMEMBEROF( ) 函數也接受 Active Directory 網域。必須使用群組名稱在計算中宣告 Active Directory 網域。

ISNULL

語法ISNULL(expression)
輸出布林值 (True 或 False)
定義

<expression> 為 NULL(不包含有效資料),則傳回 TRUE。

範例
ISNULL([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()

有關詳情,請參閱Tableau 計算函數(連結在新視窗開啟)

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')
說明

若幾何圖形引數沒有線串,則結果為 <NaN>,但允許使用其他元素。

不要與字串函數 LEN 混淆。

LN

語法LN(number)
輸出

數字

若引數小於或等於 0,則輸出為 Null

定義傳回 <number> 的自然對數。
範例
LN(50) = 3.912023005
說明另請參閱 EXPLOG

LOG

語法LOG(number, [base])

若可選的底數引數不存在,則使用底數 10。

輸出數字
定義傳回以給定 <base> 為底的 <number> 對數。
範例
LOG(16,4) = 2
說明另請參閱 POWER LN

LOG2

LOG2(number)

僅在連線到 Google BigQuery 時受支援。有關詳情,請參閱其他函數(連結在新視窗開啟)

LOOKUP

LOOKUP(expression, [offest])

有關詳情,請參閱Tableau 計算函數(連結在新視窗開啟)

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> 位置開始的字串。字串中第一個字元的位置為 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

模型擴充功能

有關詳情,請參閱Tableau 計算函數(連結在新視窗開啟)

  • 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
說明另請參閱 DAYWEEKQuarterYEAR,以及 ISO 等值

回到頁首

N

NOT

語法NOT <expression>
輸出布林值 (True 或 False)
定義對一個運算式執行邏輯非運算。
範例
IF NOT [Season] = "Summer" 
THEN 'Don't wear sandals'
ELSE 'Wear sandals' 
END

「如果『季節』不等於『夏天』,就傳回『不要』穿涼鞋。如果不是,就傳回『穿』涼鞋。」

說明

經常與 IFIIF 一起使用。另請參閱 本參考中的 Tableau 函數按字母順序進行組織。點選某個字母可跳到清單中的該位置。您也可以使用 Ctrl+F(Mac 上為 Command-F)開啟搜尋方塊來尋找特定功能。OR

NOW

語法NOW()
輸出日期時間
定義傳回目前本機系統日期和時間。
範例
NOW() = 1986-03-25 1:08:21 PM
說明

NOW 沒有採用引數。

另請參閱 TODAY,這是一個類似的計算,它傳回日期而不是日期時間。

如果資料來源是即時連線,則係統日期和時間可能位於另一個時區。有關如何聯接資料的詳情,請參閱知識庫

回到頁首

O

OR

語法<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)

有關詳情,請參閱Tableau 計算函數(連結在新視窗開啟)

PROPER

語法PROPER(string)
輸出字串
定義

傳回提供的 <string>,其中每個單字的第一個字母大寫,其餘字母小寫。

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

空格和非英數字元(如標點符號)也用作分隔符號。

另請參閱 LOWERUPPER

回到頁首

Q

Quarter

語法QUARTER(date)
輸出整數
定義以整數的形式傳回給定 <date> 的季度。
範例
QUARTER(#1986-03-25#) = 1
說明另請參閱 DAYWEEKMONTHYEAR,以及 ISO 等值

回到頁首

R

RADIANS

語法RADIANS(number)
輸出數字(以弧度表示的角度)
定義將給定的 <number> 從度數轉換為弧度。
範例
RADIANS(180) = 3.14159
說明反函數 DEGREES 取得以弧度表示的角度,並傳回以度表示的角度。

RANK 資料表計算函數

有關詳情,請參閱Tableau 計算函數(連結在新視窗開啟)

  • 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,則數字將四捨五入到最近的整數。

範例
ROUND(1/3, 2) = 0.33
說明

某些資料庫(例如 SQL Server)允許指定負長度,其中 -1 將數字四捨五入到十位,-2 四捨五入到百位,依此類推。此功能並不適用於所有資料庫。例如,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 資料表計算函數

有關詳情,請參閱Tableau 計算函數(連結在新視窗開啟)

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

回到頁首

S

SCRIPT 分析擴充功能

有關詳情,請參閱Tableau 計算函數(連結在新視窗開啟)

  • 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()

有關詳情,請參閱Tableau 計算函數(連結在新視窗開啟)

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 Data、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

you can rerun the query or view

語法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 [運動鞋]。」

說明

CASEWHENIFELSEIFyou can rerun the query or viewELSEEND 一起使用

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)

有關詳情,請參閱Tableau 計算函數(連結在新視窗開啟)

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」已登入,則僅檢視中的「經理」欄位包含「hmyrer」時,此範例才會傳回 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
說明另請參閱 DAYMONTHQuarterYEAR,以及 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 [運動鞋]。」

說明

CASEyou can rerun the query or viewELSEEND 一起使用。

CASE 也支援 WHEN IN 建構,例如:

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

WHEN IN 比較的值必須是集合、常值清單或合併欄位。另請參閱 IN

窗格表計算

有關詳情,請參閱Tableau 計算函數(連結在新視窗開啟)

  • 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
說明另請參閱 DAYWEEKMONTHQuarter,以及 ISO 等值

回到頁首

Z

ZN

語法ZN(expression)
輸出取決於 <expression> 的資料類型,或為 0。
定義<expression> 不為 NULL,則傳回該運算式,否則傳回 0。
範例
ZN([Test Grade])

「若測驗成績不為 NULL,則傳回其值。若測驗成績為 NULL,則傳回 0。」

說明

ZNIFNULL 的特殊情況,其中若運算式為 NULL,則替代項始終為 0,而不是在計算中指定。

ZN 在執行額外計算時特別有用,並且 NULL 會讓整個計算為 NULL。但是,請謹慎,將這些結果解譯為 NULL 並不總是與 0 同義,並且可能表示缺失資料。

另請參閱 ISNULL

回到頁首

另請參閱

Tableau 函數(按類別)(連結在新視窗開啟)

Tableau 中的函數(連結在新視窗開啟)

感謝您的意見反應!已成功提交您的意見回饋。謝謝!