---
schema_version: "1"
id: 470c6b7b8fce06055ce81653b8b0d662d6367b742024c33475f8ed63eb03fb7f
title: 所有函數（按字母順序）
collection: tableau
version: current
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/current/zh-tw/pro/desktop/functions_all_alphabetical.md
canonical_url: https://help.tableau.com/current/pro/desktop/zh-tw/functions_all_alphabetical.htm
source_site: help.tableau.com
content_type: documentation
content_hash: b8a0648eca59f4cd06da55f0a4321489ce78400607ee75a3e3f1b4a3e0f2f34f
description: Reference of all Tableau calculation functions organized in alphabetical order.
---
[跳至主要內容](#main-content)

# Tableau 函數（按字母順序）

本參考中的 Tableau 函數按字母順序進行組織。點選某個字母可跳到清單中的該位置。您也可以使用 Ctrl+F（Mac 上為 Command-F）開啟搜尋方塊來尋找特定功能。

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

  

## A

### ABS

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ABS(number)</code></td></tr><tr><td>輸出</td><td>數字（正數）</td></tr><tr><td>定義</td><td>傳回指定 <code>&lt;number&gt;</code> 的絕對值。</td></tr><tr><td>範例</td><td><pre>ABS(-7) = 7<br>ABS([Budget Variance])</pre><p>第二個範例傳回「預算差異」欄位中包含的所有數字的絕對值。</p></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#SIGN" class="xref">SIGN</a></code>。</td></tr></tbody></table>

### ACOS

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ACOS(number)</code></td></tr><tr><td>輸出</td><td>數字（以弧度表示的角度）</td></tr><tr><td>定義</td><td>傳回給定 <code>&lt;number&gt;</code> 的反餘弦（角度）。</td></tr><tr><td>範例</td><td><pre>ACOS(-1) = 3.14159265358979</pre></td></tr><tr><td>說明</td><td>反函數 <code><a href="#COS" class="xref">COS</a></code> 以弧度表示的角度作為引數，並傳回餘弦。</td></tr></tbody></table>

### AND

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>&lt;expr1&gt; AND &lt;expr2&gt;</code></td></tr><tr><td>定義</td><td>對兩個運算式執行邏輯合取運算。（如果雙方都為 true，則邏輯測試傳回 true。）</td></tr><tr><td>輸出</td><td>布林值</td></tr><tr><td>範例</td><td><pre>IF [Season] = "Spring" AND "[Season] = "Fall" <br>THEN "It's the apocalypse and footwear doesn't matter" <br>END</pre><p><i>「若（Season = Spring [季節 = 春季]）和（Season = Fall [季節 = 秋季]）同時為 TRUE，則傳回 It's the apocalypse and footwear doesn't matter [現在是世界末日，穿什麼鞋無關緊要]。」</i></p></td></tr><tr><td>說明</td><td><p>經常與 <a href="#IF" class="xref">IF</a> 和 <a href="#IIF" class="xref">IIF</a> 一起使用。另請參閱 <a href="#NOT" class="xref">NOT</a> 和 <a href="#OR" class="xref">OR</a>。</p><p>若兩個運算式均為 <code>TRUE</code>（即非 <code>FALSE</code> 或 <code>NULL</code>），則結果為 <code>TRUE</code>。如果任一運算式為 <code>NULL</code>，則結果為 <code>NULL</code>。在所有其他情況下，結果都為 <code>FALSE</code>。</p><p>如果所建立的計算中的 <code>AND</code> 比較結果顯示在工作表上，則 Tableau 顯示 <code>TRUE</code> 和 <code>FALSE</code>。如果要變更此情況，請使用設定格式對話方塊中的「設定格式」區域。</p><p class="note"><b>附註</b>：<code>AND</code> 運算元使用<i>短路求值</i>。這表示如果第一個運算式計算為 <code>FALSE</code>，則根本不會計算第二個運算式。如果第二個運算式在第一個運算式為 <code>FALSE</code> 時產生錯誤，則這可能十分有用，因為在這種情況下從不計算第二個運算式。</p></td></tr></tbody></table>

### AREA

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>AREA(Spatial Polygon, 'units')</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>傳回 <code>&lt;spatial polygon&gt;</code> 的總表面積。</td></tr><tr><td>範例</td><td><pre xml:space="preserve">AREA([Geometry], 'feet')</pre></td></tr><tr><td>說明</td><td><p>支援的單位名稱（計算時必須用引號括起來，例如 <code>'miles'</code>）：</p><ul><li><i>公尺</i>：meters、metres、m</li><li><i>公里</i>：kilometers、kilometres、km</li><li><i>英里</i>：miles、mi</li><li><i>英尺</i>：feet、ft</li></ul><p></p></td></tr></tbody></table>

### ASCII

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ASCII(string)</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>傳回 <code>&lt;string&gt;</code> 的第一個字元的 ASCII 碼。</td></tr><tr><td>範例</td><td><pre>ASCII('A') = 65</pre></td></tr><tr><td>說明</td><td>這是 <code>CHAR</code> 函數的反函數。</td></tr></tbody></table>

### ASIN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ASIN(number)</code></td></tr><tr><td>輸出</td><td>數字（以弧度表示的角度）</td></tr><tr><td>定義</td><td>傳回給定 <code>&lt;number&gt;</code> 的反正弦（角度）。</td></tr><tr><td>範例</td><td><pre>ASIN(1) = 1.5707963267949</pre></td></tr><tr><td>說明</td><td>反函數 <code><a href="#SIN" class="xref">SIN</a></code> 以弧度表示的角度作為引數，並傳回正弦。</td></tr></tbody></table>

### ATAN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ATAN(number)</code></td></tr><tr><td>輸出</td><td>數字（以弧度表示的角度）</td></tr><tr><td>定義</td><td>傳回給定 <code>&lt;number&gt;</code> 的反正切（角度）。</td></tr><tr><td>範例</td><td><pre>ATAN(180) = 1.5652408283942</pre></td></tr><tr><td>說明</td><td><p>反函數 <code>TAN</code> 以弧度表示的角度作為引數，並傳回正切。</p><p>另請參閱 <code><a href="#ATAN2" class="xref">ATAN2</a></code> 和 <code><a href="#COT" class="xref">COT</a></code>。</p></td></tr></tbody></table>

### ATAN2

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ATAN2(y number, x number)</code></td></tr><tr><td>輸出</td><td>數字（以弧度表示的角度）</td></tr><tr><td>定義</td><td>傳回兩個數字 （<code>&lt;y number&gt;</code> 和 <code>&lt;x number&gt;</code>） 之間的反正切（角度）。結果以弧度表示。</td></tr><tr><td>範例</td><td><pre>ATAN2(2, 1) = 1.10714871779409</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#ATAN" class="xref">ATAN</a></code>、<code><a href="#TAN" class="xref">TAN</a></code> 和 <code><a href="#COT" class="xref">COT</a></code>。</td></tr></tbody></table>

### ATTR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ATTR(expression)</code></td></tr><tr><td>定義</td><td>如果 <code>&lt;expression&gt;</code> 的所有列都有一個值，則傳回該運算式的值。否則返回星號。會忽略 Null 值。</td></tr></tbody></table>

### AVG

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>AVG(expression)</code></td></tr><tr><td>定義</td><td>傳回 <code>&lt;expression&gt;</code> 中所有值的平均值。會忽略 Null 值。</td></tr><tr><td>說明</td><td><code>AVG</code> 只能用於數字欄位。</td></tr></tbody></table>

[回到頁首](#top)

## B

### BUFFER

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>BUFFER(Spatial Point, distance, 'units')</code></td></tr><tr><td>輸出</td><td>幾何圖形</td></tr><tr><td>定義</td><td>傳回以 <code>&lt;spatial point&gt;</code> 為中心的多邊形圖形，半徑由 <code>&lt;distance&gt;</code> 和 <code>&lt;unit&gt;</code> 值決定。</td></tr><tr><td>範例</td><td><pre>BUFFER([Spatial Point Geometry], 25, 'mi')</pre><pre>BUFFER(MAKEPOINT(47.59, -122.32), 3, 'km')</pre></td></tr><tr><td>說明</td><td><p>支援的單位名稱（計算時必須用引號括起來，例如 <code>'miles'</code>）：</p><ul><li><i>公尺</i>：meters、metres、m</li><li><i>公里</i>：kilometers、kilometres、km</li><li><i>英里</i>：miles、mi</li><li><i>英尺</i>：feet、ft</li></ul></td></tr></tbody></table>

[回到頁首](#top)

## C

### CASE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code><b>CASE</b> &lt;expression&gt; 
							<br>WHEN &lt;value1&gt; THEN &lt;then1&gt; 
							<br>WHEN &lt;value2&gt; THEN &lt;then2&gt; 
							<br>...
						<br>[ELSE &lt;default&gt;]<br>END</code></td></tr><tr><td>輸出</td><td>取決於 <code>&lt;then&gt;</code> 值的資料類型。</td></tr><tr><td>定義</td><td><p>計算 <code>expression</code>，並將其與指定選項（<code>&lt;value1&gt;</code>、<code>&lt;value2&gt;</code> 等）進行比較。遇到與運算式相符的 <code>value</code> 時，CASE 會傳回對應的 <code>return</code>。若未找到符合值，則傳回（可選）預設值。若沒有預設值且沒有值符合，則傳回 NULL。</p></td></tr><tr><td>範例</td><td><pre><code><b>CASE</b> [Season] <br>WHEN 'Summer' THEN 'Sandals' <br>WHEN 'Winter' THEN 'Boots' <br>ELSE 'Sneakers' <br>END</code></pre><p><i>「讓我們來看看 Season [季節] 欄位。若值為 Summer [夏季]，則傳回 Sandals [涼鞋]。若值為 Winter [冬季]，則傳回 Boots [靴子]。若計算中的選項均不符合 Season [季節] 欄位中的選項，則傳回 Sneakers [運動鞋]。」</i></p></td></tr><tr><td>說明</td><td><p>另請參閱 <a href="#IF" class="xref">IF</a> 和 <a href="#IIF" class="xref">IIF</a>。</p><p>與 <a href="#WHEN" class="xref">WHEN</a>、<a href="#THEN" class="xref">you can rerun the query or view</a>、<a href="#ELSE" class="xref">ELSE</a> 和 <a href="#END" class="xref">END</a> 一起使用。</p><blockquote><p>[!TIP]</p><p><b>提示</b>：很多時候，可以使用群組來取得與複雜的 CASE 函數相同的結果，或者使用 CASE 來取代原生分組功能，例如前面的範例。您可能想要測試哪種方法更適合您的情境。</p></blockquote></td></tr></tbody></table>

### CEILING

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>CEILING(number)</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>將 <code>&lt;number&gt;</code> 四捨五入為值相等或更大的最近整數。</td></tr><tr><td>範例</td><td><pre>CEILING(2.1) = 3</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#FLOOR" class="xref">FLOOR</a></code> 和 <code><a href="#ROUND" class="xref">ROUND</a></code>。</td></tr><tr><td>資料庫限制</td><td><p><code>CEILING</code> 可透過以下連接器使用：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。
</p></td></tr></tbody></table>

### 字元

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>CHAR(number)</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>返回透過 ASCII 代碼 <code>&lt;number&gt;</code> 編碼的字元。</td></tr><tr><td>範例</td><td><pre>CHAR(65) = 'A'</pre></td></tr><tr><td>說明</td><td>這是 <code>ASCII</code> 函數的反函數。</td></tr></tbody></table>

### 收集

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>COLLECT(spatial)</code></td></tr><tr><td>定義</td><td>將參數欄位中的值組合在一起的彙總計算。會忽略 Null 值。</td></tr><tr><td>說明</td><td><code>COLLECT</code> 只能用於空間欄位。</td></tr></tbody></table>

### CONTAINS

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>CONTAINS(string, substring)</code></td></tr><tr><td>輸出</td><td>布林值</td></tr><tr><td>定義</td><td>如果給定 <code>&lt;string&gt;</code> 包含指定的 <code>&lt;substring&gt;</code>，則傳回 true。</td></tr><tr><td>範例</td><td><pre>CONTAINS("Calculation", "alcu") = true</pre></td></tr><tr><td>說明</td><td>另請參閱 <a href="https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_logical.htm" target="_blank">邏輯函數</a> <code>IN</code> 以及<a href="https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm" target="_blank">額外函數文件</a>中支援的正規表式。</td></tr></tbody></table>

### CORR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>CORR(expression1, expression2)</code></td></tr><tr><td>輸出</td><td>從 -1 到 1 的數字</td></tr><tr><td>定義</td><td>返回兩個運算式的皮爾森相關係數。</td></tr><tr><td>範例</td><td><pre>example</pre></td></tr><tr><td>說明</td><td><p>皮爾森相關係數衡量兩個變數之間的線性關係。結果範圍為 -1 至 +1（包括 -1 和 +1），其中 1 表示精確的正向線性關係，0 表示變異數之間沒有線性關係，而 −1 表示精確的反向關係。</p><p>CORR 結果的平方等於線性趨勢線模型的 R 平方值。請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/trendlines_add.htm#Terms" target="_blank">趨勢線模型術語</a>。</p><p><b>與表範圍 LOD 運算式一起使用：</b></p><p>您可以使用 CORR 來視覺化分解散點中的關聯性 <a href="https://help.tableau.com/current/pro/desktop/zh-tw/calculations_calculatedfields_lod.htm#Table" target="_blank">表範圍的詳細資料層級運算式</a>。例如：</p><pre>{CORR(Sales, Profit)}</pre><p>借助詳細層級運算式，關聯將在所有列上執行。如果您使用像 <code>CORR(Sales, Profit)</code>（不帶兩邊的方括號可使其成為詳細層級運算式）這樣的公式，檢視將顯示散點圖中每個單獨的點與其他每個點（未定義）的關聯。</p></td></tr><tr><td>資料庫限制</td><td><p><code>CORR</code> 適用於以下資料來源：Tableau 資料擷取、Cloudera Hive、EXASolution、Firebird（版本 3.0 及更高版本）、Google BigQuery、Hortonworks Hadoop Hive、IBM PDA (Netezza)、Oracle、PostgreSQL、Presto、SybaseIQ、Teradata、Vertica。</p><p>對於其他資料來源，請考慮擷取資料或使用 <code>WINDOW_CORR</code>。請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm" target="_blank">表計算函數</a>。</p></td></tr></tbody></table>

### COS

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>COS(number)</code><p>數字引數是以弧度表示的角度。</p></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>返回角度的余弦。</td></tr><tr><td>範例</td><td><pre>COS(PI( ) /4) = 0.707106781186548</pre></td></tr><tr><td>說明</td><td><p>反函數 <code><a href="#ACOS" class="xref">ACOS</a></code> 以餘弦作為引數，並傳回以弧度表示的角度。</p><p>另請參閱 <code><a href="#PI" class="xref">PI</a></code>。</p></td></tr></tbody></table>

### COT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>COT(number)</code><p>數字引數是以弧度表示的角度。</p></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>返回角度的餘切。</td></tr><tr><td>範例</td><td><pre>COT(PI( ) /4) = 1</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#ATAN" class="xref">ATAN</a></code>、<code><a href="#TAN" class="xref">TAN</a></code> 和 <code><a href="#PI" class="xref">PI</a></code>。</td></tr></tbody></table>

### COUNT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>COUNT(expression)</code></td></tr><tr><td>定義</td><td>傳回項目數量。不對 Null 值計數。</td></tr></tbody></table>

### COUNTD

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>COUNTD(expression)</code></td></tr><tr><td>定義</td><td>返回群組中不同項目的數量。不對 Null 值計數。</td></tr></tbody></table>

### COVAR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>COVAR(expression1, expression2)</code></td></tr><tr><td>定義</td><td>傳回兩個運算式的<i>樣本</i>共變異數。</td></tr><tr><td>說明</td><td><p>共變數對兩個變數的共同變化方式進行量化。正共變數指明兩個變數趨向于向同一方向移動，平均來說，即一個變數的較大值趨向於與另一個變數的較大值對應。<i>樣本共變異數</i>使用非空資料點的數量 n - 1 來規範化共變異數計算，而不是使用母體共變異數（可用於 <code>COVARP</code> 函數）所使用的 n。當資料是用於估算較大總體的共變數的隨機樣本時，則樣本共變數是合適的選取。</p><p>如果 <code>&lt;expression1&gt;</code> 和 <code>&lt;expression2&gt;</code> 相同 — 例如 <code>COVAR([profit], [profit])</code>，<code>COVAR</code> 將傳回一個值，指明值分佈的廣泛程度。</p><p><code>COVAR(X, X)</code> 的值等於 <code>VAR(X)</code> 的值，也等於 <code>STDEV(X)^2</code> 的值。</p></td></tr><tr><td>資料庫限制</td><td><p><code>COVAR</code> 適用於以下資料來源：Tableau 資料擷取、Cloudera Hive、EXASolution、Firebird（版本 3.0 及更高版本）、Google BigQuery、Hortonworks Hadoop Hive、IBM PDA (Netezza)、Oracle、PostgreSQL、Presto、SybaseIQ、Teradata、Vertica。</p><p>對於其他資料來源，請考慮擷取資料或使用 <code>WINDOW_COVAR</code>。請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm" target="_blank">表計算函數</a>。</p></td></tr></tbody></table>

### COVARP

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>COVARP(expression 1, expression2)</code></td></tr><tr><td>定義</td><td>傳回兩個運算式的<i>母體</i>共變異數。</td></tr><tr><td>說明</td><td><p>共變數對兩個變數的共同變化方式進行量化。正共變數指明兩個變數趨向于向同一方向移動，平均來說，即一個變數的較大值趨向於與另一個變數的較大值對應。<i>母體共變異數</i>為樣本共變異數乘以 (n-1)/n，其中 n 是非 null 資料點的總數。如果存在可用於所有相關項目的資料，則母體共變異數是合適的選取，與之相反，在只有隨機項目子集的情況下，樣本共變異數（及 <code>COVAR</code> 函數）較為適合。</p><p>如果 <code>&lt;expression1&gt;</code> 和 <code>&lt;expression2&gt;</code> 相同 — 例如 <code>COVARP([profit], [profit])</code>，<code>COVARP</code> 將傳回一個值，指明值分佈的廣泛程度。附註：<code>COVARP(X, X)</code> 附註：的值等於 <code>VARP(X)</code> 的值，也等於 <code>STDEVP(X)^2</code> 的值。</p></td></tr><tr><td>資料庫限制</td><td><p><code>COVARP</code> 適用於以下資料來源：Tableau 資料擷取、Cloudera Hive、EXASolution、Firebird（版本 3.0 及更高版本）、Google BigQuery、Hortonworks Hadoop Hive、IBM PDA (Netezza)、Oracle、PostgreSQL、Presto、SybaseIQ、Teradata、Verez</p><p>對於其他資料來源，請考慮擷取資料或使用 <code>WINDOW_COVAR</code>。請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm" target="_blank">表計算函數</a>。</p></td></tr></tbody></table>

[回到頁首](#top)

## D

### DATE

將字串和數字運算式轉換為日期的類型轉換函式，只要它們是可識別的格式。

<table class="table--plain"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>DATE(expression)</code></td></tr><tr><td>輸出</td><td>日期</td></tr><tr><td>定義</td><td>在指定數字、字串或日期 <code>&lt;expression&gt;</code> 的情況下傳回日期。</td></tr><tr><td>範例</td><td><pre>DATE([Employee Start Date])</pre><pre>DATE("September 22, 2018") </pre><pre>DATE("9/22/2018")</pre><pre>DATE(#2018-09-22 14:52#)</pre></td></tr><tr><td>說明</td><td><p>與 <code><a href="#DATEPARSE" class="xref">DATEPARSE</a></code> 不同，不需要提供模式，因為 <code>DATE</code> 會自動識別許多標準日期格式。但是，如果 <code>DATE</code> 無法識別輸入，請嘗試使用 <code>DATEPARSE</code> 並指定格式。</p><p><code><a href="#MAKEDATE" class="xref">MAKEDATE</a></code> 是另一個類似的函式，但 <code>MAKEDATE</code> 需要輸入年、月和日的數值。</p></td></tr></tbody></table>

### DATEADD

將指定數量的日期部分（月、日等）添加到開始日期。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>DATEADD(date_part, interval, date)</code></td></tr><tr><td>輸出</td><td>日期</td></tr><tr><td>定義</td><td>傳回指定日期，該日期的指定 &gt; <code>&lt;date_part</code> 中新增了指定的數字 <code>&lt;interval&gt;</code>。例如，將開始日期新增三個月或 12 天。</td></tr><tr><td>範例</td><td><p>將所有到期日期推遲一週</p><pre>DATEADD('week', 1, [due date])</pre><p>在 2021 年 2 月 20 日的基礎上增加 280 天</p><pre>DATEADD('day', 280, #2/20/21#) = #November 27, 2021#</pre></td></tr><tr><td>說明</td><td>支援 ISO 8601 日期。</td></tr></tbody></table>

### DATEDIFF

傳回兩個日期之間的日期部分數（週、年等）。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>DATEDIFF(date_part, date1, date2, [start_of_week])</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>返回 <code>date1</code> 與 <code>date2</code> 之差（以 <code>date_part</code> 的單位表示）。例如，減去某人進入和離開樂隊的日期，以查看他們留在樂隊中的時間。</td></tr><tr><td>範例</td><td><p>1986 年 3 月 25 日至 2021 年 2 月 20 日之間的天數</p><pre>DATEDIFF('day', #3/25/1986#, #2/20/2021#) = 12,751</pre><p>一個人在樂隊里呆了多少個月</p><pre>DATEDIFF('month', [date joined band], [date left band])</pre></td></tr><tr><td>說明</td><td>支援 ISO 8601 日期。</td></tr></tbody></table>

### DATENAME

將指定日期部分的名稱作為離散字串傳回。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>DATENAME(date_part, date, [start_of_week])</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>將日期的 <code>&lt;date_part&gt;</code> 作為字串傳回。</td></tr><tr><td>範例</td><td><pre>DATENAME('year', #3/25/1986#) = "1986"</pre><pre>DATENAME('month', #1986-03-25#) = "March"</pre></td></tr><tr><td>說明</td><td><p>支援 ISO 8601 日期。</p><p><a href="#DATEPART" class="xref">DATEPART</a> 是非常相似的計算，它將指定日期部分的值作為連續整數傳回。<code>DATEPART</code> 可以更快，因為它是數字運算。</p><p>透過變更計算結果的屬性（維度或度量、連續或離散）和日期格式，可以將 <code>DATEPART</code> 和 <code>DATENAME</code> 的結果格式設定為相同。</p><p><code><a href="#DATEPARSE" class="xref">DATEPARSE</a></code> 是反函數，它會接受字串值並將其格式化為日期。</p></td></tr></tbody></table>

### DATEPARSE

將特定格式的字串作為日期傳回。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>DATEPARSE(date_format, date_string)</code></td></tr><tr><td>輸出</td><td>日期</td></tr><tr><td>定義</td><td><code>&lt;date_format&gt;</code> 引數會描述 <code>&lt;date_string&gt;</code> 欄位的排列方式。由於字串欄位的排序方式可以多種多樣，因此 <code>&lt;date_format&gt;</code> 必須完全符合。有關完整詮釋，請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/data_dateparse.htm" target="_blank">將欄位轉換為日期欄位</a>。</td></tr><tr><td>範例</td><td><pre>DATEPARSE('yyyy-MM-dd', "1986-03-25") = #March 25, 1986#</pre></td></tr><tr><td>說明</td><td><p><code><a href="#DATE" class="xref">DATE</a></code> 是一個類似的函數，可以自動識別許多標準日期格式。如果 <code>DATE</code> 無法識別輸入模式，則 <code>DATEPARSE</code> 可能是更好的選擇。</p><p><code><a href="#MAKEDATE" class="xref">MAKEDATE</a></code> 是另一個類似的函式，但 <code>MAKEDATE</code> 需要輸入年、月和日的數值。</p><p>將日期分開並傳回其部分值的反函數是 <code><a href="#DATEPART" class="xref">DATEPART</a></code>（整數輸出）和 <code><a href="#DATENAME" class="xref">DATENAME</a></code>（字串輸出）。</p></td></tr><tr><td>資料庫限制</td><td><p><code>DATEPARSE</code> 可透過以下連接器獲得：非舊版 Excel 和文字檔連線、Amazon EMR Hadoop Hive、Cloudera Hadoop、Google 試算表、Hortonworks Hadoop Hive、MapR Hadoop Hive、MySQL、Oracle、PostgreSQL 以及 Tableau 資料擷取。有些格式可能並非適用於所有連線。</p><p>Hive 變體不支援 <code>DATEPARSE</code>。僅支援 Denodo、Drill 和 Snowflake。</p></td></tr></tbody></table>

### DATEPART

將指定日期部分的名稱作為整數傳回。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>DATEPART(date_part, date, [start_of_week])</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>將日期的 <code>&lt;date_part&gt;</code> 作為整数傳回。</td></tr><tr><td>範例</td><td><pre>DATEPART('year', #1986-03-25#) = 1986</pre><pre>DATEPART('month', #1986-03-25#) = 3</pre></td></tr><tr><td>說明</td><td><p>支援 ISO 8601 日期。</p><p><code><a href="#DATENAME" class="xref">DATENAME</a></code> 是非常相似的計算，它將指定日期部分的名稱作為離散字串傳回。<code>DATEPART</code> 可以更快，因為它是數字運算。透過變更欄位的屬性（維度或度量、連續或離散）和日期格式，可以將 <code>DATEPART</code> 和 <code>DATENAME</code> 的結果格式設定為相同。</p><p><code><a href="#DATEPARSE" class="xref">DATEPARSE</a></code> 是反函數，它會接受字串值並將其格式化為日期。</p></td></tr></tbody></table>

### DATETIME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>DATETIME(expression)</code></td></tr><tr><td>輸出</td><td>日期時間</td></tr><tr><td>定義</td><td>在給定數位、字串或日期運算式的情況下返回日期時間。</td></tr><tr><td>範例</td><td><pre>DATETIME("April 15, 2005 07:59:00") = April 15, 2005 07:59:00</pre></td></tr></tbody></table>

### DATETRUNC

這個函式可以被認為是日期四捨五入。它需要一個特定的日期並以所需的特異性傳回該日期的版本。因為每個日期都必須具有日、月、季度和年的值，所以 `DATETRUNC` 將值設定為每個日期部分的最小值，直到指定的日期部分。請參閱該範例了解更多資訊。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>DATETRUNC(date_part, date, [start_of_week])</code></td></tr><tr><td>輸出</td><td>日期</td></tr><tr><td>定義</td><td>按 <code>&lt;date_part&gt;</code> 指定的準確度截斷 <code>&lt;date&gt;</code>。此函式傳回新日期。例如，以月份層級截斷處於月份中間的日期時，此函式傳回當月的第一天。</td></tr><tr><td>範例</td><td><pre>DATETRUNC('day', #9/22/2018#) = #9/22/2018#</pre><pre>DATETRUNC('iso-week', #9/22/2018#) = #9/17/2018#</pre><p>（包含 2018 年 9 月 22 日的那一週中的星期一）</p><pre>DATETRUNC(quarter, #9/22/2018#) = #7/1/2018# </pre><p>（包含 9/22/2018 的那個季度的第一天）</p><p class="note">附註：如果是週和 ISO 週數，則使用 <code>start_of_week</code>。ISO 週數始終從星期一開始。對於此範例的地區設定，未指定 <code>start_of_week</code> 表示該週從星期日開始。</p></td></tr><tr><td>說明</td><td><p>支援 ISO 8601 日期。</p><p>您不該使用 <code>DATETRUNC</code> 來停止在視覺效果中顯示日期時間欄位的時間。如果要截斷日期的<i>顯示</i>而不是捨入其準確性，請<a href="https://help.tableau.com/current/pro/desktop/zh-tw/dates_custom_date_formats.htm" target="_blank">調整格式</a>。</p><p>例如，<code>DATETRUNC('day', #5/17/2022 3:12:48 PM#)</code> ，如果在視覺效果中格式化為顯示秒數，將顯示為 <code>5/17/2022 12:00:00 AM</code>。</p></td></tr></tbody></table>

### DAY

以整數的形式傳回月份的天 (1-31)。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>DAY(date)</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>以整數的形式傳回給定 <code>&lt;date&gt;</code> 的天。</td></tr><tr><td>範例</td><td><pre>Day(#September 22, 2018#) = 22</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#WEEK" class="xref">WEEK</a></code>、<code><a href="#MONTH" class="xref">MONTH</a></code>、<code><a href="#QUARTER" class="xref">Quarter</a></code>、<code><a href="#YEAR" class="xref">YEAR</a></code>，以及 ISO 等值</td></tr></tbody></table>

### DEGREES

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>DEGREES(number)</code><p>數字引數是以弧度表示的角度。</p></td></tr><tr><td>輸出</td><td>數字（度）</td></tr><tr><td>定義</td><td>將以弧度表示的角度轉換為度數。</td></tr><tr><td>範例</td><td><pre>DEGREES(PI( )/4) = 45.0</pre></td></tr><tr><td>說明</td><td><p>反函數 <code><a href="#RADIANS" class="xref">RADIANS</a></code> 取得以度表示的角度，並傳回以弧度表示的角度。</p><p>另請參閱 <code><a href="#PI" class="xref">PI</a>()</code>。</p></td></tr></tbody></table>

### DISTANCE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>DISTANCE(&lt;SpatialPoint1&gt;, &lt;SpatialPoint2&gt;, 'units')</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>傳回指定 <code>units</code> 中兩點之間的距離度量。</td></tr><tr><td>範例</td><td><pre>DISTANCE([Origin Point],[Destination Point], 'km')</pre></td></tr><tr><td>說明</td><td><p>支援的單位名稱（計算中必須用引號引起來）：</p><ul><li><i>公尺</i>：meters、metres、m</li><li><i>公里</i>：kilometers、kilometres、km</li><li><i>英里</i>：miles、mi</li><li><i>英尺</i>：feet、ft</li></ul></td></tr><tr><td>資料庫限制</td><td>此函數只能透過即時連線建立，但若資料來源轉換為擷取，則此函數將繼續工作。</td></tr></tbody></table>

### DIV

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>DIV(integer1, integer2)</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>傳回將 <code>&lt;integer1&gt;</code> 除以 <code>&lt;integer2&gt;</code> 的除法運算的整數部分。</td></tr><tr><td>範例</td><td><pre>DIV(11,2) = 5</pre></td></tr></tbody></table>

### DOMAIN

`DOMAIN(string_url)`

僅在連線到 Google BigQuery 時受支援。有關詳情，請參閱[其他函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm)。

[回到頁首](#top)

## E

### ELSE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>CASE &lt;expression&gt; 
							<br>WHEN &lt;value1&gt; THEN &lt;then1&gt; 
							<br>WHEN &lt;value2&gt; THEN &lt;then2&gt; 
							<br>...
						<br>[<b>ELSE</b> &lt;default&gt;]<br>END</code></td></tr><tr><td>定義</td><td><code>IF</code> 或 <code>CASE</code> 運算式的可選部分，用於指定在所有測試運算式均不為 TRUE 時傳回的預設值。</td></tr><tr><td>範例</td><td><pre>IF [Season] = "Summer"&nbsp;THEN&nbsp;'Sandals' <br>ELSEIF&nbsp;[Season] = "Winter"&nbsp;THEN&nbsp;'Boots' <br><b>ELSE</b>&nbsp;'Sneakers'&nbsp;<br>END</pre><pre>CASE [Season] <br>WHEN 'Summer' THEN 'Sandals' <br>WHEN 'Winter' THEN 'Boots' <br><b>ELSE</b> 'Sneakers' <br>END</pre></td></tr><tr><td>說明</td><td><p>與 <a href="#CASE" class="xref">CASE</a>、<a href="#WHEN" class="xref">WHEN</a>、<a href="#IF" class="xref">IF</a>、<a href="#ELSEIF" class="xref">ELSEIF</a>、<a href="#THEN" class="xref">you can rerun the query or view</a> 和 <a href="#END" class="xref">END</a> 一起使用</p><p><code>ELSE</code> 是 <code>CASE</code> 和 <code>IF</code> 的可選項。在未指定 <code>ELSE</code> 的計算中，若沒有一個 <code>&lt;test&gt;</code> 為 TRUE，則整個計算將傳回 NULL。</p><p><code>ELSE</code> 不需要條件（例如 <code>[Season] = "Winter"</code>），可以視為一種 NULL 處理形式。</p></td></tr></tbody></table>

### ELSEIF

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>[<b>ELSEIF</b> &lt;test2&gt; THEN &lt;then2&gt;]</code></td></tr><tr><td>定義</td><td><code>IF</code> 運算式的可選部分，用於指定初始 IF 以外的附加條件。</td></tr><tr><td>範例</td><td><pre>IF [Season] = "Summer" THEN 'Sandals' <br><b>ELSEIF</b> [Season] = "Winter" THEN 'Boots' <br><b>ELSEIF</b> [Season] = "Spring" THEN 'Sneakers' <br><b>ELSEIF</b> [Season] = "Autumn" THEN 'Sneakers'<br>ELSE 'Bare feet' <br>END</pre></td></tr><tr><td>說明</td><td><p>與 <a href="#IF" class="xref">IF</a>、<a href="#THEN" class="xref">you can rerun the query or view</a>、<a href="#ELSE" class="xref">ELSE</a> 和 <a href="#END" class="xref">END</a> 一起使用</p><p><code>ELSEIF</code> 可以被認為是額外的 <code>IF</code> 子句。<code>ELSEIF</code> 為可選項，並且可以重複多次。</p><p>與 <code>ELSE</code> 不同，<code>ELSEIF</code> 需要一個條件（例如 <code>[Season] = "Winter"</code>）。</p></td></tr></tbody></table>

### END

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>定義</td><td>用於關閉 <code>IF</code> 或 <code>CASE</code> 運算式。</td></tr><tr><td>範例</td><td><pre xml:space="preserve">IF [Season] = "Summer"&nbsp;THEN&nbsp;'Sandals' <br>ELSEIF&nbsp;[Season] = "Winter"&nbsp;THEN&nbsp;'Boots' <br>ELSE&nbsp;'Sneakers'&nbsp;<br><b>END</b></pre><p><i>「若 Season = Summer [季節 = 夏季]，則傳回 Sandals [涼鞋]。如果不是，請看下一個運算式。若 Season = Winter [季節 = 冬季]，則傳回 Boots [靴子]。若兩個運算式均不為 TRUE，則傳回 Sneakers [運動鞋]。」</i></p><pre>CASE [Season] <br>WHEN 'Summer' THEN 'Sandals' <br>WHEN 'Winter' THEN 'Boots' <br>ELSE 'Sneakers' <br><b>END</b></pre><p><i>「讓我們來看看 Season [季節] 欄位。若值為 Summer [夏季]，則傳回 Sandals [涼鞋]。若值為 Winter [冬季]，則傳回 Boots [靴子]。若計算中的選項均不符合 Season [季節] 欄位中的選項，則傳回 Sneakers [運動鞋]。」</i></p></td></tr><tr><td>說明</td><td><p>與 <a href="#CASE" class="xref">CASE</a>、<a href="#WHEN" class="xref">WHEN</a>、<a href="#IF" class="xref">IF</a>、<a href="#ELSEIF" class="xref">ELSEIF</a>、<a href="#THEN" class="xref">you can rerun the query or view</a> 和 <a href="#ELSE" class="xref">ELSE</a> 一起使用。</p></td></tr></tbody></table>

### ENDSWITH

### ENDSWITH

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ENDSWITH(string, substring)</code></td></tr><tr><td>輸出</td><td>布林值</td></tr><tr><td>定義</td><td>如果給定 <code>&lt;string&gt;</code> 以指定 <code>&lt;substring&gt;</code> 結尾，則傳回 true。會忽略尾隨空格。</td></tr><tr><td>範例</td><td><pre>ENDSWITH("Tableau", "leau") = true</pre></td></tr><tr><td>說明</td><td>另請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm" target="_blank">額外函數文件</a>中支援的正規表式。</td></tr></tbody></table>

### EXCLUDE

有關詳情，請參閱[詳細層級運算式](https://help.tableau.com/current/pro/desktop/zh-tw/calculations_calculatedfields_lod.htm)。

### EXP

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>EXP(number)</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>傳回 e 的給定 <code>&lt;number&gt;</code> 次方。</td></tr><tr><td>範例</td><td><pre>EXP(2) = 7.389<br>EXP(-[Growth Rate]*[Time])</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#LN" class="xref">LN</a></code>。</td></tr></tbody></table>

[回到頁首](#top)

## F

### FIND

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>FIND(string, substring, [start])</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td><p>傳回 <code>&lt;substring&gt;</code> 在 <code>&lt;string&gt;</code> 中的索引位置，如果未找到子字串，則傳回 0。字串中第一個字元的位置為 1。</p><p>如果新增了可選引數 <code>start</code>，則函數會忽略在開始位置之前出現的任何子字串執行個體。</p></td></tr><tr><td>範例</td><td><pre>FIND("Calculation", "alcu") = 2</pre><pre>FIND("Calculation", "Computer") = 0</pre><pre>FIND("Ca<b>l</b>culation", "a", <b>3</b>) = 7</pre><pre>FIND("C<b>a</b>lculation", "a", <b>2</b>) = 2</pre><pre>FIND("Calcula<b>t</b>ion", "a", <b>8</b>) = 0</pre></td></tr><tr><td>說明</td><td>另請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm" target="_blank">額外函數文件</a>中支援的正規表式。</td></tr></tbody></table>

### FINDNTH

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>FINDNTH(string, substring, occurrence)</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>傳回指定 <code>&lt;string&gt;</code> 內的第 n 個 <code>&lt;substring&gt;</code> 的位置，其中 n 由 <code>&lt;occurence&gt;</code> 引數定義。</td></tr><tr><td>範例</td><td><pre>FINDNTH("Calculation", "a", 2) = 7</pre></td></tr><tr><td>說明</td><td><p><code>FINDNTH</code> 對於所有資料來源都不可用。</p><p>另請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm" target="_blank">額外函數文件</a>中支援的正規表式。</p></td></tr></tbody></table>

### FIRST

`FIRST()`

有關詳情，請參閱[Tableau 計算函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm)。

### FIXED

有關詳情，請參閱[詳細層級運算式](https://help.tableau.com/current/pro/desktop/zh-tw/calculations_calculatedfields_lod.htm)。

### 浮點數

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>FLOAT(expression)</code></td></tr><tr><td>輸出</td><td>浮點數（十進位）</td></tr><tr><td>定義</td><td>將其參數轉換為浮點數。</td></tr><tr><td>範例</td><td><pre>FLOAT(3) = 3.000</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#INT" class="xref">INT</a></code>，其傳回整數。</td></tr></tbody></table>

### FLOOR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>FLOOR(number)</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>將 <code>&lt;number&gt;</code> 舍入為值相等或更小的最近整數。</td></tr><tr><td>範例</td><td><pre>FLOOR(7.9) = 7</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#CEILING" class="xref">CEILING</a></code> 和 <code><a href="#ROUND" class="xref">ROUND</a></code>。</td></tr><tr><td>資料庫限制</td><td><p><code>FLOOR</code> 可透過以下連接器使用：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。</p></td></tr></tbody></table>

### FULLNAME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>FULLNAME( )</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td><p>返回目前使用者的全名。</p></td></tr><tr><td>範例</td><td><pre>FULLNAME( )</pre><p>這樣會傳回已登入的使用者的全名，例如「Hamlin Myrer」。</p><pre>[Manager] = FULLNAME( )</pre><p>如果經理「Hamlin Myrer」已登入，則僅檢視中的「經理」欄位包含「Hamlin Myrer」時，此範例才會傳回 TRUE。</p></td></tr><tr><td>說明</td><td><p>此函數會檢查：</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 和 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>：已登入的使用者的全名</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>：使用者的本機或網路全名</li></ul><p><b>使用者篩選器</b></p><p>用作篩選器時，如 <code>[Username field] = FULLNAME( )</code> 這樣的計算欄位可用於建立使用者篩選器，該篩選器僅顯示與登入到伺服器的人員相關的資料。</p></td></tr></tbody></table>

[回到頁首](#top)

## G

### GET\_JSON\_OBJECT

`GET_JSON_OBJECT(JSON string, JSON path)`

僅在連線到 Hadoop Hive 時才受支援。有關詳情，請參閱[其他函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm)。

### GROUP\_CONCAT

`GROUP_CONCAT(expression)`

僅在連線到 Google BigQuery 時受支援。有關詳情，請參閱[其他函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm)。

[回到頁首](#top)

## H

### HEXBINX

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>HEXBINX(number, number)</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>將 x、y 座標對應到最接近的六邊形資料桶的 x 座標。資料桶的邊長為 1，因此，可能需要相應地縮放輸入。</td></tr><tr><td>範例</td><td><pre>HEXBINX([Longitude]*2.5, [Latitude]*2.5)</pre></td></tr><tr><td>說明</td><td><code>HEXBINX </code> 和 <code><a href="#HEXBINY" class="xref">HEXBINY</a></code> 是用於六邊形資料桶的分桶和標繪函數。六邊形資料桶是對 x/y 平面（例如地圖）中的資料進行視覺化的有效而簡潔的選項。由於資料桶是六邊形的，因此每個資料桶都非常近似於一個圓，並最大程度地減少了從資料點到資料桶中心的距離變化。這使得聚類分析更加準確並且能提供有用的資訊。</td></tr></tbody></table>

### HEXBINY

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>HEXBINY(number, number)</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>將 x、y 座標對應到最接近的六邊形資料桶的 y 座標。資料桶的邊長為 1，因此，可能需要相應地縮放輸入。</td></tr><tr><td>範例</td><td><pre>HEXBINY([Longitude]*2.5, [Latitude]*2.5)</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#HEXBINX" class="xref">HEXBINX</a></code>。</td></tr></tbody></table>

### HOST

`HOST(string_url)`

僅在連線到 Google BigQuery 時受支援。有關詳情，請參閱[其他函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm)。

[回到頁首](#top)

## I

### IF

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code><b>IF</b> &lt;test1&gt; THEN &lt;then1&gt; <br>[ELSEIF &lt;test2&gt; THEN &lt;then2&gt;...]<br>[ELSE &lt;default&gt;] <br>END</code></td></tr><tr><td>輸出</td><td>取決於 <code>&lt;then&gt;</code> 值的資料類型。</td></tr><tr><td>定義</td><td><p>測試一系列運算式，同時為第一個為 true 的 <code>&lt;test&gt;</code> 傳回 <code>&lt;then&gt;</code> 值。</p></td></tr><tr><td>範例</td><td><pre>IF [Season] = "Summer"&nbsp;THEN&nbsp;'Sandals' <br>ELSEIF&nbsp;[Season] = "Winter"&nbsp;THEN&nbsp;'Boots' <br>ELSE&nbsp;'Sneakers'&nbsp;<br><b>END</b></pre><p><i>「若 Season = Summer [季節 = 夏季]，則傳回 Sandals [涼鞋]。如果不是，請看下一個運算式。若 Season = Winter [季節 = 冬季]，則傳回 Boots [靴子]。若兩個運算式均不為 TRUE，則傳回 Sneakers [運動鞋]。」</i></p></td></tr><tr><td>說明</td><td><p>另請參閱 <a href="#IF" class="xref">IF</a> 和 <a href="#IIF" class="xref">IIF</a>。</p><p>與 <a href="#ELSEIF" class="xref">ELSEIF</a>、<a href="#THEN" class="xref">you can rerun the query or view</a>、<a href="#ELSE" class="xref">ELSE</a> 和 <a href="#END" class="xref">END</a> 一起使用</p></td></tr></tbody></table>

### IFNULL

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>IFNULL(expr1, expr2)</code></td></tr><tr><td>輸出</td><td>取決於 <code>&lt;expr&gt;</code> 值的資料類型。</td></tr><tr><td>定義</td><td><p>若 <code>&lt;expr1&gt;</code> 不為 NULL，則傳回該運算式，否則傳回 <code>&lt;expr2&gt;</code>。</p></td></tr><tr><td>範例</td><td><pre>IFNULL([Assigned Room], "TBD")</pre><p><i>「如果『指派的房間』欄位不是 Null，傳回其值。如果『指派的房間』欄位為 Null，則傳回 TBD。」</i></p></td></tr><tr><td>說明</td><td><p>與 <a href="#ISNULL" class="xref">ISNULL</a> 進行比較。<code>IFNULL</code> 會始終傳回一個值。<code>ISNULL</code>&nbsp; &lt;x&gt; 會傳回一個布林值（TRUE 或 FALSE）。</p><p>另請參閱 <a href="#ZN" class="xref">ZN</a>。</p></td></tr></tbody></table>

### IIF

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code><b>IIF</b>(&lt;test&gt;, &lt;then&gt;, &lt;else&gt;, [&lt;unknown&gt;])</code></td></tr><tr><td>輸出</td><td>取決於運算式中值的資料類型。</td></tr><tr><td>定義</td><td>檢查是否符合條件 (<code>&lt;test&gt;</code>)，若測試為 TRUE，則傳回 <code>&lt;then&gt;</code>；若測試為 FALSE，則傳回 <code>&lt;else&gt;</code>；若測試為 NULL，則傳回 <code>&lt;unknown&gt;</code> 的可選值。若未指定可選的 unknown，則 <code>IIF</code> 傳回 NULL。</td></tr><tr><td>範例</td><td><pre>IIF([Season] = 'Summer', 'Sandals', 'Other footwear')</pre><p><i>「若 Season = Summer [季節 = 夏季]，則傳回 Sandals [涼鞋]。若不是，傳回其他鞋類」</i></p><pre>IIF([Season] = 'Summer', 'Sandals', <br>   IIF('Season' = 'Winter', 'Boots',  'Other footwear')<br>)</pre><p><i>「若 Season = Summer [季節 = 夏季]，則傳回 Sandals [涼鞋]。如果不是，請看下一個運算式。若 Season = Winter [季節 = 冬季]，則傳回 Boots [靴子]。若兩者均不為 TRUE，則傳回『運動鞋』。」</i></p><pre>IIF('Season' = 'Summer', 'Sandals', <br>   IIF('Season' = 'Winter', 'Boots',  <br>      IIF('Season' = 'Spring', 'Sneakers', 'Other footwear')<br>   )<br>)</pre><p><i>「若 Season = Summer [季節 = 夏季]，則傳回 Sandals [涼鞋]。如果不是，請看下一個運算式。若 Season = Winter [季節 = 冬季]，則傳回 Boots [靴子]。若兩個運算式均不為 TRUE，則傳回 Sneakers [運動鞋]。」</i></p></td></tr><tr><td>說明</td><td><p>另請參閱 <a href="#IF" class="xref">IF</a> 和 <a href="#CASE" class="xref">CASE</a>。</p><p><code>IIF</code> 沒有與 <code>ELSEIF</code> 等效的項（如 <code>IF</code>）或重複的 <code>WHEN</code> 子句（如 <code>CASE</code>）。相反，可以透過將 <code>IIF</code> 陳述式巢套為 <code>&lt;unknown&gt;</code> 元素來按順序計算多個測試。系統會傳回第一個（最外面的）TRUE。</p><p>也就是說，在下面的計算中，結果將為 Red [紅色]，而不是 Orange [橙色]，因為一旦 A=A 計算為 TRUE，運算式就會停止計算：</p><p><code>IIF('A' = 'A', 'Red', IIF('B' = 'B', 'Orange',  IIF('C' = 'D', 'Yellow', 'Green')))</code></p></td></tr></tbody></table>

### IN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>&lt;expr1&gt; IN &lt;expr2&gt;</code></td></tr><tr><td>輸出</td><td>布林值（TRUE 或 FALSE）</td></tr><tr><td>定義</td><td>若 <code>&lt;expr1&gt;</code> 中的任何值與 <code>&lt;expr2&gt;</code> 中的任何值相符，則傳回 <code>TRUE</code>。</td></tr><tr><td>範例</td><td><pre>SUM([Cost]) IN&nbsp;(1000, 15, 200)</pre><p><i>「『成本』欄位的值是 1000、15 還是 200？」</i></p><pre>[Field] IN&nbsp;[Set]</pre><p><i>「該欄位的值是否存在於集合中？」</i></p></td></tr><tr><td>說明</td><td><p><code>&lt;expr2&gt;</code> 中的值可以為固定的常值清單或合併欄位。</p><p>另請參閱 <a href="#WHEN" class="xref">WHEN</a>。</p></td></tr></tbody></table>

### INCLUDE

有關詳情，請參閱[詳細層級運算式](https://help.tableau.com/current/pro/desktop/zh-tw/calculations_calculatedfields_lod.htm)。

### INDEX

`INDEX( )`

有關詳情，請參閱[Tableau 計算函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm)。

### INT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>INT(expression)</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>將其參數轉換為整數。對於運算式，此函數將結果截斷為最接近於 0 的整數。</td></tr><tr><td>範例</td><td><pre>INT(8/3) = 2</pre><pre>INT(-9.7) = -9</pre></td></tr><tr><td>說明</td><td><p>字串轉換為整數時會先轉換為浮點數，然後舍入。</p><p>另請參閱 <code><a href="#FLOAT" class="xref">浮點數</a></code>，其傳回小數。<br>另請參閱 <a href="#ROUND" class="xref">ROUND</a>、<a href="#CEILING" class="xref">CEILING</a> 和 <a href="#FLOOR" class="xref">FLOOR</a></p></td></tr></tbody></table>

### INTERSECTS

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>INTERSECTS (&lt;geometry1&gt;, &lt;geometry2&gt;)</code></td></tr><tr><td>輸出</td><td>布林值</td></tr><tr><td>定義</td><td>傳回 TRUE 或 FALSE，指示兩個幾何圖形在空間中是否重疊。</td></tr><tr><td>說明</td><td>支援的組合：點/多邊形、線/多邊形和多邊形/多邊形。</td></tr></tbody></table>

### ISDATE

檢查字串是否是有效的日期格式。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ISDATE(string)</code></td></tr><tr><td>輸出</td><td>布林值</td></tr><tr><td>定義</td><td>如果給定 <code>&lt;string&gt;</code> 為有效日期，則傳回 true。</td></tr><tr><td>範例</td><td><pre>ISDATE(09/22/2018) = true</pre><pre>ISDATE(22SEP18) = false</pre></td></tr><tr><td>說明</td><td>必需的參數必須是字串。ISDATE 不能用於具有日期資料類型的欄位 - 計算將傳回錯誤。</td></tr></tbody></table>

### ISFULLNAME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ISFULLNAME("User Full Name")</code></td></tr><tr><td>輸出</td><td>布林值</td></tr><tr><td>定義</td><td><p>如果目前使用者的全名與指定的全名相符，傳回 <code>TRUE</code>；如果不相符，則傳回 <code>FALSE</code>。</p></td></tr><tr><td>範例</td><td><pre>ISFULLNAME("Hamlin Myrer")</pre></td></tr><tr><td>說明</td><td><p><code>&lt;"User Full Name"&gt;</code> 引數必須為文字字串，而不是欄位。</p><p>此函數會檢查：</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 和 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>：已登入的使用者的全名</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>：使用者的本機或網路全名</li></ul></td></tr></tbody></table>

### ISMEMBEROF

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ISMEMBEROF("Group Name")</code></td></tr><tr><td>輸出</td><td>布林值或 Null</td></tr><tr><td>定義</td><td><p>若目前使用 Tableau 的人員是與指定字串相符的群組的成員，則傳回 <code>TRUE</code>；若不是成員，則傳回 <code>FALSE</code>；若未登入，則傳回 <code>NULL</code>。</p></td></tr><tr><td>範例</td><td><pre>ISMEMBEROF('Superstars')</pre><pre>ISMEMBEROF('domain.lan\Sales')</pre></td></tr><tr><td>說明</td><td><p><code>&lt;"Group Full Name"&gt;</code> 引數必須為文字字串，而不是欄位。</p><p>如果使用者已登入 <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 或者 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>，群組成員資格由 Tableau 群組決定。若指定字串是「All Users」，則函數將傳回 TRUE</p><p><code>ISMEMBEROF( )</code> 函數也接受 Active Directory 網域。必須使用群組名稱在計算中宣告 Active Directory 網域。</p></td></tr></tbody></table>

### ISNULL

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ISNULL(expression)</code></td></tr><tr><td>輸出</td><td>布林值 (True 或 False)</td></tr><tr><td>定義</td><td><p>若 <code>&lt;expression&gt;</code> 為 NULL（不包含有效資料），則傳回 TRUE。</p></td></tr><tr><td>範例</td><td><pre>ISNULL([Assigned Room])</pre><p><i>「『指派的房間』欄位是否為 Null？」</i></p></td></tr><tr><td>說明</td><td><p>與 <a href="#IFNULL" class="xref">IFNULL</a> 進行比較。<code>IFNULL</code> 會始終傳回一個值。<code>ISNULL</code> 傳回布林值。</p><p>另請參閱 <a href="#ZN" class="xref">ZN</a>。</p></td></tr></tbody></table>

### ISOQUARTER

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ISOQUARTER(date)</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>以整數形式傳回給定 <code>&lt;date&gt;</code> 基於 ISO8601 週的季度。</td></tr><tr><td>範例</td><td><pre>ISOQUARTER(#1986-03-25#) = 1</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#ISOWEEK" class="xref">ISOWEEK</a></code>、<code><a href="#ISOWEEKDAY" class="xref">ISOWEEKDAY</a></code>、<code><a href="#ISOYEAR" class="xref">ISOYEAR</a></code>，以及非 ISO 等值。</td></tr></tbody></table>

### ISOWEEK

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ISOWEEK(date)</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>以整數形式傳回給定 <code>&lt;date&gt;</code> 基於 ISO8601 週的週。</td></tr><tr><td>範例</td><td><pre>ISOWEEK(#1986-03-25#) = 13</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#ISOWEEKDAY" class="xref">ISOWEEKDAY</a></code>、<code><a href="#ISOQUARTER" class="xref">ISOQUARTER</a></code>、<code><a href="#ISOYEAR" class="xref">ISOYEAR</a></code>，以及非 ISO 等值。</td></tr></tbody></table>

### ISOWEEKDAY

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ISOWEEKDAY(date)</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>以整數形式傳回給定 <code>&lt;date&gt;</code> 基於 ISO8601 週的平日。</td></tr><tr><td>範例</td><td><pre>ISOWEEKDAY(#1986-03-25#) = 2</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#ISOWEEK" class="xref">ISOWEEK</a></code>、<code><a href="#ISOQUARTER" class="xref">ISOQUARTER</a></code>、<code><a href="#ISOYEAR" class="xref">ISOYEAR</a></code>，以及 非 ISO 等值</td></tr></tbody></table>

### ISOYEAR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ISOYEAR(date)</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>以整數形式傳回指定日期基於 ISO8601 週的年份。</td></tr><tr><td>範例</td><td><pre>ISOYEAR(#1986-03-25#) = 1,986</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#ISOWEEK" class="xref">ISOWEEK</a></code>、<code><a href="#ISOWEEKDAY" class="xref">ISOWEEKDAY</a></code>、<code><a href="#ISOQUARTER" class="xref">ISOQUARTER</a></code>，以及非 ISO 等值。</td></tr></tbody></table>

### ISUSERNAME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ISUSERNAME("username")</code></td></tr><tr><td>輸出</td><td>布林值</td></tr><tr><td>定義</td><td>如果目前使用者的使用者名稱與指定的 <code>&lt;username&gt;</code> 相符，則傳回 <code>TRUE</code>；如果不相符，則傳回 <code>FALSE</code>。</td></tr><tr><td>範例</td><td><pre>ISUSERNAME("hmyrer")</pre></td></tr><tr><td>說明</td><td><p><code>&lt;"username"&gt;</code> 引數必須為文字字串，而不是欄位。</p><p>此函數會檢查：</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 和 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>：已登入的使用者的使用者名稱</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>：使用者的本機或網路使用者名稱</li></ul></td></tr></tbody></table>

[回到頁首](#top)

## J

[回到頁首](#top)

## K

[回到頁首](#top)

## L

### LAST

`LAST()`

有關詳情，請參閱[Tableau 計算函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm)。

### LEFT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>	LEFT(string, number)</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>傳回字串最左側 <code>&lt;number&gt;</code> 的字元。</td></tr><tr><td>範例</td><td><pre>LEFT("Matador", 4) = "Mata"</pre></td></tr><tr><td>說明</td><td>另請參閱 <a href="#MID" class="xref">MID</a> 和 <a href="#RIGHT" class="xref">RIGHT</a>。</td></tr></tbody></table>

### LEN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>LEN(string)</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>傳回 <code>&lt;string&gt;</code> 的長度。</td></tr><tr><td>範例</td><td><pre>LEN("Matador") = 7</pre></td></tr><tr><td>說明</td><td>不要與空間函數 <code><a href="#LENGTH" class="xref">LENGTH</a></code> 混淆。</td></tr></tbody></table>

### LENGTH

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>LENGTH(geometry, 'units')</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>使用指定的 <code>&lt;units&gt;</code> 傳回 <code>&lt;geometry&gt;</code> 中的一個或多個線串的大地測量路徑長度。</td></tr><tr><td>範例</td><td><pre>LENGTH([Spatial], 'metres')</pre></td></tr><tr><td>說明</td><td><p>若幾何圖形引數沒有線串，則結果為 <code>&lt;NaN&gt;</code>，但允許使用其他元素。</p><p>不要與字串函數 <code><a href="#LEN" class="xref">LEN</a></code> 混淆。</p></td></tr></tbody></table>

### LN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>LN(number)</code></td></tr><tr><td>輸出</td><td><p>數字</p><p>若引數小於或等於 0，則輸出為 <code>Null</code>。</p></td></tr><tr><td>定義</td><td>傳回 <code>&lt;number&gt;</code> 的自然對數。</td></tr><tr><td>範例</td><td><pre>LN(50) = 3.912023005</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#EXP" class="xref">EXP</a></code> 和 <code><a href="#LOG" class="xref">LOG</a></code>。</td></tr></tbody></table>

### LOG

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>LOG(number, [base])</code><p>若可選的底數引數不存在，則使用底數 10。</p></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>傳回以給定 <code>&lt;base&gt;</code> 為底的 <code>&lt;number&gt;</code> 對數。</td></tr><tr><td>範例</td><td><pre xml:space="preserve">LOG(16,4) = 2</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#POWER" class="xref">POWER</a></code> <code><a href="#LN" class="xref">LN</a></code>。</td></tr></tbody></table>

### LOG2

`LOG2(number)`

僅在連線到 Google BigQuery 時受支援。有關詳情，請參閱[其他函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm)。

### LOOKUP

`LOOKUP(expression, [offest])`

有關詳情，請參閱[Tableau 計算函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm)。

### LOWER

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>LOWER(string)</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>傳回提供的 <code>&lt;string&gt;</code>，且全為小寫字元。</td></tr><tr><td>範例</td><td><pre>LOWER("ProductVersion") = "productversion"</pre></td></tr><tr><td>說明</td><td>另請參閱 <a href="#UPPER" class="xref">UPPER</a> 和 <a href="#PROPER" class="xref">PROPER</a>。</td></tr></tbody></table>

### LTRIM

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>	LTRIM(string)</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>傳回移除所有前導空格的 <code>&lt;string&gt;</code>。</td></tr><tr><td>範例</td><td><pre>LTRIM(" Matador ") = "Matador "</pre></td></tr><tr><td>說明</td><td>另請參閱 <a href="#RTRIM" class="xref">RTRIM</a>。</td></tr></tbody></table>

### LTRIM\_THIS

`LTRIM_THIS(string, string)`

僅在連線到 Google BigQuery 時受支援。有關詳情，請參閱[其他函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm)。

[回到頁首](#top)

## M

### MAKEDATE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>MAKEDATE(year, month, day)</code></td></tr><tr><td>輸出</td><td>日期</td></tr><tr><td>定義</td><td>傳回一個依據指定 <code>&lt;year&gt;</code>、<code>&lt;month&gt;</code> 和 <code>&lt;day&gt;</code> 構造的日期值。</td></tr><tr><td>範例</td><td><pre>MAKEDATE(1986,3,25) = #1986-03-25#</pre></td></tr><tr><td>說明</td><td><p class="note"><b>請注意</b>：輸入錯誤的值會被調整成日期，例如 <code>MAKEDATE(2020,4,31) = May 1, 2020</code>，而不是傳回沒有 4 月 31 日的錯誤。</p><p>可用於 Tableau 擷取。檢查在其他資料來源中的可用性。</p><p><code>MAKEDATE</code> 需要日期部分的數字輸入。如果您的資料是一個應該是日期的字串，請嘗試使用 <code><a href="#DATE" class="xref">DATE</a></code> 函數。<code>DATE</code> 自動識別許多標準日期格式。如果 <code>DATE</code> 無法識別輸入，請嘗試使用 <code><a href="#DATEPARSE" class="xref">DATEPARSE</a></code>。</p></td></tr></tbody></table>

### MAKEDATETIME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>MAKEDATETIME(date, time)</code></td></tr><tr><td>輸出</td><td>日期時間</td></tr><tr><td>定義</td><td>傳回合併 <code>&lt;date&gt;</code> 和 <code>&lt;time&gt;</code> 的日期時間。日期可以是 date、datetime 或 string 類型。時間必須是 datetime。</td></tr><tr><td>範例</td><td><pre>MAKEDATETIME("1899-12-30", #07:59:00#) = #12/30/1899 7:59:00 AM#</pre><pre>MAKEDATETIME([Date], [Time]) = #1/1/2001 6:00:00 AM#</pre></td></tr><tr><td>說明</td><td><p>附注：此功能僅適用於與 MySQL 相容的連線（對於 Tableau 為 MySQL 和 Amazon Aurora）。</p><p><code><a href="#MAKETIME" class="xref">MAKETIME</a></code> 為可用於 Tableau 資料擷取和其他一些資料來源的類似函數。</p></td></tr></tbody></table>

### MAKELINE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>MAKELINE(SpatialPoint1, SpatialPoint2)</code></td></tr><tr><td>輸出</td><td>幾何圖形（線）</td></tr><tr><td>定義</td><td>在兩點之間產生線標記</td></tr><tr><td>範例</td><td><pre>MAKELINE(MAKEPOINT(47.59, -122.32), MAKEPOINT(48.5, -123.1))</pre></td></tr><tr><td>說明</td><td>對於建立出發地-目的地地圖很有用。</td></tr></tbody></table>

### MAKEPOINT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>MAKEPOINT(latitude, longitude, [SRID])</code></td></tr><tr><td>輸出</td><td>幾何圖形（點）</td></tr><tr><td>定義</td><td><p>將 <code>&lt;latitude&gt;</code> 和 <code>&lt;longitude&gt;</code> 欄的資料轉換為空間物件。</p><p>若新增可選的 <code>&lt;SRID&gt;</code> 引數，則輸入可以是其他投影地理座標。</p></td></tr><tr><td>範例</td><td><pre>MAKEPOINT(48.5, -123.1)</pre><pre>MAKEPOINT([AirportLatitude], [AirportLongitude])</pre><pre>MAKEPOINT([Xcoord],[Ycoord], 3493)</pre></td></tr><tr><td>說明</td><td><p><code>MAKEPOINT</code> 無法使用自動產生的緯度和經度欄位。資料來源必須以原生方式包含座標。</p><p>SRID 是一種空間參照識別碼，其使用 <a href="https://epsg.io/" target="_blank">ESPG 參考系統碼</a>以指定座標系統。如未指定 SRID，則會假設為 WGS84，而參數則會以緯度/經度（以度數為單位）來處理。</p><p>可以使用 <code>MAKEPOINT</code> 在空間上啟用資料來源，以便可以使用空間聯結將其與空間檔案聯結。有關詳情，請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/maps_spatial_join.htm" target="_blank">在 Tableau 中聯結空間檔案</a>。</p></td></tr></tbody></table>

### MAKETIME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>MAKETIME(hour, minute, second)</code></td></tr><tr><td>輸出</td><td>日期時間</td></tr><tr><td>定義</td><td>傳回一個依據指定 <code>&lt;hour&gt;</code>、<code>&lt;minute&gt;</code> 和 <code>&lt;second&gt;</code> 構造的日期值。</td></tr><tr><td>範例</td><td><pre>MAKETIME(14, 52, 40) = #1/1/1899 14:52:40#</pre></td></tr><tr><td>說明</td><td><p>由於 Tableau 不支援時間資料類型，僅支援日期時間，因此輸出為日期時間。該欄位的日期部分將是 1/1/1899。</p><p>與 <code><a href="#MAKEDATETIME" class="xref">MAKEDATETIME</a></code> 類似的函數，僅適用於 MYSQL 相容的連線。</p></td></tr></tbody></table>

### MAX

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>MAX(expression)</code> 或 <code>MAX(expr1, expr2)</code></td></tr><tr><td>輸出</td><td>與引數相同的資料類型，若引數的任何部分為 NULL，則為 <code>NULL&nbsp;</code>。</td></tr><tr><td>定義</td><td><p>傳回兩個引數（必須為相同資料類型）中的較大值。</p><p><code>MAX</code> 也可以作為彙總套用於單一欄位。</p></td></tr><tr><td>範例</td><td><pre>MAX(4,7) = 7<br>MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021# <br>MAX([Name]) = "Zander"</pre></td></tr><tr><td>說明</td><td><p><b>對於字串</b></p><p><code>MAX</code> 通常是按字母順序排在最後的值。</p><p class="note">對於資料庫資料來源，<code>MAX</code> 字串值是資料庫為欄定義的排序順序中的最高值。</p><p><b>對於日期</b></p><p>對於日期，<code>MAX</code> 是最近的日期。如果 <code>MAX</code> 是彙總，結果不會有日期階層。如果 <code>MAX</code> 是比較，結果將保留日期階層。</p><p><b>作為彙總</b></p><p><code>MAX(expression)</code> 為彙總函數，會傳回單一彙總結果。這在視覺效果中顯示為 <code>AGG(expression)</code>。</p><p><b>作為比較</b></p><p><code>MAX(expr1, expr2)</code> 會比較兩個值，並傳回一個列層級值。</p><p>另請參閱 <code><a href="#MIN" class="xref">MIN</a></code>。</p></td></tr></tbody></table>

### MEDIAN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>MEDIAN(expression)</code></td></tr><tr><td>定義</td><td>返回運算式在所有記錄中的中位數。會忽略 Null 值。</td></tr><tr><td>說明</td><td><code>MEDIAN</code> 只能用於數字欄位。</td></tr><tr><td>資料庫限制</td><td><p><code>MEDIAN</code> <b>不</b>適用於下列資料來源：Access、Amazon Redshift、Cloudera Hadoop、HP Vertica、IBM DB2、IBM PDA (Netezza)、Microsoft SQL Server、MySQL、SAP HANA、Teradata。</p><p>對於其他資料來源類型，可以將資料擷取到擷取檔案以使用此函數。請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/extracting_data.htm" target="_blank">擷取您的資料</a>。</p></td></tr></tbody></table>

### MID

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>(MID(string, start, [length])</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td><p>傳回從指定的 <code>&lt;start&gt;</code> 位置開始的字串。字串中第一個字元的位置為 1。</p><p>如果新增了可選數字參數 <code>&lt;length&gt;</code>，則傳回的字串僅包含該數字的字元。</p></td></tr><tr><td>範例</td><td><pre>MID("Calculation", 2) = "alculation"</pre><pre>MID("Calculation", 2, 5) ="alcul"</pre></td></tr><tr><td>說明</td><td>另請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm" target="_blank">額外函數文件</a>中支援的正規表式。</td></tr></tbody></table>

### MIN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>MIN(expression)</code> 或 <code>MIN(expr1, expr2)</code></td></tr><tr><td>輸出</td><td>與引數相同的資料類型，若引數的任何部分為 NULL，則為 <code>NULL&nbsp;</code>。</td></tr><tr><td>定義</td><td><p>傳回兩個引數（必須為相同資料類型）的最小值。</p><p><code>MIN </code> 也可以作為彙總套用於單一欄位。</p></td></tr><tr><td>範例</td><td><pre>MIN(4,7) = 4<br>MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986#<br>MIN([Name]) = "Abebi"</pre></td></tr><tr><td>說明</td><td><p><b>對於字串</b></p><p><code>MIN</code> 通常是按字母順序排列在最前面的值。</p><p class="note">對於資料庫資料來源，<code>MIN</code> 字串值是資料庫為欄定義的排序順序中的最低值。</p><p><b>對於日期</b></p><p>對於日期，<code>MIN</code> 是最早的日期。如果 <code>MIN</code> 是彙總，結果不會有日期階層。如果 <code>MIN</code> 是比較，結果將保留日期階層。</p><p><b>作為彙總</b></p><p><code>MIN(expression)</code> 為彙總函數，會傳回單一彙總結果。這在視覺效果中顯示為 <code>AGG(expression)</code>。</p><p><b>作為比較</b></p><p><code>MIN(expr1, expr2)</code> 會比較兩個值，並傳回一個列層級值。</p><p>另請參閱 <code><a href="#MAX" class="xref">MAX</a></code>。</p></td></tr></tbody></table>

### 模型擴充功能

有關詳情，請參閱[Tableau 計算函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm)。

- MODEL\_EXTENSION\_BOOL
- MODEL\_EXTENSION\_INT
- MODEL\_EXTENSION\_REAL
- MODEL\_EXTENSION\_STR

### MODEL\_PERCENTILE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>MODEL_PERCENTILE(
							<br>model_specification (optional),
							<br>target_expression,
						<br>predictor_expression(s))</code></td></tr><tr><td>定義</td><td>傳回預期值的概率（介於 0 和 1 之間）小於或等於目標運算式和其他預測值定義的觀測標記。這是後驗預測分佈函數，也稱為累積分佈函數 (CDF)。</td></tr><tr><td>範例</td><td><pre>MODEL_PERCENTILE( SUM([Sales]),COUNT([Orders]))</pre></td></tr></tbody></table>

### MODEL\_QUANTILE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>MODEL_QUANTILE(
							<br>model_specification (optional), 
							<br>quantile, 
							<br>target_expression,
						<br>predictor_expression(s))</code></td></tr><tr><td>定義</td><td>在指定的分位數傳回目標運算式和其他預測值定義的可能範圍內的目標數值。這是後驗預測分位數。</td></tr><tr><td>範例</td><td><pre>MODEL_QUANTILE(0.5, SUM([Sales]), COUNT([Orders]))</pre></td></tr></tbody></table>

### MONTH

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>MONTH(date)</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>以整數的形式傳回給定 <code>&lt;date&gt;</code> 的月份。</td></tr><tr><td>範例</td><td><pre>MONTH(#1986-03-25#) = 3</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#DAY" class="xref">DAY</a></code>、<code><a href="#WEEK" class="xref">WEEK</a></code>、<code><a href="#QUARTER" class="xref">Quarter</a></code>、<code><a href="#YEAR" class="xref">YEAR</a></code>，以及 ISO 等值</td></tr></tbody></table>

[回到頁首](#top)

## N

### NOT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>NOT&nbsp;&lt;expression&gt;</code></td></tr><tr><td>輸出</td><td>布林值 (True 或 False)</td></tr><tr><td>定義</td><td>對一個運算式執行邏輯非運算。</td></tr><tr><td>範例</td><td><pre>IF <b>NOT</b> [Season] = "Summer" <br>THEN 'Don't wear sandals' <br>ELSE&nbsp;'Wear sandals'&nbsp;<br><b>END</b></pre><p><i>「如果『季節』不等於『夏天』，就傳回</i>『不要』穿涼鞋<i>。如果不是，就傳回</i>『穿』涼鞋<i>。」</i></p></td></tr><tr><td>說明</td><td><p>經常與 <a href="#IF" class="xref">IF</a> 和 <a href="#IIF" class="xref">IIF</a> 一起使用。另請參閱 <a href="#top" class="xref">本參考中的 Tableau 函數按字母順序進行組織。點選某個字母可跳到清單中的該位置。您也可以使用 Ctrl+F（Mac 上為 Command-F）開啟搜尋方塊來尋找特定功能。</a> 和 <a href="#OR" class="xref">OR</a>。</p></td></tr></tbody></table>

### NOW

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>NOW()</code></td></tr><tr><td>輸出</td><td>日期時間</td></tr><tr><td>定義</td><td>傳回目前本機系統日期和時間。</td></tr><tr><td>範例</td><td><pre>NOW() = 1986-03-25 1:08:21 PM</pre></td></tr><tr><td>說明</td><td><p><code>NOW</code> 沒有採用引數。</p><p>另請參閱 <code><a href="#TODAY" class="xref">TODAY</a></code>，這是一個類似的計算，它傳回日期而不是日期時間。</p><p>如果資料來源是即時連線，則係統日期和時間可能位於另一個時區。有關如何聯接資料的詳情，請參閱<a href="https://kb.tableau.com/articles/issue/now-function-returns-utc-time?lang=zh-tw">知識庫</a>。</p></td></tr></tbody></table>

[回到頁首](#top)

## O

### OR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>&lt;expr1&gt; OR &lt;expr2&gt;</code></td></tr><tr><td>輸出</td><td>布林值 (True 或 False)</td></tr><tr><td>定義</td><td>對兩個運算式執行邏輯析取操作。</td></tr><tr><td>範例</td><td><pre>IF [Season] = "Spring"&nbsp;<b>OR</b>&nbsp;[Season] = "Fall" <br>THEN&nbsp;"Sneakers" <br>END</pre><p><i>「如果 (Season = Spring) 或 (Season = Fall) 為 true，則傳回 Sneakers。」</i></p></td></tr><tr><td>說明</td><td><p>經常與 <a href="#IF" class="xref">IF</a> 和 <a href="#IIF" class="xref">IIF</a> 一起使用。另請參閱 <a href="#top" class="xref">本參考中的 Tableau 函數按字母順序進行組織。點選某個字母可跳到清單中的該位置。您也可以使用 Ctrl+F（Mac 上為 Command-F）開啟搜尋方塊來尋找特定功能。</a> 和 <a href="#NOT" class="xref">NOT</a>。</p><p>如果任一運算式為 <code>TRUE</code>，則結果為 <code>TRUE</code>。如果兩個運算式都為 <code>FALSE</code>，則結果為 <code>FALSE</code>。如果兩個運算式都為 <code>NULL</code>，則結果為 <code>NULL</code>。</p><p>如果您建立的計算在工作表上顯示 <code>OR</code> 比較的結果，Tableau 將顯示 <code>TRUE</code> 和 <code>FALSE</code>。如果要變更此情況，請使用設定格式對話方塊中的「設定格式」區域。</p><p class="note"><b>附註</b>：<code>OR</code> 運算子採用<em>短路計算。</em>這表示如果第一個運算式計算為 <code>TRUE</code>，則根本不會計算第二個運算式。如果第二個運算式在第一個運算式為 <code>TRUE</code> 時產生錯誤，則這可能十分有用，因為在這種情況下從不計算第二個運算式。</p></td></tr></tbody></table>

### OUTLINE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>OUTLINE(&lt;spatial polygon&gt;)</code></td></tr><tr><td>輸出</td><td>幾何圖形</td></tr><tr><td>定義</td><td>將多邊形幾何圖形轉換為線串。</td></tr><tr><td>說明</td><td><p>對於為輪廓建立單獨的圖層很有用，該圖層的樣式可以與填充不同。</p><p>支援複多邊形內的多邊形。</p></td></tr></tbody></table>

[回到頁首](#top)

## P

### PARSE\_URL

`PARSE_URL(string, url_part)`

僅在連線到 Cloudera Impala 時支援。有關詳情，請參閱[其他函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm)。

### PARSE\_URL\_QUERY

`PARSE_URL_QUERY(string, key)`

僅在連線到 Cloudera Impala 時支援。有關詳情，請參閱[其他函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm)。

### PERCENTILE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>PERCENTILE(expression, number)</code></td></tr><tr><td>定義</td><td>從給定 <code>&lt;expression&gt;</code> 傳回與指定 <code>&lt;number&gt;</code> 對應的百分位數值。<code>&lt;number&gt;</code> 必須介於 0 到 1 之間（含 0 和 1）並且必須是數字常數。</td></tr><tr><td>範例</td><td><pre>PERCENTILE([Score], 0.9)</pre></td></tr><tr><td>資料庫限制</td><td><p>此功能適用於以下資料來源：非舊版 Microsoft Excel 和文字檔案連線、擷取和僅擷取資料來源類型（例如 Google Analytics、OData 或 Salesforce）、Sybase IQ 15.1 及更高版本資料來源、Oracle 10 及更高版本的資料來源、Cloudera Hive 和Hortonworks Hadoop Hive 資料來源、EXASolution 4.2 及更高版本的資料來源。</p><p>對於其他資料來源類型，可以將資料擷取到擷取檔案以使用此函數。請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/extracting_data.htm" target="_blank">擷取您的資料</a>。</p></td></tr></tbody></table>

### PI

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>PI()</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>傳回數字常數 pi：3.14159...</td></tr><tr><td>範例</td><td><pre>PI()&nbsp;= 3.14159</pre></td></tr><tr><td>說明</td><td>對於以弧度為輸入的三角函數很有用。</td></tr></tbody></table>

### POWER

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>POWER(number, power)</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>計算 <code>&lt;number&gt;</code> 的指定 <code>&lt;power&gt;</code> 次方。</td></tr><tr><td>範例</td><td><pre>POWER(5,3) = 125<br>POWER([Temperature], 2)</pre></td></tr><tr><td>說明</td><td>也可以使用 ^ 符號，例如 <code>5^3 = POWER(5,3) = 125</code><p>另請參閱 <code><a href="#EXP" class="xref">EXP</a></code>、<code><a href="#LOG" class="xref">LOG</a></code> 和 <code><a href="#SQUARE" class="xref">SQUARE</a></code>。</p></td></tr></tbody></table>

### PREVIOUS\_VALUE

`PREVIOUS_VALUE(expression)`

有關詳情，請參閱[Tableau 計算函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm)。

### PROPER

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>PROPER(string)</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td><p>傳回提供的 <code>&lt;string&gt;</code>，其中每個單字的第一個字母大寫，其餘字母小寫。</p></td></tr><tr><td>範例</td><td><pre>PROPER("PRODUCT name") = "Product Name"</pre><pre>PROPER("darcy-mae") = "Darcy-Mae"</pre></td></tr><tr><td>說明</td><td><p>空格和非英數字元（如標點符號）也用作分隔符號。</p><p>另請參閱 <a href="#LOWER" class="xref">LOWER</a> 和 <a href="#UPPER" class="xref">UPPER</a>。</p></td></tr></tbody></table>

[回到頁首](#top)

## Q

### Quarter

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>QUARTER(date)</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>以整數的形式傳回給定 <code>&lt;date&gt;</code> 的季度。</td></tr><tr><td>範例</td><td><pre>QUARTER(#1986-03-25#) = 1</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#DAY" class="xref">DAY</a></code>、<code><a href="#WEEK" class="xref">WEEK</a></code>、<code><a href="#MONTH" class="xref">MONTH</a></code>、<code><a href="#YEAR" class="xref">YEAR</a></code>，以及 ISO 等值</td></tr></tbody></table>

[回到頁首](#top)

## R

### RADIANS

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>RADIANS(number)</code></td></tr><tr><td>輸出</td><td>數字（以弧度表示的角度）</td></tr><tr><td>定義</td><td>將給定的 <code>&lt;number&gt;</code> 從度數轉換為弧度。</td></tr><tr><td>範例</td><td><pre>RADIANS(180) = 3.14159</pre></td></tr><tr><td>說明</td><td>反函數 <code><a href="#DEGREES" class="xref">DEGREES</a></code> 取得以弧度表示的角度，並傳回以度表示的角度。</td></tr></tbody></table>

### RANK 資料表計算函數

有關詳情，請參閱[Tableau 計算函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm)。

- `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)](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_passthrough.htm)。

- `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 函數

有關詳情，請參閱[其他函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm)。

- `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

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>REPLACE(string, substring, replacement</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>在 <code>&lt;string&gt;</code> 中搜尋 <code>&lt;substring&gt;</code> 並將其替換為 <code>&lt;replacement&gt;</code>。如果未找到 <code>&lt;substring&gt;</code>，則字串保持不變。</td></tr><tr><td>範例</td><td><pre>REPLACE("Version 3.8", "3.8", "4x") = "Version 4x"</pre></td></tr><tr><td>說明</td><td>另請參閱在<a href="https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm" target="_blank">額外函數文件</a>中的 <code>REGEXP_REPLACE</code>。</td></tr></tbody></table>

### RIGHT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>RIGHT(string, number)</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>傳回字串最右側 <code>&lt;number&gt;</code> 的字元。</td></tr><tr><td>範例</td><td><pre>RIGHT("Calculation", 4) = "tion"</pre></td></tr><tr><td>說明</td><td>另請參閱 <a href="#LEFT" class="xref">LEFT</a> 和 <a href="#MID" class="xref">MID</a>。</td></tr></tbody></table>

### ROUND

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ROUND(number, [decimals])</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td><p>將 <code>&lt;number&gt;</code> 舍入為指定位元數。</p><p>可選的 <code>decimals</code> 引數指定最終結果中要包含的小數位數精度。若省略 <code>decimals</code>，則數字將四捨五入到最近的整數。</p></td></tr><tr><td>範例</td><td><pre>ROUND(1/3, 2) = 0.33</pre></td></tr><tr><td>說明</td><td><p>某些資料庫（例如 SQL Server）允許指定負長度，其中 -1 將數字四捨五入到十位，-2 四捨五入到百位，依此類推。此功能並不適用於所有資料庫。例如，Excel 和 Access 不具備此功能。</p><blockquote><p>[!TIP]</p><p><b>提示</b>：因為 ROUND 可能會因數字的基本浮點表示而遇到問題，例如 9.405 四捨五入到 9.40，因此最好將<a href="https://help.tableau.com/current/pro/desktop/zh-tw/formatting_specific_numbers.htm">數字格式化</a>為所需的小數點位數，而不是舍入。將 9.405 格式化為兩位小數將得到預期的 9.41。</p></blockquote><p>另請參閱 <code><a href="#CEILING" class="xref">CEILING</a></code> 和 <code><a href="#FLOOR" class="xref">FLOOR</a></code>。</p></td></tr></tbody></table>

### RTRIM

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>RTRIM(string)</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>傳回移除所有尾端空格的 <code>&lt;string&gt;</code>。</td></tr><tr><td>範例</td><td><pre>RTRIM(" Calculation ") = " Calculation"</pre></td></tr><tr><td>說明</td><td>另請參閱 <a href="#LTRIM" class="xref">LTRIM</a> 和 <a href="#TRIM" class="xref">TRIM</a>。</td></tr></tbody></table>

### RTRIM\_THIS

`RTRIM_THIS(string, string)`

僅在連線到 Google BigQuery 時受支援。有關詳情，請參閱[其他函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm)。

### RUNNING 資料表計算函數

有關詳情，請參閱[Tableau 計算函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm)。

- `RUNNING_AVG(expression)`
- `RUNNING_COUNT(expression)`
- `RUNNING_MAX(expression)`
- `RUNNING_MIN(expression)`
- `RUNNING_SUM(expression)`

[回到頁首](#top)

## S

### SCRIPT 分析擴充功能

有關詳情，請參閱[Tableau 計算函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm)。

- `SCRIPT_BOOL`
- `SCRIPT_INT`
- `SCRIPT_REAL`
- `SCRIPT_STR`

### SHAPETYPE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>SHAPETYPE(&lt;geometry&gt;)</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>傳回描述空間幾何結構的字串，例如 Empty、Point、MultiPoint、LineString、MultiLinestring、Polygon、MultiPolygon、Mixed 和不支援的</td></tr><tr><td>範例</td><td><pre>SHAPETYPE(MAKEPOINT(48.5, -123.1)) = "Point"</pre></td></tr></tbody></table>

### SIGN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>SIGN(number)</code></td></tr><tr><td>輸出</td><td>-1、0 或 1</td></tr><tr><td>定義</td><td>傳回 <code>&lt;number&gt;</code> 的符號：若數字為負，則傳回的值可能為 -1；若數字為零，則為 0；若數字為正，則為 1。</td></tr><tr><td>範例</td><td><pre>SIGN(AVG(Profit)) = -1</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#ABS" class="xref">ABS</a></code>。</td></tr></tbody></table>

### SIN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>SIN(number)</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>傳回以弧度為單位的角度正弦。</td></tr><tr><td>範例</td><td><pre>SIN(0) = 1.0<br>SIN(PI( )/4) = 0.707106781186548</pre></td></tr><tr><td>說明</td><td><p>反函數 <code><a href="#ASIN" class="xref">ASIN</a></code> 以正弦作為引數，並傳回以弧度表示的角度。</p><p>另請參閱 <code><a href="#PI" class="xref">PI</a></code>。若要將角度從度數轉換為弧度，請使用 <code><a href="#RADIANS" class="xref">RADIANS</a></code>。</p></td></tr></tbody></table>

### SIZE

`SIZE()`

有關詳情，請參閱[Tableau 計算函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm)。

### SPACE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>SPACE(number)</code></td></tr><tr><td>輸出</td><td>字串（具體來說，只是空格）</td></tr><tr><td>定義</td><td>傳回由指定數量的重複空格組成的字串。</td></tr><tr><td>範例</td><td><pre>SPACE(2) = "  "</pre></td></tr></tbody></table>

### SPLIT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>SPLIT(string, delimiter, token number)</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>傳回 <code>&lt;string&gt;</code> 中的一個子字串，並使用 <code>&lt;delimiter&gt;</code> 字元將字串分為一系列 <code>&lt;tokens&gt;</code>。</td></tr><tr><td>範例</td><td><pre>SPLIT ("a-b-c-d", "-", 2) = "b"</pre><pre>SPLIT ("a|b|c|d", "|", -2) = "c"</pre></td></tr><tr><td>說明</td><td><p>字串將被解釋為分隔符號和權杖的交替序列。因此，對於字串 <code>abc-defgh-i-jkl</code>，其中分隔符號字元為「<code>-</code>」，權杖為 (1) <code>abc</code>、(2) <code>defgh</code>、(3) <code>i</code> 和 (4) <code>jlk</code></p><p><code>SPLIT</code> 傳回與權杖編號對應的權杖。如果權杖編號為正，則從字串的左側開始計算權杖；如果權杖編號為負，則從右側開始計算權杖。</p><p>另請參閱<a href="https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm" target="_blank">額外函數文件</a>中支援的正規表式。</p></td></tr><tr><td>資料庫限制</td><td><p>可以為以下資料來源類型使用拆分和自訂拆分命令：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。</p><p>某些資料來源在拆分字串時會有限制。請參閱本主題後面的 SPLIT 函數限制。</p></td></tr></tbody></table>

### SQRT

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>SQRT(number)</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>傳回 <code>&lt;number&gt;</code> 的平方根。</td></tr><tr><td>範例</td><td><pre>SQRT(25) = 5</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#SQUARE" class="xref">SQUARE</a></code>。</td></tr></tbody></table>

### SQUARE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>SQUARE(number)</code></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>傳回 <code>&lt;number&gt;</code> 的平方。</td></tr><tr><td>範例</td><td><pre>SQUARE(5) = 25</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#SQRT" class="xref">SQRT</a></code> 和 <code><a href="#POWER" class="xref">POWER</a></code>。</td></tr></tbody></table>

### STARTSWITH

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>STARTSWITH(string, substring)</code></td></tr><tr><td>輸出</td><td>布林值</td></tr><tr><td>定義</td><td>如果 <code>string</code> 以 <code>substring</code> 開頭，則返回 true。會忽略前導空格。</td></tr><tr><td>範例</td><td><pre xml:space="preserve">STARTSWITH("Matador, "Ma") = TRUE</pre></td></tr><tr><td>說明</td><td>另請參閱 <a href="#CONTAINS" class="xref">CONTAINS</a>，以及<a href="https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm" target="_blank">額外功能文件</a>中支援的正規表式。</td></tr></tbody></table>

### STDEV

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>STDEV(expression)</code></td></tr><tr><td>定義</td><td>基於群體樣本傳回給定 <code>&lt;expression&gt;</code> 中所有值的統計標準差。</td></tr></tbody></table>

### STDEVP

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>STDEVP(expression)</code></td></tr><tr><td>定義</td><td>基於有偏差群體傳回給定 <code>&lt;expression&gt;</code> 中所有值的統計標準差。</td></tr></tbody></table>

### STR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>STR(expression)</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>將其參數轉換為字串。</td></tr><tr><td>範例</td><td><pre>STR([ID])</pre></td></tr></tbody></table>

### SUM

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>SUM(expression)</code></td></tr><tr><td>定義</td><td>傳回 <code>&lt;expression&gt;</code> 中所有值的總計。會忽略 Null 值。</td></tr><tr><td>說明</td><td><code>SUM</code> 只能用於數字欄位。</td></tr></tbody></table>

[回到頁首](#top)

## T

### TAN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>TAN(number)</code><p><code>&lt;number&gt;</code> 引數是以弧度表示的角度。</p></td></tr><tr><td>輸出</td><td>數字</td></tr><tr><td>定義</td><td>返回角度的正切。</td></tr><tr><td>範例</td><td><pre>TAN(PI ( )/4) = 1.0</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#ATAN" class="xref">ATAN</a></code>、<code><a href="#ATAN2" class="xref">ATAN2</a></code>、<code><a href="#COT" class="xref">COT</a></code> 和 <code><a href="#PI" class="xref">PI</a></code>。若要將角度從度數轉換為弧度，請使用 <code><a href="#RADIANS" class="xref">RADIANS</a></code>。</td></tr></tbody></table>

### you can rerun the query or view

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>IF &lt;test1&gt; <b>THEN</b> &lt;then1&gt; 
							<br>[ELSEIF &lt;test2&gt; <b>THEN</b> &lt;then2&gt;...]
							<br>[ELSE &lt;default&gt;] 
						<br>END</code></td></tr><tr><td>定義</td><td><code>IF</code>、<code>ELSEIF</code> 或 <code>CASE</code> 運算式的必要部分，用於定義在特定值或測試為 TRUE 時傳回的結果。</td></tr><tr><td>範例</td><td><pre>IF [Season] = "Summer"&nbsp;<b>THEN</b>&nbsp;'Sandals' <br>ELSEIF&nbsp;[Season] = "Winter"&nbsp;<b>THEN</b>&nbsp;'Boots' <br>ELSE&nbsp;'Sneakers'&nbsp;<br>END</pre><p><i>「若 Season = Summer [季節 = 夏季]，則傳回 Sandals [涼鞋]。如果不是，請看下一個運算式。若 Season = Winter [季節 = 冬季]，則傳回 Boots [靴子]。若兩個運算式均不為 TRUE，則傳回 Sneakers [運動鞋]。」</i></p><pre>CASE [Season] <br>WHEN 'Summer' <b>THEN</b> 'Sandals' <br>WHEN 'Winter' <b>THEN</b> 'Boots' <br>ELSE 'Sneakers' <br>END</pre><p><i>「讓我們來看看 Season [季節] 欄位。若值為 Summer [夏季]，則傳回 Sandals [涼鞋]。若值為 Winter [冬季]，則傳回 Boots [靴子]。若計算中的選項均不符合 Season [季節] 欄位中的選項，則傳回 Sneakers [運動鞋]。」</i></p></td></tr><tr><td>說明</td><td><p>與 <a href="#CASE" class="xref">CASE</a>、<a href="#WHEN" class="xref">WHEN</a>、<a href="#IF" class="xref">IF</a>、<a href="#ELSEIF" class="xref">ELSEIF</a>、<a href="#THEN" class="xref">you can rerun the query or view</a>、<a href="#ELSE" class="xref">ELSE</a> 和 <a href="#END" class="xref">END</a> 一起使用</p></td></tr></tbody></table>

### TIMESTAMP\_TO\_USEC

`TIMESTAMP_TO_USEC(expression)`

僅在連線到 Google BigQuery 時受支援。有關詳情，請參閱[其他函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm)。

### TLD

`TLD(string_url)`

僅在連線到 Google BigQuery 時受支援。有關詳情，請參閱[其他函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm)。

### TODAY

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>TODAY()</code></td></tr><tr><td>輸出</td><td>日期</td></tr><tr><td>定義</td><td>傳回目前本機系統日期。</td></tr><tr><td>範例</td><td><pre>TODAY() = 1986-03-25</pre></td></tr><tr><td>說明</td><td><p><code>TODAY</code> 沒有採用引數。</p><p>另請參閱 <code><a href="#NOW" class="xref">NOW</a></code>，這是一個類似的計算，它傳回日期時間而不是日期。</p><p>如果資料來源是即時連線，則係統日期可能位於另一個時區。有關如何聯接資料的詳情，請參閱<a href="https://kb.tableau.com/articles/issue/now-function-returns-utc-time?lang=zh-tw">知識庫</a>。</p></td></tr></tbody></table>

### TOTAL

`TOTAL(expression)`

有關詳情，請參閱[Tableau 計算函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm)。

### TRIM

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>TRIM(string)</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>傳回提供的 <code>&lt;string&gt;</code>，且移除前導和尾端空格。</td></tr><tr><td>範例</td><td><pre>TRIM(" Calculation ") = "Calculation"</pre></td></tr><tr><td>說明</td><td>另請參閱 <a href="#LTRIM" class="xref">LTRIM</a> 和 <a href="#RTRIM" class="xref">RTRIM</a>。</td></tr></tbody></table>

[回到頁首](#top)

## U

### UPPER

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>UPPER(string)</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>傳回提供的 <code>&lt;string&gt;</code>，且全為大寫字元。</td></tr><tr><td>範例</td><td><pre>UPPER("Calculation") = "CALCULATION"</pre></td></tr><tr><td>說明</td><td>另請參閱 <a href="#PROPER" class="xref">PROPER</a> 和 <a href="#LOWER" class="xref">LOWER</a>。</td></tr></tbody></table>

### USEC\_TO\_TIMESTAMP

`USEC_TO_TIMESTAMP(expression)`

僅在連線到 Google BigQuery 時受支援。有關詳情，請參閱[其他函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_additional.htm)。

### USERDOMAIN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>USERDOMAIN(&nbsp;)</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>傳回目前使用者的網域。</td></tr><tr><td>說明</td><td><p>此函數會檢查：</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 和 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>：登入使用者的使用者網域</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>：如果使用者位於網域中，則為本機網域</li></ul></td></tr></tbody></table>

### USERNAME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>USERNAME( )</code></td></tr><tr><td>輸出</td><td>字串</td></tr><tr><td>定義</td><td>返回目前使用者的使用者名。</td></tr><tr><td>範例</td><td><pre xml:space="preserve">USERNAME( )</pre><p>此函數會傳回登入使用者的使用者名稱，例如「hmyrer」。</p><pre xml:space="preserve">[Manager] = USERNAME( )</pre><p>如果經理「hmyrer」已登入，則僅檢視中的「經理」欄位包含「hmyrer」時，此範例才會傳回 TRUE。</p></td></tr><tr><td>說明</td><td><p>此函數會檢查：</p><ul><li><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 和 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span>：已登入的使用者的使用者名稱</li><li><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>：使用者的本機或網路使用者名稱</li></ul><p><b>使用者篩選器</b></p><p>用作篩選器時，如 <code>[Username field] = USERNAME( )</code> 這樣的計算欄位可用於建立使用者篩選器，該篩選器僅顯示與登入到伺服器的人員相關的資料。</p></td></tr></tbody></table>

### USER ATTRIBUTE JSON Web 權杖函數

- `USERATTRIBUTE('attribute_name')`
- `USERATTRIBUTEINCLUDES('attribute_name', 'expected_value')`

有關詳情，請參閱[使用者函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_user.htm)。

[回到頁首](#top)

## V

### VAR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>VAR(expression)</code></td></tr><tr><td>定義</td><td>基於群體樣本返回給定運算式中所有值的統計變異數。</td></tr></tbody></table>

### VARP

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>VARP(expression)</code></td></tr><tr><td>定義</td><td>對整個群體返回給定運算式中所有值的統計變異數。</td></tr></tbody></table>

[回到頁首](#top)

## W

### WEEK

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>WEEK(date)</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>以整數的形式傳回給定 <code>&lt;date&gt;</code> 的週。</td></tr><tr><td>範例</td><td><pre>WEEK(#1986-03-25#) = 13</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#DAY" class="xref">DAY</a></code>、<code><a href="#MONTH" class="xref">MONTH</a></code>、<code><a href="#QUARTER" class="xref">Quarter</a></code>、<code><a href="#YEAR" class="xref">YEAR</a></code>，以及 ISO 等值</td></tr></tbody></table>

### WHEN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>CASE &lt;expression&gt;<br><b>WHEN</b> &lt;value1&gt; THEN &lt;then1&gt;<br><b>WHEN</b> &lt;value2&gt; THEN &lt;then2&gt;<br>...<br>[ELSE &lt;default&gt;]<br>END</code></td></tr><tr><td>定義</td><td><code>CASE</code> 運算式的必需部分。尋找第一個與 <code>&lt;expression&gt;</code> 相符的 <code>&lt;value&gt;</code>，並傳回對應的 <code>&lt;then&gt;</code>。</td></tr><tr><td>範例</td><td><pre>CASE [Season] <br><b>WHEN</b> 'Summer' THEN 'Sandals' <br><b>WHEN</b> 'Winter' THEN 'Boots' <br>ELSE 'Sneakers' <br>END</pre><p><i>「讓我們來看看 Season [季節] 欄位。若值為 Summer [夏季]，則傳回 Sandals [涼鞋]。若值為 Winter [冬季]，則傳回 Boots [靴子]。若計算中的選項均不符合 Season [季節] 欄位中的選項，則傳回 Sneakers [運動鞋]。」</i></p></td></tr><tr><td>說明</td><td><p>與 <a href="#CASE" class="xref">CASE</a>、<a href="#THEN" class="xref">you can rerun the query or view</a>、<a href="#ELSE" class="xref">ELSE</a> 和 <a href="#END" class="xref">END</a> 一起使用。</p><p><code>CASE</code> 也支援 <code>WHEN IN</code> 建構，例如：</p><pre xml:space="preserve">CASE &lt;expression&gt; <br><b>WHEN IN</b> &lt;set1&gt; THEN &lt;then1&gt; <br><b>WHEN IN</b> &lt;combinedfield&gt; THEN &lt;then2&gt; <br>... <br>ELSE &lt;default&gt; <br>END</pre><p><code>WHEN IN</code> 比較的值必須是集合、常值清單或合併欄位。另請參閱 <a href="#IN" class="xref">IN</a>。</p></td></tr></tbody></table>

### 窗格表計算

有關詳情，請參閱[Tableau 計算函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_tablecalculation.htm)。

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

[回到頁首](#top)

## X

### XPATH 函數。

僅在連線到 Hadoop Hive 時才受支援。有關詳情，請參閱[傳遞函數 (RAWSQL)](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_passthrough.htm)。

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

[回到頁首](#top)

## Y

### YEAR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>YEAR(date)</code></td></tr><tr><td>輸出</td><td>整數</td></tr><tr><td>定義</td><td>以整數的形式傳回給定 <code>&lt;date&gt;</code> 的年份。</td></tr><tr><td>範例</td><td><pre xml:space="preserve">YEAR(#1986-03-25#) = 1,986</pre></td></tr><tr><td>說明</td><td>另請參閱 <code><a href="#DAY" class="xref">DAY</a></code>、<code><a href="#WEEK" class="xref">WEEK</a></code>、<code><a href="#MONTH" class="xref">MONTH</a></code>、<code><a href="#QUARTER" class="xref">Quarter</a></code>，以及 ISO 等值</td></tr></tbody></table>

[回到頁首](#top)

## Z

### ZN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>語法</td><td><code>ZN(expression)</code></td></tr><tr><td>輸出</td><td>取決於 <code>&lt;expression&gt;</code> 的資料類型，或為 0。</td></tr><tr><td>定義</td><td>若 <code>&lt;expression&gt;</code> 不為 NULL，則傳回該運算式，否則傳回 0。</td></tr><tr><td>範例</td><td><pre xml:space="preserve">ZN([Test Grade])</pre><p><i>「若測驗成績不為 NULL，則傳回其值。若測驗成績為 NULL，則傳回 0。」</i></p></td></tr><tr><td>說明</td><td><p><code>ZN</code> 是 <a href="#IFNULL" class="xref">IFNULL</a> 的特殊情況，其中若運算式為 NULL，則替代項始終為 0，而不是在計算中指定。</p><p><code>ZN</code> 在執行額外計算時特別有用，並且 NULL 會讓整個計算為 NULL。但是，請謹慎，將這些結果解譯為 NULL 並不總是與 0 同義，並且可能表示缺失資料。</p><p>另請參閱 <a href="#ISNULL" class="xref">ISNULL</a>。</p></td></tr></tbody></table>

[回到頁首](#top)

## 另請參閱

[Tableau 函數（按類別）](https://help.tableau.com/current/pro/desktop/zh-tw/functions_all_categories.htm)

[Tableau 中的函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions.htm)