calendar_weeks

會傳回當週，並且可以往前/往後加計指定的週數。這個函式只能當作第二個 date 參數使用 (在 for_date_range(date, date) 中)。所有計算均以 for_date_range(date, date) 中的第一個 date 參數為準。

語法

calendar_weeks(numberOfWeeks, [startDay])

參數

• numberOfWeeks：如果這個值是 0，函式會傳回包含第一個 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 日的完整一週) 期間獲得的點擊次數。