---
schema_version: "1"
id: 9471120193bb518c824b44ec5b8c792e2dd0844a5f8a87eae5fa5878702fc7ef
title: 自訂 Tableau 資料故事：函數
collection: tableau
version: current
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/current/zh-tw/online/data_stories_customize_functions.md
canonical_url: https://help.tableau.com/current/online/zh-tw/data_stories_customize_functions.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 187da33ab4360051c0569d0b6031b3d3714b5b78c76115129e1c390eb6adc9f7
description: Feature retired.
---
[跳至主要內容](#main-content)

# 自訂 Tableau 資料故事：函數

**Tableau 資料故事的重要變化**

Tableau 資料故事將在 Tableau Desktop、Tableau Cloud， 和 Tableau Server 中於 2025 年 1 月 (2025.1) 淘汰。隨著自然語言技術的進步，我們正在開發一種改進的界面，讓您可以更輕鬆地提出資料問題並掌握變化。更多資訊請參閱 [Tableau Pulse Tableau AI 重新構想資料體驗。](https://www.tableau.com/zh-tw/blog/tableau-pulse-and-tableau-ai)

若想使用函數自訂 Tableau 資料故事，瞭解可以使用哪些函數、每個函數的作用以及每個函數需要哪些維度和度量會很有幫助。

瞭解如何向資料故事[新增函數](https://help.tableau.com/current/online/zh-tw/data_stories_customize.htm#Add)。  
  

按一下某個字母，以查看以該字母開頭的函數。如果沒有以該字母開頭的函數，則將顯示以字母表中的下一個字母開頭的函數。您也可以按 Ctrl+F（在 Mac 上按 Command-F）開啟一個搜尋方塊，您可以使用它來搜尋特定函數的頁面。

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

  

#### Average（平均值）

描述：指定度量的平均值。

語法：Average(dimension, measure, filterDimensionValue)  
  

#### Count（計數）

說明：指定維度內維度值的數量。

語法：Count(dimension)  
  

#### Difference（差異）

說明：兩個提供的維度值之間的度量值差異。

語法：Difference(dimension, measure, firstDimensionValue, secondDimensionValue, filterDimensionValue)  
  

#### DifferenceFromMean（均值差）

說明：指定維度值的平均值和度量值之間的差異。

語法：DifferenceFromMean(dimension, measure, firstDimensionValue, filterDimensionValue)  
  

#### Direction（方向）

說明：描述兩個提供的維度值的度量值之間的方向（例如，增加或減少）的語言。

語法：Direction(dimension, measure, firstDimensionValue, secondDimensionValue, filterDimensionValue, phrase)  
  

#### Ending Label（結束標籤）

說明：時間序列中最後一個時期的名稱。

語法：Label(measure)  
  

#### EndingValue（結束值）

說明：指定度量的時間序列中最後一個時期的值。

語法：EndingValue(measure, filterDimensionValue)  
  

#### Label（標籤）

說明：指定度量的標籤。

語法：Label(measure)  
  

#### LargestNegativeChangeDifference（最大負變更差）

說明：指定時間序列中最大負時期與時期差的絕對值。

語法：LargestNegativeChangeDifference(measure, filterDimensionValue)  
  

#### LargestNegativeChangeEndingLabel（最大負變更結束標籤）

說明：指定時間序列中最大負時期與時期差的結束時期名稱（基於絕對值）。

語法：LargestNegativeChangeEndingLabel(measure, filterDimensionValue)  
  

#### LargestNegativeChangeEndingValue（最大負變更結束值）

說明：指定時間序列中最大負時期與時期差的絕對結束值。

語法：LargestNegativeChangeEndingValue(measure, filterDimensionValue)  
  

#### LargestNegativeChangePercentDifference（最大負變更百分比差）

說明：指定時間序列中最大負時期與時期差的百分比變更（基於絕對值）。

語法：LargestNegativeChangePercentDifference(measure, filterDimensionValue)  
  

#### LargestNegativeChangeStartingLabel（最大負變更開始標籤）

說明：指定時間序列中最大負時期與時期差的開始時期名稱（基於絕對值）。

語法：LargestNegativeChangeStartingLabel(measure, filterDimensionValue)  
  

#### LargestNegativeChangeStartingValue（最大負變更開始值）

說明：指定時間序列中最大負時期與時期差的絕對開始值。

語法：LargestNegativeChangeStartingValue(measure, filterDimensionValue)  
  

#### LargestNegativePercentChangeDifference（最大負百分比變更差）

說明：指定時間序列中最大負時期與時期差的百分比值。

語法：LargestNegativePercentChangeDifference(measure, filterDimensionValue)  
  

#### LargestNegativePercentChangeEndingLabel（最大負百分比變更結束標籤）

說明：指定時間序列中最大負時期與時期差的結束時期名稱（基於百分比）。

語法：LargestNegativePercentChangeEndingLabel(measure, filterDimensionValue)  
  

#### LargestNegativePercentChangeEndingValue（最大負百分比變更結束值）

說明：指定時間序列中最大負時期與時期差的百分比結束值。

語法：LargestNegativePercentChangeEndingValue(measure, filterDimensionValue)  
  

#### LargestNegativePercentChangePercentDifference（最大負百分比變更百分比差）

說明：指定時間序列中最大負時期與時期差的百分比變更（基於百分比）。

語法：LargestNegativePercentChangePercentDifference(measure, filterDimensionValue)  
  

#### LargestNegativePercentChangeStartingLabel（最大負百分比變更開始標籤）

說明：指定時間序列中最大負時期與時期差的開始時期名稱（基於百分比）。

語法：LargestNegativePercentChangeStartingLabel(measure, filterDimensionValue)  
  

#### LargestNegativePercentChangeStartingValue（最大負百分比變更開始值）

說明：指定時間序列中最大負時期與時期差的百分比開始值。

語法：LargestNegativePercentChangeStartingValue(measure, filterDimensionValue)  
  

#### LargestPositiveChangeDifference（最大正變更差）

說明：指定時間序列中最大正時期與時期差的絕對值。

語法：LargestPositiveChangeDifference(measure, filterDimensionValue)  
  

#### LargestPositiveChangeEndingLabel（最大正變更結束標籤）

說明：指定時間序列中最大正時期與時期差的結束時期名稱（基於絕對值）。

語法：LargestPositiveChangeEndingLabel(measure, filterDimensionValue)  
  

#### LargestPositiveChangeEndingValue（最大正變更結束值）

說明：指定時間序列中最大正時期與時期差的絕對結束值。

語法：LargestPositiveChangeEndingValue(measure, filterDimensionValue)  
  

#### LargestPositiveChangePercentDifference（最大正變更百分比差）

說明：指定時間序列中最大正時期與時期差的百分比變更（基於絕對值）。

語法：LargestPositiveChangePercentDifference(measure, filterDimensionValue)  
  

#### LargestPositiveChangeStartingLabel（最大正變更開始標籤）

說明：指定時間序列中最大正時期與時期差的開始時期名稱（基於絕對值）。

語法：LargestPositiveChangeStartingLabel(measure, filterDimensionValue)  
  

#### LargestPositiveChangeStartingValue（最大正變更開始值）

說明：指定時間序列中最大正時期與時期差的絕對開始值。

語法：LargestPositiveChangeStartingValue(measure, filterDimensionValue)  
  

#### LargestPositivePercentChangeDifference（最大正百分比變更差）

說明：指定時間序列中最大正時期與時期差的百分比值。

語法：LargestPositivePercentChangeDifference(measure, filterDimensionValue)  
  

#### LargestPositivePercentChangeEndingLabel（最大正百分比變更結束標籤）

說明：指定時間序列中最大正時期與時期差的結束時期名稱（基於百分比）。

語法：LargestPositivePercentChangeEndingLabel(measure, filterDimensionValue)  
  

#### LargestPositivePercentChangeEndingValue（最大正百分比變更結束值）

說明：指定時間序列中最大正時期與時期差的百分比結束值。

語法：LargestPositivePercentChangeEndingValue(measure, filterDimensionValue)  
  

#### LargestPositivePercentChangePercentDifference（最大正百分比變更百分比差）

說明：指定時間序列中最大正時期與時期差的百分比變更（基於百分比）。

語法：LargestPositivePercentChangePercentDifference(measure, filterDimensionValue)  
  

#### LargestPositivePercentChangeStartingLabel（最大正百分比變更開始標籤）

說明：指定時間序列中最大正時期與時期差的開始時期名稱（基於百分比）。

語法：LargestPositivePercentChangeStartingLabel(measure, filterDimensionValue)  
  

#### LargestPositivePercentChangeStartingValue（最大正百分比變更開始值）

說明：指定時間序列中最大正時期與時期差的百分比開始值。

語法：LargestPositivePercentChangeStartingValue(measure, filterDimensionValue)  
  

#### LongestStreakDifference（最長連續差異）

說明：指定時間序列的最長連續增加或減少的差異。

語法：LongestStreakDifference(measure, filterDimensionValue)  
  

#### LongestStreakDirection（最長連續方向）

說明：指定時間序列的最長連續增加或減少的方向（正或負）。

語法：LongestStreakDirection(measure, filterDimensionValue)  
  

#### LongestStreakEndingLabel（最長連續結束標籤）

說明：指定時間序列的最長連續增加或減少的結束時期名稱。

語法：LongestStreakEndingLabel(measure, filterDimensionValue)  
  

#### LongestStreakEndingValue（最長連續結束值）

說明：指定時間序列的最長連續增加或減少的結束值。

語法：LongestStreakEndingValue(measure, filterDimensionValue)  
  

#### LongestStreakLength（最長連續時長）

說明：指定時間序列的連續增加或減少的最大時期數。

語法：LongestStreakLength(measure, filterDimensionValue)  
  

#### LongestStreakPercentDifference（最長連續百分比差異）

說明：指定時間序列的最長連續增加或減少的百分比差異。

語法：LongestStreakPercentDifference(measure, filterDimensionValue)  
  

#### LongestStreakStartingLabel（最長連續開始標籤）

說明：指定時間序列的最長連續增加或減少的開始時期名稱。

語法：LongestStreakStartingLabel(measure, filterDimensionValue)  
  

#### LongestStreakStartingValue（最長連續開始值）

說明：指定時間序列的最長連續增加或減少的開始值。

語法：LongestStreakStartingValue(measure, filterDimensionValue)  
  

#### MaxLabel（最大標籤）

說明：具有指定度量最大值的實體名稱。

語法：MaxLabel(dimension, measure, filterDimensionValue)  
  

#### MaxValue（最大值）

說明：指定度量的最大值。

語法：MaxValue(measure)  
  

#### 中位數

說明：指定度量的中位數值。

語法：Median(dimension, measure, filterDimensionValue)  
  

#### MinLabel（最小標籤）

說明：具有指定度量最小值的實體名稱。語法：MinLabel(dimension, measure, filterDimensionValue)  
  

#### MinValue（最小值）

說明：指定度量的最小值。

語法：MinValue(dimension, measure, filterDimensionValue)  
  

#### PercentDifference（百分比差異）

說明：兩個提供的維度值之間度量值的百分比差異。

語法：PercentDifference(dimension, measure, firstDimensionValue, secondDimensionValue, filterDimensionValue)  
  

#### PercentOfWhole（整體的百分比）

說明：指定維度值的度量值佔該維度總度量值的百分比。

語法：PercentOfWhole(dimension, measure, dimensionvalue, filterDimensionValue)  
  

#### PeriodLabel（時期標籤）

說明：時間序列中（從 1 開始）第 n 個時期的名稱。

語法：PeriodLabel(index)  
  

#### PeriodLabelNewest（最新的時期標籤）

說明：時間序列中（從最新的時期開始倒數）第 n 個時期的名稱。

語法：PeriodLabelNewest(index)  
  

#### PeriodValue（時期值）

說明：時間序列中（從 1 開始）第 n 個時期的指定度量值。

語法：PeriodValue(measure, index, filterDimensionValue)  
  

#### PeriodValueNewest（最新的時期值）

說明：時間序列中（從最新的時期開始倒數）第 n 個時期的名稱。

語法： PeriodValueNewest(measure, index)  
  

#### Range（範圍）

說明：指定度量的最大值和最小值之間的差。

語法：Range(dimension, measure, filterDimensionValue)  
  

#### SortAscendingLabel（排序遞增標籤）

說明：指定度量的實體名稱按指定排名遞減排序（從 1 開始）。

語法：SortAscendingLabel(measure, rank, dimension, filterDimensionValue)  
  

#### SortAscendingValue（排序遞增值）

說明：指定度量的值按指定排名遞增排序（從 1 開始）。

語法：SortAscendingValue(measure, rank, dimension, filterDimensionValue)  
  

#### SortDescendingLabel（排序遞減標籤）

說明：指定度量的實體名稱按指定排名遞減排序（從 1 開始）。

語法：SortDescendingLabel(measure, rank, dimension, filterDimensionValue)  
  

#### SortDescendingValue（排序遞減值）

說明：指定度量的值按指定排名遞減排序（從 1 開始）。

語法：SortDescendingValue(measure, rank, dimension, filterDimensionValue)  
  

#### StartingLabel（開始標籤）

說明：時間序列中第一個時期的名稱。

語法：StartingLabel()  
  

#### StartingValue（開始值）

說明：指定度量的時間序列中第一個時期的值。

語法：StartingValue(measure, filterDimensionValue)  
  

#### StartToFinishDifference（開始到結束差）

說明：指定時間序列中第一個時期和最後一個時期的值之間的差。

語法：StartToFinishDifference(measure, filterDimensionValue)  
  

#### StartToFinishPercentDifference（開始到結束百分比差）

說明：指定時間序列中第一個時期和最後一個時期的值之間的百分比差。

語法：StartToFinishPercentDifference(measure, filterDimensionValue)  
  

#### StdDev（標準差）

說明：指定度量的標準差值。

語法：StdDev(dimension, measure, filterDimensionValue)  
  

#### Sum（總和）

說明：兩個提供的維度值的度量值總和。

語法：Sum(dimension, measure, firstDimensionValue, secondDimensionValue, filterDimensionValue)  
  

#### Total（總計）

說明：指定度量的總合計值。

語法：Total(dimension, measure, filterDimensionValue)  
  

#### Value（值）

說明：指定維度、度量和維度值的指標值。

語法：Value(dimension, measure, dimension value, filterDimensionValue)  
  

#### Z-Score（Z 分數）

說明：指定度量的 z 分數。

語法：Z-Score(dimension, measure, firstDimensionValue, filterDimensionValue)