Cube.js如何实现本周/本月等特定时间段的指标计算？

Cube.js 原生支持计算今日、本周、本月、上月等任意相对时间段的计数、求和类聚合指标，不需要复杂的rollingWindow配置即可实现按维度拆分的多时间段指标同表展示。

原有配置的错误点 #

你之前写的过滤逻辑存在本质错误：
${CUBE}.created_at = 'This week' 是直接将时间字段和字符串'This week'做等值匹配，没有做任何时间范围计算，必然返回错误结果。

正确实现方案 #

核心逻辑是为每个时间段单独定义度量，在度量的过滤条件中直接写数据库可识别的时间范围判断SQL，所有时间计算会在Cube生成查询SQL阶段自动完成，不需要前端额外传参。

以你提到的Orders表为例，完整Cube配置如下：

cube(`Orders`, {
  sql: `SELECT id, product_id, product_name, created_at FROM orders`,

  dimensions: {
    productName: {
      sql: `product_name`,
      type: `string`
    }
  },

  measures: {
    // 本周订单量
    thisWeekOrders: {
      sql: `id`,
      type: `count`,
      filters: [
        {
          // MySQL 语法：取本周一0点至今的时间范围
          sql: `${CUBE}.created_at >= DATE_SUB(CURDATE(), INTERVAL WEEKDAY(CURDATE()) DAY)`
        }
      ]
    },
    // 本月订单量
    thisMonthOrders: {
      sql: `id`,
      type: `count`,
      filters: [
        {
          // MySQL 语法：取本月1号0点至今的时间范围
          sql: `${CUBE}.created_at >= DATE_FORMAT(CURDATE(), '%Y-%m-01')`
        }
      ]
    },
    // 累计总订单量，无需加时间过滤
    totalOrders: {
      sql: `id`,
      type: `count`
    }
  }
});

注：上述时间判断基于MySQL语法，如果你使用其他数据库，只需替换对应时间计算函数即可，整体配置逻辑不变：

• PostgreSQL：本周起始用date_trunc('week', CURRENT_DATE)，本月起始用date_trunc('month', CURRENT_DATE)
• BigQuery：本周起始用TIMESTAMP_TRUNC(CURRENT_TIMESTAMP(), WEEK(MONDAY))，本月起始用TIMESTAMP_TRUNC(CURRENT_TIMESTAMP(), MONTH)

前端查询方式 #

前端查询时不需要传入时间维度参数，只需要指定产品维度和需要展示的时间段度量即可，示例查询参数：

{
  dimensions: [Orders.productName],
  measures: [Orders.thisWeekOrders, Orders.thisMonthOrders, Orders.totalOrders]
}

查询返回结果会直接按产品分组，展示每个产品对应的本周、本月、累计订单量，完全匹配分析表格需求。

rollingWindow 适用场景说明 #

rollingWindow 仅适合做滚动窗口类的趋势计算，比如过去7天滚动平均、按日期趋势的累计值等场景。如果只是要固定相对时间段的聚合值，直接在度量上加时间过滤的方案性能更好、逻辑更直观，不需要额外配置时间粒度。

内容的提问来源于stack exchange，提问作者Muhamed Muhamedagić