「東雲忠太郎」の平凡な日常のできごと

2024.01.09

Microsoft Graph APIのfilterqueryでStringとDateTimeが混ざってしまう場合の解消方法

カテゴリ： Graph API

Microsoft Graph APIでは、$filter クエリパラメーターを使用して検索条件を指定できます。しかし、$filter ではデータ型が混ざる場合には注意が必要です。String と DateTime などの異なるデータ型の比較を行う場合、クエリ内での型の整合性を確保する必要があります。

例えば、receivedDateTime を String として比較する場合、ISO 8601形式の日付文字列を使用することが一般的です。以下はその例です：

http

GET https://graph.microsoft.com/v1.0/me/messages?$filter=receivedDateTime gt '2022-01-01T00:00:00Z'

ここで '2022-01-01T00:00:00Z' は、ISO 8601形式の日付文字列です。

もしも DateTime の比較を行いたい場合、クライアント側で DateTime オブジェクトを生成し、それを文字列に変換してクエリに組み込むことが一般的です。C#の場合、次のようになります：

csharp

DateTime someDate = new DateTime(2022, 1, 1, 0, 0, 0, DateTimeKind.Utc);

string formattedDate = someDate.ToString("yyyy-MM-ddTHH:mm:ssZ");

string query = $"$filter=receivedDateTime gt '{formattedDate}'";

このようにして、DateTime オブジェクトを生成し、それをISO 8601形式に変換してクエリに組み込むことができます。

注意: クライアント側で適切な形式に変換することが大切であり、API側では指定された形式のデータを受け取ります。

お気に入りの記事を「いいね！」で応援しよう