Salesforce SOQLクエリのTODAYとは?概要や扱い方をご紹介
IT・技術関連
更新日:2024.09.05


SalesforceのSOQLとは?
SalesforceのSOQLとは、Salesforceオブジェクトのクエリ言語です。
SOQLは「Salesforce Object Query Language」の略で、Salesforceのデータベースに対してクエリを発行できます。SOQLは標準のSQL言語に似た構文ですが、Lightning Platform用にカスタマイズされています。
SOQLクエリを実行するには、開発者コンソールのクエリエディタに記述する方法と、Apexコードに記述する方法があります。
クエリエディタにSOQLを記述する方法
開発者コンソールのクエリエディタコンソールにSOQLクエリを記述すれば実行できます。 クエリエディタコンソールにSOQLクエリを記述すれば、簡単にすばやくデータベースにアクセスできます。例えば、SOQLクエリをApexコードに追加する前のテストとして、試しに実行結果を確認する場合などに使用できます。サンプルコード
基本的なSOQLクエリの構文について説明します。 以下は、基本的なSOQLクエリの構文です。WHERE句は省略可能です。SELECT fields FROM ObjectName [WHERE Condition]
以下のSOQLクエリは、全取引先から各取引先の名前と電話番号を取得しています。
SELECT Name,Phone FROM Account
詳しく説明すると、「SELECT Name,Phone」は、取得する項目を指定しています。取得する項目が複数あるのでSELECTキーワードの後に「,」で区切っています。仮に取得する項目が1つの場合は「,」区切りは不要です。
次に「FROM Account」は、取得するカスタムオブジェクトを指定しています。今回の例ではAccountです。
ApexコードにSOQLを記述する方法
ApexコードにSOQLクエリを記述すれば実行できます。 Apexはデータベースに保存されているSalesforceレコードに直接アクセスすることが可能なので、SOQLクエリをApexコードに記述すれば、実行結果を簡単に取得できます。Apexに記述したSOQLをインラインSOQLと呼びます。サンプルコード
ApexコードにSOQLクエリを記述するサンプルコードを説明します。 SOQLクエリをApexコードに記述する際は、SOQLステートメントを「[」、「]」で囲み、戻り値をsObject配列に代入します。 以下の例では、名前と電話番号の2つを持つすべての取引先レコードを取得してAccount sObjectの配列を戻り値にしています。Account[] accts = [SELECT Name,Phone FROM Account];
「*」の指定について
SOQLでは、「*」を指定することはできません。 他のSQL言語では「*」を指定すれば、すべての項目を取得できますが、SOQLでは必ず取得する項目を明示的に指定する必要があるため、「*」を使用できません。 仮に、SELECT句で指定していない項目にアクセスすると、エラーになります。IDの指定について
SOQLでは、ID項目をクエリに指定する必要はありません。 Apexコードに記述したSOQLクエリでは、指定されたかどうかに関係なく、常にID項目が返されます。例えば、「SELECT Id,Phone FROM Account」と「SELECT Phone FROM Account」は同等の命令になります。 ただし、少なくとも1つの項目は必要なので、ID項目のみを取得する場合は、「SELECT Id FROM Account」のようにID項目を指定する必要があります。Salesforce SOQLクエリのTODAYとは?

SELECT Id FROM Account WHERE CreatedDate = TODAY
タイムゾーンについて
SalesforceのSOQLクエリで扱うタイムゾーンはUTC値なので注意が必要です。 UTC値とは協定世界時のことです。協定世界時は、イギリスのグリニッジ天文台を基準とした世界中で使われる標準時のことです。システムの時間が日本標準時であれば、9時間ずれた値で表示されます。 SOQLクエリのTODAYなどで取得したUTC値を扱う場合は、そのままでは使用できないので、タイムゾーンをシステムの時間(日本なら日本標準時)に変換する必要があります。タイムゾーンの変換
SalesforceのSOQLクエリが返すUTC値(協定世界時)のタイムゾーンは、日付関数で変換して使用します。 SOQLクエリのTODAYなどで取得したUTC値のタイムゾーンを、システムのタイムゾーンに変換するには、日付関数の「convertTimezone()」を使用します。 例えば、次のように変換します。SELECT HOUR_IN_DAY(convertTimezone(CreatedDate)), SUM(Amount)
FROM Opportunity
GROUP BY HOUR_IN_DAY(convertTimezone(CreatedDate))
ただし、次のように、「convertTimezone()」単独での使用では機能しません。
SELECT convertTimezone(CreatedDate)
FROM Opportunity
日付のデータ形式について
日付を扱う場合、データ形式によって注意が必要です。 日付を文字列型に変換する場合、「yyy-MM-dd」形式にする必要があります。文字列型ではなく、Date型なら「String.valueOf(myDate)」を指定すれば自動的にDate型に変換してくれます。 例えば、「yyyy/MM/dd」のように「/」区切りの文字列を日付として扱いたい場合は、「Date.parse」メソッドを使用して、日付型に変換した後に「yyyy-MM-dd」形式の文字列に変換する必要があります。String strDate = '2011/12/31';
Date myDate = Date.parse(strDate);
... WHERE Close Date <= ' + String.valueOf(myDate)
日付の指定方法
日付を文字列で指定する場合、シングルクォーテーションで囲まないでください。 以下が正しい例です。WHERE Close Date <= ' + String.valueOf(myDate)
間違って、以下のようにシングルクォーテーションで囲まないでください。
WHERE Close Date <= \'' + String.valueOf(myDate) + '\''
こうしてしまうと、次のようなエラーメッセージが出てしまいます。
「value of filter criterion for field ‘[項目]’ must be of type date and should not be enclosed in quotes」
Salesforce SOQLクエリのTODAYを活用しよう!

この記事の監修者・著者

- AWSパートナー/Salesforce認定コンサルティングパートナー 認定企業
-
ITエンジニア派遣サービス事業を行っています。AWSやSalesforceなど専門領域に特化したITエンジニアが4,715名在籍し、常時100名以上のITエンジニアの即日派遣が可能です。
・2021年:AWS Japan Certification Award 2020 ライジングスター of the Year 受賞
・2022年3月:人材サービス型 AWSパートナー認定
・AWS認定資格保有者数1,154名(2024年6月現在)
・Salesforce認定コンサルティングパートナー
・Salesforce認定資格者276名在籍(2024年5月現在)
・LPIC+CCNA 認定資格者:472 名(2024年6月時点)
最新の投稿
- 2024-12-27営業インタビュー情報共有の活性化の中心に。SP企画部の新たな取り組み
- 2024-07-01営業インタビュー最短で当日にご提案可能。 OPE営業の対応が早い3つの理由
- 2024-07-01営業インタビュー研修見学ツアーが高評価!「お客様のOPEに対する期待を高め、継続に貢献できればと思います。」
- 2024-07-01営業インタビュー信頼関係を構築し、エンジニアの長期就業へ
ITエンジニアの派遣を利用したい企業様へ

- 求人・転職サイトや自社採用サイトを使っているが、自社に合ったITエンジニアが応募してこない…
- すぐに採用したいが、応募がぜんぜん集まらない
こんな悩みをお持ちの採用・人事担当者の方は、
オープンアップITエンジニアをご検討ください!
オープンアップITエンジニアをご検討ください!
当社のITエンジニア派遣サービスは
- 派遣スピードが速い!(最短即日)
- 4,500名のエンジニアから貴社にマッチした人材を派遣
- 正社員雇用も可能
こんな特長があり、貴社の事業やプロジェクトに合った最適なITエンジニアを派遣可能です。
まずは下記ボタンから無料でご相談ください。