---
schema_version: "1"
id: 2fa5a4752081aa730db0bc1e3f18d35056d0614f1a33c69619ed736bdbf2733e
title: 自定义您的 Tableau 数据故事：函数
collection: tableau
version: current
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/current/zh-cn/pro/desktop/data_stories_customize_functions.md
canonical_url: https://help.tableau.com/current/pro/desktop/zh-cn/data_stories_customize_functions.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 2c866ae6b16a11c61920a3145c80411df4e695613ddad6eabbd58efe2ffffe04
description: Feature retired.
---
[跳转到主要内容](#main-content)

# 自定义您的 Tableau 数据故事：函数

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

如果您想使用函数自定义 Tableau 数据故事，了解您可以使用哪些函数、每个函数的作用以及每个函数需要哪些维度和度量会很有帮助。

了解如何将[添加函数](https://help.tableau.com/current/pro/desktop/zh-cn/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(维度, 度量, 筛选器维度值)  
  

#### Count

描述：给定维度内的维度值的数量。

语法：Count(维度)  
  

#### Difference

描述：两个提供的维度值之间的度量值差异。

语法：Difference(维度, 度量, 第一个维度值, 第二个维度值, 筛选器维度值)  
  

#### DifferenceFromMean

描述：给定维度值的平均值和度量值之间的差异。

语法：DifferenceFromMean(维度, 度量, 第一个维度值, 筛选器维度值)  
  

#### Direction

描述：描述两个提供的维度值的度量值之间的方向（例如，增加或减少）的语言。

语法：Direction(维度, 度量, 第一个维度值, 第二个维度值, 筛选器维度值, 短语)  
  

#### Ending Label

描述：系列中最后一个期间的名称。

语法：Label(度量)  
  

#### EndingValue

描述：给定度量的系列中最后一个期间的值。

语法：EndingValue(度量, 筛选器维度值)  
  

#### Label

描述：给定度量的标签。

语法：Label(度量)  
  

#### LargestNegativeChangeDifference

描述：给定序列中按绝对值计算的最大负周期间差值。

语法：LargestNegativeChangeDifference(度量, 筛选器维度值)  
  

#### LargestNegativeChangeEndingLabel

描述：给定序列中按绝对值计算的最大负期间差异的结束期间的名称。

语法：LargestNegativeChangeEndingLabel(度量, 筛选器维度值)  
  

#### LargestNegativeChangeEndingValue

描述：给定序列中按绝对值计算的最大负周期间差异的结束值。

语法：LargestNegativeChangeEndingValue(度量, 筛选器维度值)  
  

#### LargestNegativeChangePercentDifference

描述：给定序列中按绝对值计算的最大负周期间差异的百分比变化。

语法：LargestNegativeChangePercentDifference(度量, 筛选器维度值)  
  

#### LargestNegativeChangeStartingLabel

描述：给定序列中按绝对值计算的最大负期间差异的开始期间的名称。

语法：LargestNegativeChangeStartingLabel(度量, 筛选器维度值)  
  

#### LargestNegativeChangeStartingValue

描述：给定序列中按绝对值计算的最大负周期间差异的开始值。

语法：LargestNegativeChangeStartingValue(度量, 筛选器维度值)  
  

#### LargestNegativePercentChangeDifference

描述：给定序列中按百分比计算的最大负周期间差值。

语法：LargestNegativePercentChangeDifference(度量, 筛选器维度值)  
  

#### LargestNegativePercentChangeEndingLabel

描述：给定序列中按百分比计算的最大负期间差异的结束期间的名称。

语法：LargestNegativePercentChangeEndingLabel(度量, 筛选器维度值)  
  

#### LargestNegativePercentChangeEndingValue

描述：给定序列中按百分比计算的最大负周期间差异的结束值。

语法：LargestNegativePercentChangeEndingValue(度量, 筛选器维度值)  
  

#### LargestNegativePercentChangePercentDifference

描述：给定序列中按百分比计算的最大负周期间差异的百分比变化。

语法：LargestNegativePercentChangePercentDifference(度量, 筛选器维度值)  
  

#### LargestNegativePercentChangeStartingLabel

描述：给定序列中按百分比计算的最大负期间差异的开始期间的名称。

语法：LargestNegativePercentChangeStartingLabel(度量, 筛选器维度值)  
  

#### LargestNegativePercentChangeStartingValue

描述：给定序列中按百分比计算的最大负周期间差异的开始值。

语法：LargestNegativePercentChangeStartingValue(度量, 筛选器维度值)  
  

#### LargestPositiveChangeDifference

描述：给定序列中按绝对值计算的最大正周期间差值。

语法：LargestPositiveChangeDifference(度量, 筛选器维度值)  
  

#### LargestPositiveChangeEndingLabel

描述：给定序列中按绝对值计算的最大正期间差异的结束期间的名称。

语法：LargestPositiveChangeEndingLabel(度量, 筛选器维度值)  
  

#### LargestPositiveChangeEndingValue

描述：给定序列中按绝对值计算的最大正周期间差异的结束值。

语法：LargestPositiveChangeEndingValue(度量, 筛选器维度值)  
  

#### LargestPositiveChangePercentDifference

描述：给定序列中按绝对值计算的最大正周期间差异的百分比变化。

语法：LargestPositiveChangePercentDifference(度量, 筛选器维度值)  
  

#### LargestPositiveChangeStartingLabel

描述：给定序列中按绝对值计算的最大正期间差异的开始期间的名称。

语法：LargestPositiveChangeStartingLabel(度量, 筛选器维度值)  
  

#### LargestPositiveChangeStartingValue

描述：给定序列中按绝对值计算的最大正周期间差异的开始值。

语法：LargestPositiveChangeStartingValue(度量, 筛选器维度值)  
  

#### LargestPositivePercentChangeDifference

描述：给定序列中按百分比计算的最大正周期间差值。

语法：LargestPositivePercentChangeDifference(度量, 筛选器维度值)  
  

#### LargestPositivePercentChangeEndingLabel

描述：给定序列中按百分比计算的最大正期间差异的结束期间的名称。

语法：LargestPositivePercentChangeEndingLabel(度量, 筛选器维度值)  
  

#### LargestPositivePercentChangeEndingValue

描述：给定序列中按百分比计算的最大正周期间差异的结束值。

语法：LargestPositivePercentChangeEndingValue(度量, 筛选器维度值)  
  

#### LargestPositivePercentChangePercentDifference

描述：给定序列中按百分比计算的最大正周期间差异的百分比变化。

语法：LargestPositivePercentChangePercentDifference(度量, 筛选器维度值)  
  

#### LargestPositivePercentChangeStartingLabel

描述：给定序列中按百分比计算的最大正期间差异的开始期间的名称。

语法：LargestPositivePercentChangeStartingLabel(度量, 筛选器维度值)  
  

#### LargestPositivePercentChangeStartingValue

描述：给定序列中按百分比计算的最大正周期间差异的开始值。

语法：LargestPositivePercentChangeStartingValue(度量, 筛选器维度值)  
  

#### LongestStreakDifference

描述：给定系列的最长连续增加或减少的差异。

语法：LongestStreakDifference(度量, 筛选器维度值)  
  

#### LongestStreakDirection

描述：给定系列的最长连续增加或减少的方向（正或负）。

语法：LongestStreakDirection(度量, 筛选器维度值)  
  

#### LongestStreakEndingLabel

描述：给定系列的最长连续增加或减少的结束期间的名称。

语法：LongestStreakEndingLabel(度量, f筛选器维度值)  
  

#### LongestStreakEndingValue

描述：给定系列的最长连续增加或减少的结束值。

语法：LongestStreakEndingValue(度量, 筛选器维度值)  
  

#### LongestStreakLength

描述：给定系列连续增加或减少的最大期间数。

语法：LongestStreakLength(度量, 筛选器维度值)  
  

#### LongestStreakPercentDifference

描述：给定系列的最长连续增加或减少的百分比差异。

语法：LongestStreakPercentDifference(度量, 筛选器维度值)  
  

#### LongestStreakStartingLabel

描述：给定系列的最长连续增加或减少的开始期间的名称。

语法：LongestStreakStartingLabel(度量, 筛选器维度值)  
  

#### LongestStreakStartingValue

描述：给定系列的最长连续增加或减少的开始值。

语法：LongestStreakStartingValue(度量, 筛选器维度值)  
  

#### MaxLabel

描述：具有给定度量最大值的实体的名称。

语法：MaxLabel(维度, 度量, 筛选器维度值)  
  

#### MaxValue

描述：给定度量的最大值。

语法：MaxValue(度量)  
  

#### Median

描述：给定度量的中值。

语法：Median(维度, 度量, 筛选器维度值)  
  

#### MinLabel

描述：具有给定度量最小值的实体的名称。语法：MinLabel(维度, 度量, 筛选器维度值)  
  

#### MinValue

描述：给定度量的最小值。

语法：MinValue(维度, 度量, 筛选器维度值)  
  

#### PercentDifference

描述：两个提供的维度值之间度量值的百分比差异。

语法：PercentDifference(维度, 度量, 第一个维度值, 第二个维度值, 筛选器维度值)  
  

#### PercentOfWhole

描述：给定维度值的度量值占该维度的总度量值的百分比。

语法：PercentOfWhole(维度, 度量, 维度值, 筛选器维度值)  
  

#### PeriodLabel

描述：系列中第 n 个期间的名称，从 1 开始。

语法：PeriodLabel(索引)  
  

#### PeriodLabelNewest

描述：系列中第 n 个期间的名称，从最新开始倒数。

语法：PeriodLabelNewest(索引)  
  

#### PeriodValue

描述：给定度量在序列中第 n 个期间的值，从 1 开始。

语法：PeriodValue(度量, 索引, 筛选器维度值)  
  

#### PeriodValueNewest

描述：给定度量在系列中第 n 个期间的值，从最新开始倒数。

语法：PeriodValueNewest(度量, 索引)  
  

#### Range

描述：给定度量的最大值和最小值之间的差异。

语法：Range(维度, 度量, 筛选器维度值)  
  

#### SortAscendingLabel

描述：给定度量的实体名称，按给定等级按降序排序（从 1 开始）。

语法：SortAscendingLabel(度量, 等级, 维度, 筛选器维度值)  
  

#### SortAscendingValue

描述：给定度量的值，按给定等级按升序排序（从 1 开始）。

语法：SortAscendingValue(度量, 等级, 维度, 筛选器维度值)  
  

#### SortDescendingLabel

描述：给定度量的实体名称，按给定等级按降序排序（从 1 开始）。

语法：SortDescendingLabel(度量, 等级, 维度, 筛选器维度值)  
  

#### SortDescendingValue

描述：给定度量的值，按给定等级按降序排序（从 1 开始）。

语法：SortDescendingValue(度量, 等级, 维度, 筛选器维度值)  
  

#### StartingLabel

描述：系列中第一个期间的名称。

语法：StartingLabel()  
  

#### StartingValue

描述：给定度量的系列中第一个期间的值。

语法：StartingValue(度量, 筛选器维度值)  
  

#### StartToFinishDifference

描述：给定系列中第一个期间和最后一个期间的值之间的差异。

语法：StartToFinishDifference(度量, 筛选器维度值)  
  

#### StartToFinishPercentDifference

描述：给定系列中第一个期间和最后一个期间的值之间的百分比差异。

语法：StartToFinishPercentDifference(度量, 筛选器维度值)  
  

#### StdDev

描述：给定度量的标准偏差值。

语法：StdDev(维度, 度量, 筛选器维度值)  
  

#### Sum

描述：两个提供的维度值的度量值之和。

语法：Sum(维度, 度量, 第一个维度值, 第二个维度值, 筛选器维度值)  
  

#### Total

描述：给定度量的值总和。

语法：Total(维度, 度量, 筛选器维度值)  
  

#### Value

描述：给定维度、度量和维度值的指标值。

语法：Value(维度, 度量, 维度值, 筛选器维度值)  
  

#### Z-Score

描述：给定度量的 z 分数。

语法：Z-Score(维度, 度量, 第一个维度值, 筛选器值)