DatetimeAdd

datetimeAdd 接受一个日期时间值,并向其添加一定时间单位。当您处理具有“开始”和“结束”标记的时间序列数据(例如会话或订阅数据)时,此函数非常有用。

语法 示例
datetimeAdd(列, 数量, 单位) datetimeAdd("2021-03-25", 1, "month")
获取时间戳或日期值,并向其添加指定的时间单位数量。 2021-04-25

参数

column 可以是以下任何一种:

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

unit 可以是以下任何一种:

  • “year”
  • “quarter”
  • “month”
  • “day”
  • “hour”
  • “minute”
  • “second”
  • “millisecond”

数量:

  • 一个整数。您不能使用小数位值。例如,您不能添加“半年”(0.5)。
  • 可以是负数:datetimeAdd("2021-03-25", -1, "month") 将返回 2021-04-25

计算结束日期

假设您是一位咖啡鉴赏家,您想跟踪咖啡豆的新鲜度

咖啡 开封日期 保质期至
DAK Honey Dude 2022年10月31日 2022年11月14日
NO6 Full City Espresso 2022年11月7日 2022年11月21日
Ghost Roaster Giakanja 2022年11月27日 2022年12月11日

这里,保质期至 是一个自定义列,其表达式为

datetimeAdd([Opened On], 14, 'day')

检查当前日期时间是否在某个时间间隔内

假设您想检查今天的日期是否在开始日期和结束日期之间。假设“今天”是 2022 年 12 月 1 日。

咖啡 开封日期 保质期至 今天仍然新鲜
DAK Honey Dude 2022年10月31日 2022年11月14日
NO6 Full City Espresso 2022年11月7日 2022年11月21日
Ghost Roaster Giakanja 2022年11月27日 2022年12月11日

保质期至 是一个自定义列,其表达式为

datetimeAdd([Opened On], 14, 'day')

今天仍然新鲜 使用 case 来检查当前日期(now)是否在 开封日期保质期至 之间

case(between(now, [Opened On], [Finish By]), "Yes", "No")

支持的数据类型

数据类型 适用于 datetimeAdd
字符串
数字
时间戳
布尔值
JSON

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

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

限制

如果您正在使用 MongoDB,datetimeAdd 仅适用于 5 及更高版本。

本节涵盖了与 Metabase datetimeAdd 表达式工作方式相同的函数和公式,并附有关于如何为您的用例选择最佳选项的说明。

Metabase 表达式

其他工具

datetimeSubtract

datetimeSubtractdatetimeAdd 可以互换使用,因为您可以为 amount 使用负数。通常最好避免双重否定(例如减去负数)。

datetimeSubtract([Opened On], -14, "day")

与...相同

datetimeAdd([Opened On], 14, "day")

SQL

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

如果我们的咖啡样本数据存储在 PostgreSQL 数据库中

SELECT opened_on + INTERVAL '14 days' AS finish_by
FROM coffee

等同于 Metabase 的 datetimeAdd 表达式

datetimeAdd([Opened On], 14, "day")

电子表格

如果我们的咖啡样本数据在一个电子表格中,其中“开封日期”在 A 列且为日期格式,则电子表格函数

A:A + 14

产生与...相同的结果

datetimeAdd([Opened On], 14, "day")

大多数电子表格工具需要对不同的时间单位使用不同的函数(例如,您会使用不同的函数来为日期添加“月”)。datetimeAdd 使您能够轻松地将所有这些函数转换为统一的语法。

Python

假设咖啡样本数据在名为 dfpandas 数据框列中,您可以导入 datetime 模块并使用 timedelta 函数

df['Finish By'] = df['Opened On'] + datetime.timedelta(days=14)

等同于

datetimeAdd([Opened On], 14, "day")

延伸阅读

阅读其他 Metabase 版本的文档。

© . All rights reserved.