SOQLの日付リテラル
忙しさを理由に更新を怠っていた… 前回書いていた内容の続きは改めて書こう
今回はSOQLで使える日付リテラルをまとめとく。（リファレンス読めよ） 時々使うのでここに抜粋
SOQL日付リテラル一覧
| 日付リテラル | 範囲 | 例 |
|---|---|---|
| YESTERDAY | 昨日の 00:00:00 から、その 24 時間後まで | SELECT Id FROM Account WHERE CreatedDate = YESTERDAY |
| TODAY | 本日の 00:00:00 から、その 24 時間後まで | SELECT Id FROM Account WHERE CreatedDate > TODAY |
| TOMORROW | 明日の 00:00:00 から、その 24 時間後まで | SELECT Id FROM Opportunity WHERE CloseDate = TOMORROW |
| LAST_WEEK | 先週の最初の日の 00:00:00 から、その 7日後までが指定。週の最初の日はロケールによって判断 | SELECT Id FROM Account WHERE CreatedDate > LAST_WEEK |
| THIS_WEEK | 今週の最初の日の 00:00:00 から、その 7日後までが指定。週の最初の日はロケールによって判断 | SELECT Id FROM Account WHERE CreatedDate < THIS_WEEK |
| NEXT_WEEK | 来週の最初の日の 00:00:00 から、その 7日後までが指定。週の最初の日はロケールによって判断 | SELECT Id FROM Opportunity WHERE CloseDate = NEXT_WEEK |
| LAST_MONTH | 先月の最初の日の 00:00:00 から、その月のすべての日が指定 | SELECT Id FROM Opportunity WHERE CloseDate > LAST_MONTH |
| THIS_MONTH | 今月の最初の日の 00:00:00 から、その月のすべての日が指定 | SELECT Id FROM Account WHERE CreatedDate < THIS_MONTH |
| NEXT_MONTH | 来月の最初の日の 00:00:00 から、その月のすべての日が指定 | SELECT Id FROM Opportunity WHERE CloseDate = NEXT_MONTH |
| LAST_90_DAYS | 本日の 00:00:00 から、その 90 日前までが指定 | SELECT Id FROM Account WHERE CreatedDate = LAST_90_DAYS |
| NEXT_90_DAYS | 本日の 00:00:00 から、その 90 日後までが指定 | SELECT Id FROM Opportunity WHERE CloseDate > NEXT_90_DAYS |
| LAST_N_DAYS:n | 数値n が指定されている場合、本日の00:00:00 から、そのn 日前までが指定 | SELECT Id FROM Account WHERE CreatedDate = LAST_N_DAYS:365 |
| NEXT_N_DAYS:n | 数値n が指定されている場合、本日の00:00:00 から、そのn 日後までが指定 | SELECT Id FROM Opportunity WHERE CloseDate > NEXT_N_DAYS:15 |
| NEXT_N_WEEKS:n | 数値n が指定されている場合、翌週の最初の日の 00:00:00 から、そのn 週後までが指定 | SELECT Id FROM Opportunity WHERE CloseDate > NEXT_N_WEEKS:4 |
| LAST_N_WEEKS:n | 数値n が指定されている場合、前週の最後の日の 00:00:00 から、そのn 週前までが指定 | SELECT Id FROM Account WHERE CreatedDate = LAST_N_WEEKS:52 |
| NEXT_N_MONTHS:n | 数値n が指定されている場合、翌月の最初の日の 00:00:00 から、そのn 月後までが指定 | SELECT Id FROM Opportunity WHERE CloseDate > NEXT_N_MONTHS:2 |
| LAST_N_MONTHS:n | 数値n が指定されている場合、前月の最後の日の 00:00:00 から、そのn 月前までが指定 | SELECT Id FROM Account WHERE CreatedDate = LAST_N_MONTHS:12 |
| THIS_QUARTER | 今四半期の最初の日の 00:00:00 から、今四半期の終わりまでが指定 | SELECT Id FROM Account WHERE CreatedDate = THIS_QUARTER |
| LAST_QUARTER | 前四半期の 00:00:00 から、その四半期の終わりまでが指定 | SELECT Id FROM Account WHERE CreatedDate > LAST_QUARTER |
| NEXT_QUARTER | 翌四半期の 00:00:00 から、その四半期の終わりまでが指定 | SELECT Id FROM Account WHERE CreatedDate < NEXT_QUARTER |
| NEXT_N_ QUARTERS:n |
翌四半期の 00:00:00 から、n 期後の四半期の終わりまでが指定 | SELECT Id FROM Account WHERE CreatedDate < NEXT_N_QUARTERS:2 |
| LAST_N_ QUARTERS:n |
n 期前の四半期の最初の日の 00:00:00 から、前四半期の最終日の終わりまでが指定 | SELECT Id FROM Account WHERE CreatedDate > LAST_N_QUARTERS:2 |
| THIS_YEAR | 今年の 1 月 1 日 00:00:00 から、今年の 12月 31 日の終わりまでが指定 | SELECT Id FROM Opportunity WHERE CloseDate = THIS_YEAR |
| LAST_YEAR | 前年の 1 月 1 日 00:00:00 から、その年の12 月 31 日の終わりまでが指定 | SELECT Id FROM Opportunity WHERE CloseDate > LAST_YEAR |
| NEXT_YEAR | 翌年の 1 月 1 日 00:00:00 から、その年の12 月 31 日の終わりまでが指定 | SELECT Id FROM Opportunity WHERE CloseDate < NEXT_YEAR |
| NEXT_N_ YEARS:n |
翌年の 1 月 1 日 00:00:00 から、n 年後の 12月 31 日の終わりまでが指定 | SELECT Id FROM Opportunity WHERE CloseDate < NEXT_N_YEARS:5 |
| LAST_N_ YEARS:n |
n 年前の 1 月 1 日 00:00:00 から、前年の 12月 31 日の終わりまでが指定 | SELECT Id FROM Opportunity WHERE CloseDate > LAST_N_YEARS:5 |
| THIS_FISCAL_ QUARTER |
現在の会計四半期の最初の日の 00:00:00から、その会計四半期の最終日の終わりまでが指定。会計年度は、設定 の会計年度 ページで定義 | SELECT Id FROM Account WHERE CreatedDate = THIS_FISCAL_QUARTER |
| LAST_FISCAL_ QUARTER |
前会計四半期の最初の日の 00:00:00 から、その会計四半期の最終日の終わりまでが指定。会計年度は、設定 の 会計年度 ページで定義 | SELECT Id FROM Account WHERE CreatedDate > LAST_FISCAL_QUARTER |
| NEXT_FISCAL_ QUARTER |
翌会計四半期の最初の日の 00:00:00 から、その会計四半期の最終日の終わりまでが指定。会計年度は、設定 の 会計年度 ページで定義 | SELECT Id FROM Account WHERE CreatedDate < NEXT_FISCAL_QUARTER |
| NEXT_N_FISCAL_ QUARTERS:n |
翌会計四半期の最初の日の 00:00:00 から、n 期後の会計四半期の最終日の終わりまでが指定。会計年度は、設定の 会計年度 ページで定義 | SELECT Id FROM Account WHERE CreatedDate < NEXT_N_FISCAL_ QUARTERS:6 |
| LAST_N_FISCAL_ QUARTERS:n |
n 期前の会計四半期の最初の日の 00:00:00から、前会計四半期の最終日の終わりまでが指定。会計年度は、設定の 会計年度 ページで定義 | SELECT Id FROM Account WHERE CreatedDate > LAST_N_FISCAL_ QUARTERS:6 |
| THIS_FISCAL_ YEAR |
現在の会計四半期の最初の日の 00:00:00から、その会計四半期の最終日の終わりまでが指定。会計年度は、設定 の 会計年度 ページで定義 | SELECT Id FROM Opportunity WHERE CloseDate = THIS_FISCAL_YEAR |
| LAST_FISCAL_ YEAR |
前会計年度の最初の日の 00:00:00 から、その会計年度の最終日の終わりまでが指定。会計年度は、設定 の 会計年度 ページで定義 | SELECT Id FROM Opportunity WHERE CloseDate > LAST_FISCAL_YEAR |
| NEXT_FISCAL_ YEAR |
翌会計年度の最初の日の 00:00:00 から、その会計年度の最終日の終わりまでが指定。会計年度は、設定 の 会計年度 ページで定義 | SELECT Id FROM Opportunity WHERE CloseDate < NEXT_FISCAL_YEAR |
| NEXT_N_FISCAL_ YEARS:n |
翌会計年度の最初の日の 00:00:00 から、n 年後の会計年度の最終日の終わりまでが指定。会計年度は、設定 の会計年度 ページで定義 | SELECT Id FROM Opportunity WHERE CloseDate < NEXT_N_FISCAL_YEARS:3 |
| LAST_N_FISCAL_ YEARS:n |
n 年前の会計年度の最初の日の 00:00:00から、前会計年度の最終日の終わりまでが指定。会計年度は、設定 の会計年度 ページで定義 | SELECT Id FROM Opportunity WHERE CloseDate > LAST_N_FISCAL_YEARS:3 |
意外と多いですね。 LAST_N_DAYS:nとか定期的に取得するような場合は使えそうです。
