函数列表

Looker Studio 提供了许多强大的函数，可在计算字段公式中使用。

如需详细了解每个函数（包括示例），请使用公式编辑器。当您开始输入公式时，系统会显示此帮助。

名称 类型 说明 语法
ABS 算术 返回数字的绝对值。了解详情。 ABS(X)
ACOS 算术 返回 X 的余弦的倒数。了解详情。 ACOS(X)
APPROX_COUNT_DISTINCT 聚合 返回 X 的近似唯一值数量。了解详情 APPROX_COUNT_DISTINCT(X)
ASIN 算术 返回 X 的正弦的倒数。了解详情。 ASIN(X)
ATAN 算术 返回 X 的正切的倒数。了解详情。 ATAN(X)
AVG 聚合 返回 X 的所有值的平均值。了解详情。 AVG(X)
CASE（简单） 基于条件 将 input_expression 与每个连续 WHEN 子句的 expression_to_match 进行比较，并在该比较运算返回 true 的情况下返回第一个 result。了解详情 

CASE input_expression
    WHEN expression_to_match THEN result
    [WHEN expression_to_match THEN result]
    [...]
    [ELSE result]
END
CASE 基于条件 计算每个连续 WHEN 子句的 condition，并在 condition 为 true 的情况下返回第一个 result；其余所有 WHEN 和 ELSE 子句均不进行计算。如果所有条件均为 false 或 NULL，则返回 else_result（如果有）；如果没有，则返回 NULL。了解详情 

CASE
    WHEN condition THEN result
    [WHEN condition THEN result]
    [...]
    [ELSE else_result]
