Suite | Professional, Enterprise, or Enterprise Plus |
Support with | Explore Professional or Enterprise |
在开始创建自己的自定义指标和属性时,您需要经常使用函数来帮助您对业务信息进行比较、计算和操作。
Explore 提供了许多函数,可以帮助您处理日期、文本字符串、计算等内容。请参照本文章了解可用的功能及其使用方法。
本文章包含以下主题:
入门
在创建标准计算指标或属性时,您可以浏览并选择函数。在公式编辑窗口中,开始时您可以输入函数名称,也可以单击函数下的添加,然后从列表中选择函数。
当函数添加到公式时,它将显示标准值。您必须将这些值替换为要在公式中使用的值。本例中仅返回标题行以“[Flagged]”开头的工单。
- 在计算菜单 (
) 中,单击标准计算属性。
- 为您的计算属性命名。本例使用以 [Flagged] 开头的标题。
- 在函数下,单击添加。
- 在公式窗口中,输入 IF 。
- 在函数下,单击添加。
- 搜索 LEFTPART。使用搜索框,单击筛选将值的范围缩小到文本类别,或滚动列表直到找到所需的函数。
- 单击 LEFTPART 旁边的 +。
- 随即会出现公式 IF LEFTPART(_text,_number)。将 _text 参数更改为工单标题属性。突出显示 _text,然后在字段菜单中选择工单标题,或手动修改公式以添加属性。
公式现在为 IF LEFTPART([Ticket subject],_number)
- 将 text_number 更改为您要比较的字符数。[Flagged] 有九个字符,因此输入 9。
公式现在为 IF LEFTPART([Ticket subject],9)
- 最后,添加要搜索的条件(本例中为文本“[Flagged]”)。最终公式为:
IF LEFTPART([Ticket subject],9)="Flagged" THEN [TicketID] ENDIF
现在,当您在报告中使用此属性时,它将仅返回标题行以“[Flagged]”开头的工单。
如需更多帮助和范例,请参阅编写 Explore 公式。
基本数学运算符
除了上述函数之外,您还可以使用以下基本数学运算符,以进行计算和连接文本:
运算符 | 描述 |
+ | 将两个数值相加,或将两个文本字符串连在一起。 |
- | 将一个值减去另一个值。 |
* | 将两个值相乘 |
/ | 将一个值除以另一个值 |
= | 测试一个值是否等于另一个值 |
!= | 测试一个值是否不等于另一个值 |
> |
测试前一个值是否大于后一个值 (x>y) |
< |
测试前一个值是否小于后一个值(x<y) |
>= |
测试前一个值是否大于或等于后一个值 (x>=y) |
<= |
测试前一个值是否小于或等于后一个值 (x<=y) |
% | 计算一个值除以另一个值所得的模(或余数)。 例如:5%2 返回 1,20%3 返回 2 |
逻辑函数
这些功能为您以所需方式分析和显示信息带来了极大的灵活性。
函数 | 描述 |
IF THEN ELSE 条件表达式 | 用于评估逻辑值。 格式:IF(条件) THEN(true 时的值) ELSE(false 时的值) ENDIF 有关此函数的详细信息,请参阅使用 IF THEN ELSE 函数。 |
AND | 如果提供的两个表达式都为 TRUE,则返回 TRUE。 例如: IF ([Ticket channel]="Email") AND ([Submitter email]="fred@fredco.com") THEN [Ticket ID] ENDIF 会返回通过电邮收到的所有来自 fred@freedco.com 的工单。 |
OR | 如果提供的表达式中至少有一个为 TRUE,则返回 TRUE。 例如: IF ([Ticket channel]="Email") OR ([Ticket channel]="Voice") THEN [Ticket ID] ENDIF 会返回通过电邮或语音渠道收到的所有工单。 |
NOT | 与提供的表达式的逻辑值相反。 例如: IF NOT([Ticket channel]="Email") THEN [Ticket ID] ENDIF 会返回所有非通过电邮渠道收到的工单。 |
TRUE | 会返回逻辑值“TRUE”。 |
FALSE | 会返回逻辑值“FALSE”。 |
IN(_param,_array) | 如果输入的第一个参数属于第二个参数指定的范围,则返回 TRUE。 例如: IN(200,ARRAY(100,200,300,400)) 会返回 TRUE IN(250,ARRAY(20,40,60,80)) 会返回 FALSE |
SWITCH 条件表达式 | SWITCH 为具有多个分支的 IF THEN ELSE 语句提供了一个更易于理解的替代方案。 SWITCH (_tested_element) { CASE _value1: _return_value CASE _value2: _return_value DEFAULT: _default_return_value } 有关此函数的详细信息,请参阅使用 SWITCH 添加多个条件表达式。 |
属性函数
这些函数使您可以进行基本操作,以量化您的报告返回的属性数量。您还可以进行更高级的操作,以“锁定”或扩展计算的聚合级别。
函数 | 描述 |
COUNT_VALUES(_attribute) | 统计提供的属性值的数量,包括重复的值。可用作计算属性和指标中的条件,但不能用于计算指标的 THEN 子句。 例如:IF COUNT_VALUES([Ticket ID])>30 THEN 1 ELSE 0 ENDIF 当有超过 30 个工单时,上面的例子会返回 1,当工单少于 30 个时,会返回 0。
提示:如果您要创建一个统计属性值数量的指标,指标公式应为 [Attribute]。然后可以照常应用 COUNT 聚合器。
|
DCOUNT_VALUES(_attribute) | 统计所提供属性的不同值的不同数量。可用作计算属性和指标中的条件,但不能用于计算指标的 THEN 子句。 例如:IF COUNT_VALUES([Organization name])>100 THEN 1 ELSE 0 ENDIF 当有超过 100 个不同的组织时,上面的例子会返回 1,当组织少于 100 个时,会返回 0。
提示:如果您要创建一个统计属性不同值的数量的指标,指标公式应为 [Attribute]。然后可以照常应用 D_COUNT 聚合器。
|
ATTRIBUTE_FIX(aggregator(metric name), attribute1, attribute2) |
返回按您指定的属性(本例中为 attribute1 和 attribute2)聚合的聚合器(指标名称)的值。其他属性均不影响此指标的结果。 计算属性不能用于 ATTRIBUTE_FIX 函数。 例如: ATTRIBUTE_FIX(MED(First Reply Time (min), [Ticket created - Year], [Ticket created - Month]) 有关更多帮助和范例,请参阅使用聚合级别函数。 |
ATTRIBUTE_ADD(aggregator(metric name), attribute1, attribute2) |
返回聚合到报告中所有属性(不仅 attribute1 和 attribute2)的聚合器(指标名称)的值。 计算属性不能用于 ATTRIBUTE_ADD 函数。 例如: ATTRIBUTE_ADD(MED(First Reply Time (min), [Ticket created - Year], [Ticket created - Month]) 有关更多帮助和范例,请参阅使用聚合级别函数。 |
标签函数
此类函数可帮助您搜索是否存在标签,包括工单标签、通话标签或任何其他使用标签的内容。
函数 | 描述 |
INCLUDES_ALL([tag attribute], "tag1", "tag2") | 如果所有指定的工单标签都包含在工单标签属性中,则返回 TRUE。 例如: 如果工单包含标签“London”和“Milan”,则 INCLUDES_ALL([Ticket tags], "London", "Milan") 返回 TRUE。 如果工单不是同时包含标签“London”和“Milan”,则 NOT INCLUDES_ALL ([Ticket tags], "London", "Milan") 返回 TRUE。 有关如何使用此函数的更多示例,请参阅用标签报告。 |
INCLUDES_ANY([tag attribute], "tag1", "tag2") | 如果任何指定的标签包含在标签属性中,则返回 TRUE。 例如: 如果工单包含标签“London”或“Milan”,则 INCLUDES_ANY([Ticket tags], "London", "Milan") 返回 TRUE。 如果工单既不包含标签“London”也不包含“Milan”,则 NOT INCLUDES_ANY ([Ticket tags], "London", "Milan") 返回 TRUE。 有关如何使用此函数的更多示例,请参阅用标签报告。 |
文本函数
这些函数使您可以执行搜索和评估文本的操作。您还可以使用自己创建的公式和模式修改文本。
有关如何使用其中一些文本函数(如 CONTAINS、LEFTPART、SUBSTR、FIND 和 LENGTH)的示例,请参阅 Explore 配方:报告嵌套的下拉字段。
函数 | 描述 |
CONTAINS(_text,_text_to_search) | 如果第一个输入的参数包含第二个子字符串,则返回 TRUE。 例如:CONTAINS([Submitter name],"Sally")
|
ENDSWITH(_text,_text_to_search) | 如果提供的第一个文本以提供的第二个文本结尾,则返回 TRUE。 例如: ENDSWITH([US State],"ippi") 对 Mississippi 返回 TRUE,但是对 Delaware 返回 FALSE。 |
FIND(_text,_text_to_find,_number_start_index) |
返回第二个输入文本的第一个实例在第一个输入文本中的索引,从输入的起始索引开始。如果找不到第二个输入文本,返回 -1。字符串的第一个字符的索引为 0。 例如: 如果 [Ship Mode]="Urgent",则 FIND([ShipMode","Norm",0) 返回 -1 如果 [Ship Mode]="Normal",则 FIND([ShipMode","ma",0) 返回 3 如果 [Ship Mode]="Urgent",则 FIND([ShipMode","ge",2) 返回 0 |
LEFTPART(_text,_number) | 返回所提供文本中最左边的 _number 个字符。 例如: 如果 [Department]="Technical documentation",则 LEFTPART([Department],9) 返回“Technical” |
LENGTH(_text) | 返回所提供文本的长度(字符数)。 例如: LENGTH([Product category]) 返回产品类别属性每个值的长度。 |
LOWERCASE(_text) | 转换并返回提供的小写文本。 |
LTRIM(_text) | 返回提供的属性值,删除左侧的所有空格。 例如:如果 [Name] 是“ Peter ”,LTRIM([Name]) 将返回“Peter ” |
REPLACE(_text,_text_to_replace,_text_to_replace_with) | 返回 _text 的副本,其中 _text_to_replace 的所有实例都已替换为 _text_to_replace_with。 例如: 如果 [US State]="new York",则 REPLACE([US State],"n","N") 返回“New York” |
RIGHTPART(_text,_number) | 返回所提供文本中最右边的 _number 个字符。 例如: 如果 [Department]="Technical documentation",则 RIGHTPART([Department],13) 返回“documentation” |
RTRIM(_text) | 返回提供的属性值,删除右侧的所有空格。 例如:如果 [Name] 是“ Peter ”,TRIM([Name]) 将返回“ Peter” |
STARTSWITH(_text,_text_to_search) | 如果提供的第一个文本以提供的第二个文本开头,则返回 TRUE。 例如: STARTSWITH([US State],"Miss") 对 Mississippi 返回 TRUE,但对 Delaware 返回 FALSE。 |
IS_POSITIVE(_text) | 根据对文本的分析,对于肯定返回 TRUE,对于否定返回 FALSE。 |
SUBSTR(_text,_number_start_index,_number_end_index) |
返回 _text 的一部分,由起始索引指定的字符(输入的第一个整数)和结束索引(输入的第二个整数)之前的所有字符组成。 例如:SUBSTR("Web marketing",0,3) 返回“Web” |
TRIM(_text) | 返回提供的属性值,移除左侧或右侧的所有空格。 例如:如果 [Name] 是“ Peter ”,TRIM([Name]) 将返回“Peter”。 |
UPPERCASE(_text) | 转换并返回提供的大写文本。 |
STRING(_number) | 将提供的数字转换为字符串。 |
LPAD(_text,_length,_pad) | 在 _text 的左边用 _pad 填充文本,直到字符串长度达到 _length 为止。 例如: LPAD("1",7,"?") 会返回 “??????1” |
RPAD(_text,_length,_pad) | 在 _text 的右边用 _pad 填充文本,直到字符串长度达到 _length 为止。 例如: RPAD("1",7,"?") 会返回“1??????” |
LINK(_url,_label) | 返回指向所提供 URL 的 HTML 链接。 例如,请参阅 Explore 配方:配置工单的可点击链接。 |
正则表达式函数
正则表达式是定义搜索模式的字符序列。Explore 支持使用正则表达式在公式中完成以下计算:
函数 | 描述 |
REGEXP_MATCH(_text,_regexp) | 如果文本与正则表达式匹配,则返回 True。 |
REGEXP_EXTRACT(_text,_regexp) | 返回与正则表达式中的捕获组匹配的文本部分有关如何使用此功能的示例,请参阅可以在 Explore 中报告用户电邮域名吗? |
REGEXP_REPLACE(_text,_regexp,_replace_text) | 返回一个字符串,其中任何与正则表达式匹配的文本子字符串都将替换为 replace_text。 例如:REGEXP_REPLACE("Hello","lo","p") 会返回“Help” |
有关正则表达式的更多信息,请参阅本 Wikipedia 页面。
日期函数
Explore 允许您创建、比较日期和时间,并进行计算。这些函数特别有用,可以帮助您在检查选定日期范围内的公司信息时节省大量时间。
函数 | 描述 |
DATE(_text) | 将提供的文本转换为带有 UTC 时间戳的日期。所输入的文本可以有多种格式,但必须至少包括月、日、年。 例如:
|
DATE_EQUAL(_date,_date) | 如果两个输入的日期相同,则返回 TRUE。 例如:IF DATE_EQUAL([Ticket Created - Month],[Ticket Solved - Month]) THEN [Ticket ID] ENDIF 返回所有在创建当月得到解决的工单。此示例不包含年份,因此将返回 2018 年 6 月创建并在 2020 年 6 月解决的工单。 |
DATE_NOT_EQUAL(_date,_date) | 如果输入的两个日期不相同,则返回 TRUE。 例如:IF DATE_EQUAL([Ticket Created - Month],[Ticket Solved - Month]) THEN [Ticket ID] ENDIF 返回所有在创建当月未得到解决的工单。 |
DATE_LESS(_date,_date) | 如果第一个日期早于第二个日期,则返回 TRUE。 例如:IF DATE_LESS([Ticket Assigned - Date],[Ticket Due - Date - Date]) THEN [Ticket ID] ENDIF 返回在到期日期之前分配的所有工单。 |
DATE_LESS_OR_EQUAL(_date,_date) | 如果第一个日期晚于第二个日期或与之相同,则返回 TRUE。 例如:IF DATE_LESS_OR_EQUAL([Ticket Assigned - Date],[Ticket Due - Date - Date]) THEN [Ticket ID] ENDIF 返回在到期日期之前或当天分配的所有工单。 |
DATE_GREATER(_date,_date) | 如果第一个日期晚于第二个日期,则返回 TRUE。 例如:IF DATE_GREATER([Ticket Assigned - Date],[Ticket Due - Date - Date]) THEN [Ticket ID] ENDIF 返回在到期日期之后分配的所有工单。 |
DATE_GREATER_OR_EQUAL(_date,_date) | 如果第一个日期晚于第二个日期或与之相同,则返回 TRUE。 例如:IF DATE_GREATER_OR_EQUAL([Ticket Assigned - Date],[Ticket Due - Date - Date]) THEN [Ticket ID] ENDIF 返回在到期日期当天或之后分配的所有工单。 |
DATE_ADD(_date,_date_part,_increment) |
返回用户时区的给定日期,按输入的增量更新。例如,_date_part 参数可以是“year”、“quarter”、“month”、“day”、“hour”等。输入的增量必须是整数值,但可以为负数。 |
DATE_DIFF(_date,_date,_date_part) | 以您选择的格式返回两个日期之间的相对差或精确差。 在函数中,_date_part 可以是以下值之一: 对于相对差(整数):
对于精确值:
例如: DATE_DIFF("2011/10/22","2008/01/06","year") 返回 3 (2011-2008) DATE_DIFF("2011/10/22","2008/01/06","nb_of_years") 返回 4 (实际年数) DATE_DIFF("2019/03/06","2017/03/05","day") 返回 1 DATE_DIFF("2019/03/06","2017/03/05","nb_of_days") 返回 731 仅使用一个自定义时间戳。如果尝试使用两个,则不会返回结果。 |
DATE_FORMAT(_date,_format) | 以所提供的格式返回输入的用户时区日期。 有关您可以使用的格式列表,请参阅日期格式。 |
TODAY() | 返回用户时区的当前日期。 |
NOW() | 返回用户时区的当前日期和时间(以小时、分钟和秒为单位)。 |
CURRENT_YEAR() | 返回当前年份。 |
CURRENT_HALFYEAR() | 返回当前半年,以“H1”或“H2”表示 |
CURRENT_QUARTER() | 返回当前季度,以“Q1”、“Q2”、“Q3”或“Q4”表示 |
CURRENT_MONTH() | 返回当前月份,例如“一月”、“二月”。 |
CURRENT_MONTH_NUMERIC() | 返回当前月份,以数字表示,例如“1”表示一月,“2”表示二月。 |
CURRENT_DAY() | 返回当前日期,以数字表示。 |
CURRENT_WEEKDAY() | 返回当前周内日期,以文本表示,例如“星期一”、“星期二”。 |
CURRENT_WEEKDAY_NUMERIC() | 返回当前周内日期,以数字表示,例如“0”表示星期日,“1”表示星期一。 |
CURRENT_HOUR() | 返回用户时区的当前小时,以数字表示。 |
CURRENT_MINUTE() | 返回用户时区的当前分钟,以数字表示。 |
CURRENT_SECOND() | 返回用户时区的当前秒数,以数字表示。 |
YEAR(_date) | 返回提供的日期所在的年份。 |
MONTH(_date) | 返回提供的日期所在的月份,以文本表示,例如“一月”、“二月” |
MONTH_NUMERIC(_日期) | 返回提供的日期所在的月份,以数字表示,例如“1”表示一月,“2”表示二月。 |
DAY(_日期) | 返回所提供日期的日期 |
WEEKDAY(_日期) | 返回所提供日期的周内日期,以字符串表示,例如“星期一”、“星期二”。 |
WEEKDAY_NUMERIC(_date) | 返回所提供日期的周内日期,以数字表示,例如“1”表示星期日,“2”表示星期一。 |
HOURS(_date) | 返回所提供日期的小时。 |
MINUTES(_date) | 返回所提供日期的分钟。 |
SECONDS(_date) | 返回所提供日期的秒数。 |
WEEK_NUMBER(_date) | 返回提供的日期所在的周数。请参阅了解每周开始日期对周数有何影响。 |
WEEK_NUMBER_MONDAY(_date) | 返回提供的日期所在的周数(每周从星期一开始计算)。 |
WEEK_NUMBER_FRIDAY(_date) | 返回提供的日期所在的周数(每周从星期五开始计算)。 |
WEEK_NUMBER_SATURDAY(_date) | 返回提供的日期所在的周数(每周从星期六开始计算)。 |
WEEK_NUMBER_SUNDAY(_date) | 返回提供的日期所在的周数(每周从星期日开始计算)。 |
START_OF_QUARTER(_date) | 返回提供的日期所在季度的开始日期。 |
END_OF_QUARTER(_date) | 返回提供的日期所在季度的结束日期。 |
START_OF_MONTH(_date) | 返回提供的日期所在月份的开始日期。 |
END_OF_MONTH(_date) | 返回提供的日期所在月份的结束日期。 |
START_OF_WEEK(_date) | 返回提供的日期所在周的开始日期。请参阅设置报告和筛选的每周开始日期。 |
END_OF_WEEK(_date) | 返回提供的日期所在周的结束日期。请参阅设置报告和筛选的每周开始日期。 |
START_OF_WEEK_MONDAY(_date) | 返回提供的日期所在周(每周从星期一开始计算)的开始日期。 |
END_OF_WEEK_MONDAY(_date) | 返回提供的日期所在周(每周从星期一开始计算)的结束日期。 |
START_OF_WEEK_FRIDAY(_date) | 返回提供的日期所在周(每周从星期五开始计算)的开始日期。 |
END_OF_WEEK_FRIDAY(_date) | 返回提供的日期所在周(每周从星期五开始计算)的结束日期。 |
START_OF_WEEK_SATURDAY(_date) | 返回提供的日期所在周(每周从星期六开始计算)的开始日期。 |
END_OF_WEEK_SATURDAY(_date) | 返回提供的日期所在周(每周从星期六开始计算)的结束日期。 |
START_OF_WEEK_SUNDAY(_date) | 返回提供的日期所在周(每周从星期日开始计算)的开始日期。 |
END_OF_WEEK_SUNDAY(_date) | 返回提供的日期所在周(每周从星期日开始计算)的结束日期。 |
DATE_FROM_ISO | 如果参数是 ISO 标准时间戳字符串,则返回时间戳。假设时间戳带有时区,但可以通过将可选的 skip-timezone 参数设置为 TRUE 来解析没有时区信息的时间戳。 例如: DATE_FROM_ISO("2020-07-24T13:42:00Z") DATE_FROM_ISO("2020-07-24T13:42EST") DATE_FROM_ISO("2020-07-24T13:42+05") DATE_FROM_ISO("2020-07-24T13:42," TRUE) |
DATE_FROM_TIMESTAMP(_timestamp) | 返回提供的 UNIX 时间戳(秒)转换的日期。 |
DATE_FROM_MILLI_TIMESTAMP(_timestamp) | 返回提供的 UNIX 时间戳(毫秒)转换的日期。 |
DATE_TO_TIMESTAMP(_date) | 返回所提供日期转换的 UNIX 时间戳(用户时区)。 |
DATE_TO_MILLI_TIMESTAMP(_date) | 返回提供的日期转换的 UNIX 时间戳(毫秒)。 |
SECONDS_TO_TIME(_time) | 将秒数转换为 HH:MM:SS 格式。 |
FISCAL_YEAR(_date,_start_month) | 根据提供的日期和开始月份返回财务年度。month 参数必须是月份的全名(例如“February”,而不是“Feb”)。 |
FISCAL_QUARTER(_date,_start_month) | 根据提供的日期和开始月份返回财务季度。month 参数必须是月份的全名(例如“February”,而不是“Feb”)。 |
FISCAL_WEEK_NUMBER(_date,_start_month) | 根据提供的日期和开始月份返回财务周数。month 参数必须是月份的全名(例如“February”,而不是“Feb”)。 |
WEEKYEAR(_date) | 返回提供的日期所在周的年份。 |
DATE_FIRST(time attribute) |
根据已添加到报告中并受所有已应用筛选影响的属性,返回最早的日期或时间戳。 例如:DATE_FIRST([Update - Timestamp]) 返回您添加到报告中的所有属性的最早更新时间戳。 有关更多帮助和范例,请参阅使用最早和最晚日期函数。 |
DATE_LAST(time attribute) |
根据已添加到报告中并受所有已应用筛选影响的属性,返回最晚的日期或时间戳。 例如:DATE_LAST([Update - Timestamp]) 返回您添加到报告中的所有属性的最晚更新时间戳。 有关更多帮助和范例,请参阅使用最早和最晚日期函数。 |
DATE_FIRST_FIX(time attribute, attribute1, attribute2, ...) |
根据函数中指定的属性,返回最早日期或时间戳。添加到报告中的属性不会影响计算,但应用的任何筛选都会被考虑在内。 例如:DATE_FIRST_FIX([Update - Timestamp], [Update ticket ID]) 返回工单的最早更新时间戳,无论报告中的属性如何。 有关更多帮助和范例,请参阅使用最早和最晚日期函数。 |
DATE_LAST_FIX(time attribute, attribute1, attribute2, ...) |
根据函数中指定的属性,返回最晚日期或时间戳。添加到报告中的属性不会影响计算,但应用的任何筛选都会被考虑在内。 例如: DATE_LAST_FIX([Update - Timestamp], [Update ticket ID]) 返回工单的最晚更新时间戳,无论报告中的属性如何。 有关更多帮助和范例,请参阅使用最早和最晚日期函数。 |
设置日期格式
DATE_FORMAT 函数可以将完整的时间戳呈现为不同类型的日期。每种格式都用一个不同的字母表示。您需要在 DATE_FORMAT 函数的格式部分输入相关字母。输入字母时必须用双引号括起来。您可以组合日期或时间组件,以显示关于日期的更多信息。
例如,要将 Ticket created - Timestamp 属性的默认格式 (2015-01-27T13:21:10) 更改为美式格式 (Jan 27, 2015 01:21 PM),请使用以下公式:
DATE_FORMAT([Ticket created - Timestamp],"Mon DD, YYYY hh:MI AM")
下表显示了您可以使用的格式。以时间戳 2017-11-03T15:18:25 为例。
日期或时间组件 | 字母 | 示例 2017-11-03T15:18:25 |
年 | YYYY | 2017 |
年 | YY | 17 |
季度 | Q | Q4 |
月份 | MM | 11 |
月份名称 | Mon | 11 月 |
月份名称 | Month | 11 月 |
一年中的第几周 (1–53) | WW | 44 |
一个月中的第几周 (1-5) | W | 1 |
一年中的第几天 (01-366) | DDD | 307 |
一个月中的天数 (01-31) | DD | 3 |
星期几 | Day | 星期五 |
星期几 | Dy | 星期五 |
24 小时制时数 (01-12) | hh | 3 |
24 小时制时数 (1-23) | HH | 15 |
分钟 | MI | 18 |
秒 | SS | 25 |
毫秒 (000-999) | MS | 0 |
正午指示器(AM 或 PM) | AM | PM |
数值函数
这些函数用于对报告中的信息进行各种数学计算。
函数 | 描述 |
ABS(_number) | 返回所提供数字的绝对值。
例如: 1 的绝对值为 1 -7.3 的绝对值为 7.3 |
BETWEEN(_number,_number,_number) | 如果提供的第一个数字介于其它两个数字之间,则返回 TRUE。 例如: 如果 SUM(Profit) 等于或介于 500 和 1500 之间,则 BETWEEN(SUM(Profit),500,1500) 返回 TRUE。 |
CEIL(_number) | 返回所提供数字的上取整数。数字的上取整数是大于等于该数字且与之最接近的整数。 例如: 125.4 的上取整数为 126 -63.2 的上取整数为 -63 CEILING(SUM(First resolution time (min))) 返回大于属性中存储的每个首次解决时间且与之最接近的整数。 |
EXP(_number) | 返回自然对数的底数 (e) 的所提供指数次方的值。 例如: EXP(SUM(Unit price)) 返回 SUM (Unit price) 指标每个值的自然对数。 |
FLOOR(_number) | 返回所提供字的下取整数。数字的下取整数是小于等于该数字且与之最接近的整数。 例如: 125.4 的下取整数为 125 -63.2 的下取整数为 -64 FLOOR(SUM(First resolution time (min))) 返回小于属性中存储的每个首次解决时间且与之最接近的整数。 |
INTEGER(_param) | 返回提供的非整数数字的整数部分。 例如: INTEGER(1.56) 返回 1 |
IS_NUMBER(_param) | 如果给定参数是数字(整数或小数),则返回 TRUE,否则返回 FALSE。 例如:
|
MAXIMUM(_number,_number) | 返回提供的两个参数中的最大值。 MAXIMUM(SUM(Revenues),SUM(Expenses)) 返回收入和费用中的较大值。 |
MINIMUM(_number,_number) | 返回提供的两个参数中的最小值。 MINIMUM(SUM(Revenues),SUM(Expenses)) 返回收入和费用中的较小值。 |
NUMBER(_param) |
返回给定参数的数字表示形式,如果无法显示为数字,则返回 NaN。 例如: NUMBER("3.14116") 返回 3.14116 NUMBER ([Box category]) 返回 Box 类别属性当前值的数量。 |
PI() |
返回圆的圆周与其直径比率的数学常数,表示为 PI。值为 3.141592653589793。 |
POWER(_number,_number) | 计算并返回提供的第一个数字的第二个输入的数字次方。 例如: 如果 SUM(Unit Price) = 2,则 POWER(SUM(Unit Price),3) 返回 8 |
RANDOM() |
返回伪随机数 n,其中 0<=n<1。如果您需要一个随机整数,请使用公式 Round(Random()*100)。 |
ROUND(_number) |
将提供的数字的值向上或向下舍入为最接近的整数。如果等距,则向上舍入。 |
SIGN(_number) |
如果数字为负数,则返回 -1,如果为零,则返回 0,如果是正数,则返回 1。 |
SQRT(_number) | 计算并返回所提供数字的平方根。 |
SQUARE(_number) | 计算并返回所提供数字的平方。 |
LN(_number) | 返回所提供数字的自然对数。 |
LOG10(_number) | 返回所提供数字的以 10 为底数的对数。 |
LOG2(_number) | 返回所提供数字的以 2 为底数的对数。 |
LOG(_base,_number) | 返回所提供数字的对数,以提供的底数表示。 |
三角函数
这些函数可帮助您创建用于测量角度和距离的高级公式。
函数 | 描述 |
ACOS(_number) | 计算输入数字的反余弦值,以弧度表示。 |
ASIN(_number) | 计算输入数字的反正弦值,以弧度表示。 |
ATAN(_number) | 返回在参数中输入的正切角度值,以弧度表示。返回的值介于负 PI/2 和正 PI/2 之间。 |
ATAN2(_number,_number) | 返回当从一个圆的 X 轴(0,0 表示圆的中心)逆时针测量时,以弧度表示的点 Y/X 的角度。返回值介于正 PI 和负 PI 之间。输入 Y 坐标作为第一个参数。 |
COS(_number) | 计算输入数字的余弦值,以弧度表示。 |
DEGREES(_number) | 将以弧度表示的给定数字转换为度数。 |
RADIANS(_number) | 将以度数表示的给定数字转换为弧度。 |
SIN(_number) | 计算输入数字的正弦值,以弧度表示。 |
TAN(_number) | 返回输入角度的正切值。 |
评论函数
使用这些运算符可以在公式中添加注释,说明其工作方式。如果您想与其他用户就公式进行协作,或者您想为自己做笔记,说明为什么要这样构建公式,评论将大有帮助。
运算符 | 描述 |
/* | 标记评论的开始。 |
*/ | 标记评论的结束。 |
例如:/* this is a comment in a formula */
53 条评论
Toru Okada
Hi Team,
I am looking for a solution to concatenate multiple answers.
When I use Multi-select field and customer chooses more than 2 answers, it will show 2 lines in an Explore report.
I would like to show as 1 line = 1 ticket in the report.
Is that possible to make it with "Standard Calculated metric" or any other solutions?
Thank you for your support.
0
Roosa
How can I create a query that would measure the amount (average) of characters per 1st comment in a submitted ticket? Anything I try comes back with en error.
0
Jiri Vrla
Thank you, Dainne Lucena. Is there a plan to have this as a native function? This is a really bad customer experience. I would expect to be able to choose what time/date format I need.
0
Dainne Kiara Lucena-Laxamana
Hi 6220810130714


You can try & create a custom calculated metric that mimics the Full Time Resolution metric which converts minutes to seconds. Once it's converted into seconds, you can then edit the display format to Duration. “Duration” convert your results into the hh:mm:ss format (hours, minutes, seconds). This format can be used only for metrics recorded in seconds. This is why you need create a custom metric in the form of seconds.
0
Jiri Vrla
Hello, I am pretty new in this.
I am trying to build very simple report. I need new metric “Median Full resolution time” but I do not want to see it in minutes but in the format “hh:mm” How can I do that?
MED(Full resolution time (min))
I found only SECONDS_TO_TIME(_time) which should convert second to that but I need to covert minutes. On top of that I am not even sure how to write those formulas
0
Gabriel Manlapig
Hi Chetan,
Someone from our team is already assisting you with your request on how to generate a report based on ticket age for each status. Reference ticket #12613567. We would suggest continuing and replying to the ticket if you have further clarifications and questions. Thank you!
0
Chetan Bhapkar
HI Team,
What I want to do is
I want to see Ticket Age for each status,
Eg: 1234 is the ticket number it was assigned to xyz and he kept it open I want age, if he change status from Open to pending i want to see what was the between open to pending. Similarly with other ticket's status
0
Eugene Orman
@Jacqui, I have created a proactive ticket so we can have a look at your specific use case.
0
Jacqui T
Eugene Orman
The DATE() function no longer works on text values. In fact the formula validator specifically says it requires numbers as input (though will accept the year as text), see screenshot below (using the example from this document).
While it allows me to pass a text formatted timestamp, I cannot then use the value given as a date in other date functions, such as date_format(), whereas previously it formatted these as expected.
0
Eugene Orman
Jacqui, thank you for pointing this out.
The DATE() function didn't work with the attributes only with values before. We made a change that allows it to work both with the values and attributes. Its purpose is to convert text values into a date with a timestamp.
We haven't yet updated the function description yet, but we will do it both in the UI and this article. The new description will be: Converts the supplied text into a date with a timestamp.
The issues you mentioned are probably not related to this update but to the fact that we stopped executing reports with incorrectly configured formulas as mentioned in this announcement.
In most of the cases, the formula checker lets you know when there is a problem with the calculations but it can not predict all the cases. If you can not find a way to make your reports work please reach out to our support team.
0
登录以发表评论。