DatetimeDiff

datetimeDiff 用于获取两个日期时间值之间的时间量，使用指定的时间单位。请注意，差值以整数单位计算（参见下面的示例）。

参数

datetime1 和 datetime2 可以是

• 时间戳列的名称，
• 返回 日期时间 的自定义表达式，或
• 格式为 "YYYY-MM-DD" 或 "YYYY-MM-DDTHH:MM:SS" 的字符串（如上例所示）。

unit 可以是以下任意一种：

• “年”
• “季度”
• “月”
• “周”
• “天”
• “小时”
• “分钟”
• “秒”

计算年龄

假设您是一名奶酪制造商，并且想要跟踪您的熟化过程

成熟年龄（月）是一个自定义列，其表达式为

datetimeDiff([Aging Start], [Aging End], "month")

要计算奶酪的当前月龄，您可以使用 now 作为第二个日期时间参数，如下所示

datetimeDiff([Aging Start], now, "month")

要计算奶酪的当前日龄，您可以使用

datetimeDiff([Aging Start], now, "day")

支持的数据类型

我们使用“时间戳”和“日期时间”来指代 Metabase 支持的任何时间数据类型。有关 Metabase 中这些数据类型的更多信息，请参阅 时区。

如果您的时间戳在数据库中存储为字符串或数字，管理员可以从“表元数据”页面 将其转换为时间戳。

限制

datetimeDiff 目前不适用于以下数据库

• Druid

相关函数

本节介绍与 Metabase datetimeDiff 表达式功能相同的函数和公式，并提供有关如何为您的用例选择最佳选项的说明。

• SQL
• 电子表格
• Python

SQL

当您使用 查询构建器 运行问题时，Metabase 会将您的图形化查询设置（筛选器、汇总等）转换为查询，并针对您的数据库运行该查询以获取结果。

如果我们的 奶酪示例数据 存储在 PostgreSQL 数据库中

SELECT DATE_PART('month', AGE(aging_end, aging_start)) AS mature_age_months
FROM cheese

等同于 Metabase 的 datetimeDiff 表达式

datetimeDiff([Aging Start], [Aging End], "month")

一些数据库，如 Snowflake 和 BigQuery，支持 DATEDIFF 或 DATE_DIFF 等函数。欲了解更多信息，请查看我们的 常见 SQL 参考指南 列表。

电子表格

如果我们的 奶酪示例数据 在电子表格中，“熟化开始”在 B 列，“熟化结束”在 C 列

DATEDIF(B1, C1, "M")

产生与以下相同的结果

datetimeDiff([Aging Start], [Aging End], "month")

是的，DATEDIF 看起来有点不对劲，但电子表格函数确实是只有一个“f”的 DATEDIF()，而不是 DATEDIFF()。

Python

假设 奶酪示例数据 位于名为 df 的 pandas 数据帧列中，您可以直接减去日期，并使用 numpy 的 timedelta64 将差值转换为月

df['Mature Age (Months)'] = (df['Aging End'] - df['Aging Start']) / np.timedelta64(1, 'M')

等同于

datetimeDiff([Aging Start], [Aging End], "month")

延伸阅读

• 自定义表达式文档
• 自定义表达式教程
• 时间序列分析