calendar_months

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

語法

calendar_months(numberOfMonths)

參數

• numberOfMonths：如果這個值是 0，函式會傳回包含第一個 date 參數的完整月份。如果是正整數，可指定要往後計算的完整月數；如果是負整數，則可指定除當月以外，要往前計算的完整月數。

範例說明

• Clicks.for_date_range(from_date(), calendar_months(0))：傳回 from_date() 所傳回完整月份內獲得的點擊次數。

  下方範例的 from_date() 傳回了 21 日，因此 calendar_months(0) 會傳回這整個月份。
  

• Clicks.for_date_range(today(), calendar_months(-3))：傳回當月以及前三個完整月份內獲得的點擊次數。

  在下方範例中，今天是 21 日。函式會傳回前三個月以及當月完整月份內獲得的點擊次數。由於當月尚未過完，因此傳回的會是截至當天 (21 日) 為止的指標。