日期是许多数据源中的常见元素。如果字段包含可识别的日期,它将具有日期或日期时间数据类型。在可视化项中使用日期字段时,它们会获得一组特殊的功能,包括自动的日期层次钻取、特定于日期的筛选器选项和专门的日期格式化选项。
日期函数允许您对数据源中的日期进行操作。
日期函数
日期函数有时引用特定于日期的元素,包括 date_part
参数、可选的l [start_of_week]
参数和日期文本 (#)。这些元素将在本主题的末尾详细介绍。
还有其他几个可能感兴趣但不属于日期函数的主题:
- 格式化日期在可视化项中的显示方式:自定义日期格式
- 设置默认日期属性:数据源的日期属性
- 使用会计日期:会计日期
- 使用 SO-8601 历:ISO-8601 基于周的日历
DATE
将字符串和数字表达式转换为日期的类型转换函数,只要它们是可识别的格式。
语法 |
DATE(expression)
|
输出 | 日期 |
定义 | 在给定数字、字符串或日期表达式的情况下返回日期。 |
示例 |
DATE([Employee Start Date]) DATE("September 22, 2018") DATE("9/22/2018") DATE(#2018-09-22 14:52#) |
说明 |
与 DATEPARSE 不同,不需要提供模式,因为 DATE 会自动识别许多标准日期格式。但是,如果 DATE 不能识别输入,请尝试使用 DATEPARSE 并指定格式。 MAKEDATE 是另一个类似的函数,但是 MAKEDATE 要求输入年、月和日的数值。 |
DATEADD
将指定数量的日期部分(月、日等)添加到开始日期。
语法 |
DATEADD(date_part, interval, date)
|
输出 | 日期 |
定义 | 返回指定日期,该日期的指定 date_part 中添加了指定的数字间隔。例如,将开始日期增加 3 个月或 12 天。 |
示例 |
将所有的到期日推迟一周 DATEADD('week', 1, [due date])
将 2021 年 2 月 20 日加上 280 天 DATEADD('day', 280, #2/20/21#) = #November 27, 2021# |
说明 | 支持 ISO 8601 日期。 |
DATEDIFF
返回两个日期之间的日期部分(周、年等)的数量。
语法 |
DATEDIFF(date_part, date1, date2, [start_of_week])
|
输出 | 整数 |
定义 | 返回 date1 与 date2 之差(以 date_part 的单位表示)。例如,减去某人加入和离开乐队的日期,就可以知道他们在乐队里呆了多久。 |
示例 |
1986 年 3 月 25 日到 2021 年 2 月 20 日之间的天数 DATEDIFF('day', #3/25/1986#, #2/20/2021#) = 12,751
一个人在乐队里呆了几个月 DATEDIFF('month', [date joined band], [date left band]) |
说明 | 支持 ISO 8601 日期。 |
DATENAME
以离散字符串形式返回指定日期部分的名称。
语法 |
DATENAME(date_part, date, [start_of_week])
|
输出 | 字符串 |
定义 | 以字符串形式返回日期的 date_part。 |
示例 |
DATENAME('year', #3/25/1986#) = "1986" DATENAME('month', #1986-03-25#) = "March" |
说明 |
支持 ISO 8601 日期。 一个非常类似的计算是 DATEPART,它以连续整数的形式返回指定日期部分的值。DATEPART 可能更快,因为它是一个数值运算。 通过更改计算结果的属性(维度或度量、连续或离散)和日期格式,可以将 DATEPART 和 DATENAME 的结果格式设置为相同。 反函数是 DATEPARSE,它接受一个字符串值并将其格式化为日期。 |
DATEPARSE
以日期形式返回特定格式的字符串。
语法 |
DATEPARSE(date_format, [date_string])
|
输出 | 日期 |
定义 | date_format 参数将描述 [字符串] 字段的排列方式。由于可通过各种方式对字符串字段进行排序,因此 date_format 必须完全匹配。有关完整解释,请参见将字段转换为日期字段。 |
示例 |
DATEPARSE('yyyy-MM-dd', "1986-03-25") = #March 25, 1986# |
说明 |
DATE 是一个类似的函数,可以自动识别许多标准的日期格式。如果 DATE 不能识别输入模式,DATEPARSE 可能是更好的选择。 MAKEDATE 是另一个类似的函数,但是 MAKEDATE 要求输入年、月和日的数值。 反函数是 DATEPART(整数输出)和 DATENAME(字符串输出),它将日期分开并返回其各部分的值。 |
数据库限制 |
DATEPARSE 可通过以下连接器获得:非旧版 Excel 和文本文件连接、Amazon EMR Hadoop Hive、Cloudera Hadoop、Google 表格、Hortonworks Hadoop Hive、MapR Hadoop Hive、MySQL、Oracle、PostgreSQL 以及 Tableau 数据提取。有些格式可能并非适用于所有连接。 Hive 变体不支持 DATEPARSE。仅支持 Denodo、Drill 和 Snowflake。 |
DATEPART
以整数形式返回指定日期部分的名称。
语法 |
DATEPART(date_part, date, [start_of_week])
|
输出 | 整数 |
定义 | 以整数形式返回日期的 date_part。 |
示例 |
DATEPART('year', #1986-03-25#) = 1986 DATEPART('month', #1986-03-25#) = 3 |
说明 |
支持 ISO 8601 日期。 一个非常类似的计算是 DATENAME,它以离散字符串的形式返回指定日期部分的名称。DATEPART 可能更快,因为它是一个数值运算。通过更改字段的属性(维度或度量、连续或离散)和日期格式,可以将 DATEPART 和 DATENAME 的结果格式设置为相同。 反函数是 DATEPARSE,它接受一个字符串值并将其格式化为日期。 |
DATETRUNC
可以将此函数视为日期舍入。它获取特定的日期,并返回该日期在所需的特定程度上的版本。由于每个日期都必须有日、月、季度和年的值,因此 DATETRUNC 将这些值设置为指定日期部分之前每个日期部分的最小值。有关详细信息,请参考见示例。
语法 |
DATETRUNC(date_part, date, [start_of_week])
|
输出 | 日期 |
定义 | 按 date_part 指定的准确度截断日期。此函数返回新日期。例如,以月份级别截断处于月份中间的日期时,此函数返回当月的第一天。 |
示例 |
DATETRUNC(‘day’, #9/22/2018#) = #9/22/2018# DATETRUNC(‘week’, #9/22/2018#) = #9/16/2018# (包含 2018 年 9 月 22 日的一周中的星期日) DATETRUNC(‘iso-week’, #9/22/2018#) = #9/17/2018# (包含 2018 年 9 月 22 日的一周中的星期一) DATETRUNC(month, #9/22/2018#) = #9/1/2018# (包含 2018 年 9 月 22 日的月份的第一天) DATETRUNC(quarter, #9/22/2018#) = #7/1/2018# (包含 2018 年 9 月 22 日的季度的第一天) DATETRUNC(‘week’, #9/22/2018#) = #1/1/2018# (包含 2018 年 9 月 22 日的年度的第一天) 注意:对于周和 iso 周, |
说明 |
支持 ISO 8601 日期。 例如,您不会使用 DATETRUNC 来停止在可视化项中显示日期时间字段的时间。如果要截断日期的显示而不是舍入其精度,请调整格式。 举例来说,如果显示在第二个可视化项中, |
DAY
以整数形式返回一个月中的第几天 (1-31)。
语法 |
DAY(date)
|
输出 | 整数 |
定义 | 以整数的形式返回给定日期的天。 |
示例 |
Day(#September 22, 2018#) = 22 |
说明 | 另请参见 WEEK、MONTH、QUARTER、YEAR 和 ISO 等效值 |
ISDATE
检查字符串是否为有效的日期格式。
语法 |
ISDATE(string)
|
输出 | 布尔值 |
定义 | 如果给定字符串为有效日期,则返回 true。 |
示例 |
ISDATE(09/22/2018) = true ISDATE(22SEP18) = false |
说明 | 所需的参数必须是字符串。ISDATE 不能用于日期数据类型的字段,计算将返回错误。 |
MAKEDATE
语法 |
MAKEDATE(year, month, day)
|
输出 | 日期 |
定义 | 返回一个依据指定年份、月份和日期构造的日期值。 |
示例 |
MAKEDATE(1986,3,25) = #1986-03-25# 请注意,输入错误的值将被调整为一个日期,例如 |
说明 |
可用于 Tableau 数据提取。检查在其他数据源中的可用性。 MAKEDATE 要求为日期的各个部分输入数字。如果您的数据是应该是日期的字符串,请尝试 DATE 函数。DATE 可自动识别许多标准的日期格式。如果 DATE 不能识别输入,请尝试使用 DATEPARSE。 |
MAKEDATETIME
语法 |
MAKEDATETIME(date, time)
|
输出 | 日期时间 |
定义 | 返回合并了 date 和 time 的 datetime。日期可以是 date、datetime 或 string 类型。时间必须是 datetime。 |
示例 |
MAKEDATETIME("1899-12-30", #07:59:00#) = #12/30/1899 7:59:00 AM# MAKEDATETIME([Date], [Time]) = #1/1/2001 6:00:00 AM# |
说明 |
此函数仅适用于与 MySQL 兼容的连接(对于 Tableau 为 MySQL 和 Amazon Aurora)。 MAKETIME 是一个类似的函数,可用于 Tableau 数据提取和其他一些数据源。 |
MAKETIME
语法 |
MAKETIME(hour, minute, second)
|
输出 | 日期时间 |
定义 | 返回一个依据指定小时、分钟和秒构造的日期值。 |
示例 |
MAKETIME(14, 52, 40) = #1/1/1899 14:52:40# |
说明 |
由于 Tableau 不支持时间数据类型,只支持日期时间,因此输出是日期时间。字段的日期部分将是 1/1/1899。 类似于 MAKEDATETIME 的函数,只适用于 MYSQL 兼容的连接。 |
MAX
语法 |
MAX(expression) 或 MAX(expr1, expr2) |
输出 | 日期(请参见注释) |
定义 | MAX 通常应用于数字,不过也适用于日期。返回一个日期字段或两个日期的最大值(最近值)。 |
示例 |
MAX(#Sept 22, 2018#, #Feb 20, 2021#) = #Feb 20, 2021# MAX([Ship date]) |
说明 |
如果任何参数为 Null,则返回 Null。 |
MIN
语法 |
MIN(expression) 或 MIN(expr1, expr2) |
输出 | 日期(请参见注释) |
定义 | MIN 通常应用于数字,不过也适用于日期。返回一个日期字段或两个日期中的最小值(最早值)。 |
示例 |
MIN(#Sept 22, 2018#, #Feb 20, 2021#) = #Sept 22, 2018# MIN(Ship date]) |
说明 |
如果任何参数为 Null,则返回 Null。 |
MONTH
语法 |
MONTH(date)
|
输出 | 整数 |
定义 | 以整数的形式返回给定日期的月份。 |
示例 |
MONTH(#1986-03-25#) = 3 |
说明 | 另请参见 DAY、WEEK、QUARTER、YEAR 和 ISO 等效值。 |
NOW
语法 |
NOW()
|
输出 | 日期时间 |
定义 | 返回当前本地系统日期和时间。 |
示例 |
NOW() = 1986-03-25 1:08:21 PM |
说明 |
NOW 不接受参数。 另请参见返回日期而不是日期时间的类似计算 TODAY。 如果数据源是实时连接,则系统日期和时间可能位于另一个时区。有关如何解决此问题的详细信息,请参见知识库。 |
QUARTER
语法 |
QUARTER(date)
|
输出 | 整数 |
定义 | 以整数的形式返回给定日期的季度。 |
示例 |
QUARTER(#1986-03-25#) = 1 |
说明 | 另请参见 DAY、WEEK、MONTH、YEAR 和 ISO 等效值。 |
TODAY
语法 |
TODAY()
|
输出 | 日期 |
定义 | 返回当前本地系统日期。 |
示例 |
TODAY() = 1986-03-25 |
说明 |
TODAY 不接受参数。 另请参见返回日期时间而不是日期的类似计算 NOW。 如果数据源是实时连接,则系统日期可能位于另一个时区。有关如何解决此问题的详细信息,请参见知识库。 |
WEEK
语法 |
WEEK(date)
|
输出 | 整数 |
定义 | 以整数的形式返回给定日期的周。 |
示例 |
WEEK(#1986-03-25#) = 13 |
说明 | 另请参见 DAY、MONTH、QUARTER、YEAR 和 ISO 等效值。 |
YEAR
语法 |
YEAR(date)
|
输出 | 整数 |
定义 | 以整数的形式返回给定日期的年份。 |
示例 |
YEAR(#1986-03-25#) = 1,986 |
说明 | 另请参见 DAY、WEEK、MONTH、QUARTER 和 ISO 等效值。 |
ISOQUARTER
语法 |
ISOQUARTER(date)
|
输出 | 整数 |
定义 | 以整数的形式返回给定日期的基于 ISO8601 周的季度。 |
示例 |
ISOQUARTER(#1986-03-25#) = 1 |
说明 | 另请参见 ISOWEEK、ISOWEEKDAY、ISOYEAR 和非 ISO 等效值。 |
ISOWEEK
语法 |
ISOWEEK(date)
|
输出 | 整数 |
定义 | 以整数的形式返回给定日期基于 ISO8601 周的周。 |
示例 |
ISOWEEK(#1986-03-25#) = 13 |
说明 | 另请参见SOWEEKDAY、ISOQUARTER、ISOYEAR 和非 ISO 等效值。 |
ISOWEEKDAY
语法 |
ISOWEEKDAY(date)
|
输出 | 整数 |
定义 | 以整数的形式返回给定日期基于 ISO8601 周的平日。 |
示例 |
ISOWEEKDAY(#1986-03-25#) = 2 |
说明 | 另请参见 ISOWEEK、ISOQUARTER、ISOYEAR 和非 ISO 等效值 |
ISOYEAR
语法 |
ISOYEAR(date)
|
输出 | 整数 |
定义 | 以整数的形式返回给定日期的基于 ISO8601 周的年。 |
示例 |
ISOYEAR(#1986-03-25#) = 1,986 |
说明 | 另请参见 ISOWEEK、ISOWEEKDAY、ISOQUARTER 和非 ISO 等效值。 |
date_part
参数
Tableau 中的许多日期函数都采用参数 date_part
,这是一个字符串常量,它告诉函数要考虑日期的哪一部分,例如日、周、季度等。
您可以使用的有效 date_part
值为:
date_part | 值 |
---|---|
'year'
|
四位数年份 |
'quarter'
|
1-4 |
'month'
|
1-12 或 "January"、"February" 等 |
'dayofyear'
|
一年中的第几天;1 月 1 日为 1、2 月 1 日为 32,依此类推 |
'day'
|
1-31 |
'weekday'
|
1-7 或 "Sunday"、"Monday" 等 |
'week'
|
1-52 |
'hour'
|
0-23 |
'minute'
|
0-59 |
'second'
|
0-60 |
'iso-year'
|
4 位数 ISO 8601 年份 |
'iso-quarter'
|
1-4 |
'iso-week'
|
1-52,每周始终从星期一开始 |
'iso-weekday'
|
1-7,每周始终从星期一开始 |
[start_of_week]
参数
某些函数有可选参数 [start_of_week]
。start_of_week
参数可用于指定哪一天被视为一周的第一天,例如“Sunday”或“Monday”。如果省略它,则一周的开始由数据源确定。请参见数据源的日期属性。
在下面的例子中,9 月 22 日是星期日,9 月 24 日是星期二。DATEDIFF 函数用于计算这些日期之间的周数。
DATEDIFF('week', #2013-09-22#, #2013-09-24#, 'monday') = 1
- 由于 start_of_week 为“monday”(星期一),因此这些日期在不同的周中。
DATEDIFF('week', #2013-09-22#, #2013-09-24#, 'sunday') = 0
- 由于 start_of_week 为“sunday”(星期日),因此这些日期在同一周内。
日期文本 (#)
示例通常在日期表达式中使用井号 (#)。这是日期文本,类似于对文本字符串使用引号,它告诉 Tableau 符号内的值是日期。
如果没有日期文本,日期可能会被解释为各种其他数据类型。例如:
格式 | 数据类型 | 值 |
'March 25, 1986' | 字符串 | 'March 25, 1986' |
#3/25/1986# | 日期 | #3/25/1986# |
03/25/1986 | 浮点小数 | 0.00006042 |
1986-03-25 | 整数 | 1,958 |
03/25/1986 | 无效 |
有关详细信息,请参见文本表达式语法。
创建日期计算
练习使用 Superstore 示例数据源创建日期计算。
- 在 Tableau Desktop 中,连接到 Tableau 附带的“Sample - Superstore”已保存数据源。
- 打开一个工作表。
- 从“数据”窗格中的“维度”下,将“Order Date”(订单日期)拖到“行”功能区。
- 在“行”功能区上,单击“YEAR(Order Date)”字段上的加号图标 (+)。
“QUARTER(Order Date)”将添加到“行”功能区,并且视图将更新。
- 在“行”功能区上,单击“QUARTER(Order Date)”字段上的加号图标 (+),以下钻到“MONTH(Order Date)”。
- 选择“分析”>“创建计算字段”。
- 在打开的计算编辑器中,执行以下操作:
- 将计算字段命名为“Quarter Date”(季度日期)。
- 输入以下公式:
DATETRUNC('quarter', [Order Date])
- 完成后,单击“确定”。
新的日期计算将出现在“数据”窗格中的“维度”下。就像其他字段一样,您可以在一个或多个可视化项中使用该字段。
- 从“数据”窗格中的“维度”下,将“Quarter Date”(季度日期)拖到“行”功能区,并将其放在“MONTH(Order Date)”右侧。可视化项将更新为包含年份值。这是因为 Tableau 将日期数据累积到最高详细级别。
- 在“行”功能区上,右键单击“YEAR(Quarter Date)”,并选择“精确日期”。
- 在“行”功能区上,再次右键单击“YEAR(Quarter Date)”,并选择“离散”。
可视化项将更新为包含表中每一行的准确季度日期。