END
CAST 其他 将字段或表达式转换为 TYPE。不允许在 CAST 中使用汇总字段。TYPE 可以是 NUMBER、TEXT 或 DATETIME。了解详情。 CAST(field_expression AS TYPE)
CEIL 算术 返回大于 X 的最接近整数。例如，如果 X 的值为 v，则 CEIL(X) 大于或等于 v。了解详情。 CEIL(X)
COALESCE 基于条件 返回在字段列表中找到的第一个非缺失值。了解详情。 COALESCE(field_expression[,field_expression, ...])
CONCAT 文本 返回 X 和 Y 的级联文本。了解详情。 CONCAT(X, Y)
CONTAINS_TEXT 文本 如果 X 包含文本，则返回 true，否则返回 false。区分大小写。了解详情。 CONTAINS_TEXT(X, text)
COS 算术 返回 X 的余弦值。了解详情。 COS(X)
COUNT 聚合 返回 X 的值的数量。了解详情。 COUNT(X)
COUNT_DISTINCT 聚合 返回 X 的唯一值数量。了解详情。 COUNT_DISTINCT(X)
CURRENT_DATE 日期 返回指定或默认时区的当前日期。 了解详情。 CURRENT_DATE([time_zone])
CURRENT_DATETIME 日期 返回指定或默认时区的当前日期和时间。了解详情。 CURRENT_DATETIME([time_zone])
DATE 日期 使用数字或日期和时间字段或表达式构造日期字段或值。了解详情。 DATE(year, month, day)
DATE_DIFF 日期 返回 X 和 Y 之间的天数差（X - Y）。了解详情。 DATE_DIFF(X, Y)
DATE_FROM_UNIX_DATE 日期 将整数解释为从 1970-01-01 算起的天数。了解详情。 DATE_FROM_UNIX_DATE(integer)
DATETIME 日期 使用数字构造日期和时间字段或值。了解详情。 DATETIME(year, month, day, hour, minute, second)
DATETIME_ADD 日期 将指定的时间间隔添加到日期。了解详情。 DATETIME_ADD(datetime_expression, INTERVAL integer part)
DATETIME_DIFF 日期 返回两个日期之间的部分边界值数量。了解详情。 DATETIME_DIFF(date_expression, date_expression, part)
DATETIME_SUB 日期 从日期中减去指定的时间间隔。了解详情。 DATETIME_SUB(datetime_expression, INTERVAL integer part)
DATETIME_TRUNC 日期 将日期截断至指定的粒度。了解详情。 DATETIME_TRUNC(date_expression, part)
DAY 日期 返回日期或日期和时间的日期部分。了解详情。 Day(date_expression)
ENDS_WITH 文本 如果 X 以文本结尾，则返回 true，否则返回 false。区分大小写。了解详情。 ENDS_WITH(X, text)
EXTRACT 日期 返回日期或日期和时间的部分内容。了解详情。 EXTRACT(part FROM date_expression)
FLOOR 算术 返回小于 X 的最接近的整数。例如，如果值 X 为 v，则 FLOOR(X) 等于或小于 v。了解详情。 FLOOR(X)
FORMAT_DATETIME 日期 返回一个带格式的日期字符串。了解详情。 FORMAT_DATETIME(format_string, datetime_expression)
HOUR 日期 返回日期和时间的小时。了解详情。 HOUR(datetime_expression)
HYPERLINK 其他 返回指向网址的超链接，并带有链接标签。了解详情。 HYPERLINK(URL, link label)
IF 基于条件 如果 condition 为 true，则返回 true_result，否则返回 false_result。如果 condition 为 true，则不计算 false_result。如果 condition 为 false 或 NULL，则不计算 true_result。了解详情 IF(condition, true_result, false_result)
IMAGE 其他 在数据源中创建“图片”字段。了解详情。 IMAGE(Image URL, [Alternative Text])
LEFT_TEXT 文本 返回 X 开头的若干个字符。字符数由 length 指定。了解详情。 LEFT_TEXT(X, length)
LENGTH 文本 返回 X 中的字符数。了解详情。 LENGTH(X)
LOG 算术 返回 X 以 2 为底的对数。了解详情。 LOG(X)
LOG10 算术 返回 X 以 10 为底的对数。了解详情。 LOG10(X)
LOWER 文本 将 X 转换为小写形式。了解详情。 LOWER(X)
MAX 聚合 返回 X 的最大值。了解详情。 MAX(X)
MEDIAN 聚合 返回 X 的所有值的中位数。了解详情。 MEDIAN(X)
MIN 聚合 返回 X 的最小值。了解详情。 MIN(X)
MINUTE 日期 返回给定日期和时间的分钟部分。了解详情。 MINUTE(datetime_expression)
月 日期 返回日期和时间值中的月份。了解详情。 MONTH(date_expression)
NARY_MAX 算术 返回 X、Y、[,Z]* 的最大值。所有输入参数都必须是同一类型：全部为数字。至少有一个输入参数必须是字段或包含字段的表达式。了解详情。 NARY_MAX(X, Y [,Z]*)
NARY_MIN 算术 返回 X、Y、[,Z]* 的最小值。所有输入参数都必须是同一类型（全部为数字）。至少有一个输入参数必须是字段或包含字段的表达式。了解详情。 NARY_MIN(X, Y [,Z]*)
NATIVE_DIMENSION 其他 返回由底层数据集求值的 SQL 表达式的结果。表达式不能包含任何汇总。了解详情。 NATIVE_DIMENSION("JSON_VALUE('{"name": "Dana"}', '$.name')","STRING")
NULLIF 基于条件 如果输入与表达式匹配，则返回 null，否则返回输入。了解详情。 NULLIF(input_expression, expression_to_match)
PARSE_DATE 日期 将文字转换为日期。了解详情。 PARSE_DATE(format_string, text)
PARSE_DATETIME 日期 将文本转换为包含时间的日期。了解详情。 PARSE_DATETIME(format_string, text)
PERCENTILE 聚合 返回字段 X 的百分位排名 N。了解详情。 PERCENTILE(X,N)
POWER 算术 返回 X 的 Y 次幂的结果。了解详情。 POWER(X, Y)
QUARTER 日期 返回给定日期所在的一年中的第几季度。了解详情。 QUARTER(date_expression)
REGEXP_CONTAINS 文本 如果 X 包含正则表达式模式，则返回 true，否则返回 false。了解详情。 REGEXP_CONTAINS(X, regular_expression)
REGEXP_EXTRACT 文本 返回 X 中与正则表达式模式匹配的第一个子字符串。了解详情。 REGEXP_EXTRACT(X, regular_expression)
REGEXP_MATCH 文本 如果 X 与正则表达式模式匹配，则返回 true，否则返回 false。了解详情。 REGEXP_MATCH(X, regular_expression)
REGEXP_REPLACE 文本 将 X 中与正则表达式模式匹配的所有文本替换为 replacement 字符串。了解详情。 REGEXP_REPLACE(X, regular_expression, replacement)
替换 文本 返回 X 的副本，其中 X 中出现的所有 Y 都替换为 Z。了解详情。 REPLACE(X, Y, Z)
RIGHT_TEXT 文本 返回 X 末尾的一些字符。字符数由 length 指定。了解详情。 RIGHT_TEXT(X, length)
ROUND 算术 返回四舍五入到 Y 位小数精度的 X。了解详情。 ROUND(X, Y)
SECOND 日期 返回给定日期和时间的秒数部分。了解详情。 SECOND(datetime_expression)
SIN 算术 返回 X 的正弦值。了解详情。 SIN(X)
SQRT 算术 返回 X 的平方根。请注意，X 必须为非负数。了解详情。 SQRT(X)
STARTS_WITH 文本 如果 X 以文本开头，则返回 true。否则，返回 false。区分大小写。了解详情。 STARTS_WITH(X, text)
STDDEV 聚合 返回 X 的标准差。了解详情。 STDDEV(X)
SUBSTR 文本 返回 X 的子字符串文本。子字符串从 start index 开始，长度为 length 个字符。了解详情。 SUBSTR(X, start index, length)
SUM 聚合 返回 X 的所有值的总和。了解详情。 SUM(X)
TAN 算术 返回 X 的正切值。了解详情。 TAN(X)
TOCITY 地理位置 返回 X 的城市名称。 TOCITY(X [,Input Format])
TOCONTINENT 地理位置 返回 X 所在的大陆名称。了解详情。 TOCONTINENT(X [,Input Format])
TOCOUNTRY 地理位置 返回 X 的国家/地区名称。了解详情。 TOCOUNTRY(X [,Input Format])
TODATE 日期 返回带格式的兼容模式日期。了解详情。 TODATE(X, Input Format, Output Format)
今天 日期 返回指定或默认时区的当前日期。 了解详情。 TODAY([time_zone])
TOREGION 地理位置 返回 X 的区域名称。了解详情。 TOREGION(X [,Input Format])
TOSUBCONTINENT 地理位置 返回 X 的次大陆名称。了解详情。 TOSUBCONTINENT(X [,Input Format])
TRIM 文本 返回移除了前导和尾随空格的 X。了解详情。 TRIM(X)
UNIX_DATE 日期 返回从 1970-01-01 开始计算的天数。了解详情。 UNIX_DATE(date_expression)
UPPER 文本 将 X 转换为大写。了解详情。 UPPER(X)
VARIANCE 聚合 返回 X 的方差。了解详情。 VARIANCE(X)
周 日期 返回给定日期所在的一周。了解详情。 WEEK(Date)
WEEKDAY 日期 返回一个数字，表示给定日期所在的星期几。了解详情。 WEEKDAY(Date)
YEAR 日期 返回给定日期的年份。了解详情。 YEAR(Date)
YEARWEEK 日期 返回给定日期所在的年份和周数。了解详情。 YEARWEEK(Date)