calendar_weeks

返回当前这周对应的时间范围，以及往后/往回统计所指定的额外周数。只能用作 for_date_range(date, date) 中的第二个 date 参数。所有统计都以 for_date_range(date, date) 中的第一个 date 参数为依据。

语法

calendar_weeks(numberOfWeeks, [startDay])

参数

• numberOfWeeks：如果此参数的值为零，则返回第一个 date 参数所在那个完整周。正整数用来指定要往后统计的额外完整周数。负整数用来指定要往回统计的完整周数以及当前的完整周。
• startDay（可选）：用整数（1 到 7）来指定您要将哪一天作为一周的第一天：
  • 1 = 星期日
  • 2 = 星期一
  • 3 = 星期二
  • 4 = 星期三
  • 5 = 星期四
  • 6 = 星期五
  • 7 = 星期六

默认情况下，星期日是一周的起始日。

示例

• Clicks.for_date_range(from_date(), calendar_weeks(0,2))：返回在包含 from_date() 的那个完整周（从星期一到星期日）内获得的点击次数。
  
  在下面的示例中：
  • 报表的时间范围是从 4 日开始，因此 from_date() 会返回 4 日。
  • 第二个参数指定星期一为一周的起始日。
  • calendar_weeks(0,2) 会返回从 3 日到 9 日（即星期一到星期日）获得的点击次数。

  

• Clicks.for_date_range(from_date(), calendar_weeks(2,1))：返回从包含 from_date() 的那个完整周到两个完整周后结束这段时间内获得的点击次数。
  
  在下面的示例中：
  • 报表的时间范围是从 4 日开始，因此 from_date() 会返回 4 日。
  • calendar_weeks(2,1) 会返回 4 日所在的那个完整周，然后计算接下来的两周（从星期日到星期六）所对应的时间范围。
  • 整个函数会返回从 2 日到 22 日这段时间内获得的点击次数。

  

• Clicks.for_date_range(from_date(), calendar_weeks(-1,1))：如果 from_date() 返回 18 日，则整个函数会返回从 9 日（即 18 日之前的第一个完整周）到 22 日（即 18 日所在的那个完整周）这段时间内获得的点击次数。