NQL 日時関数

日時関数は、タイムスタンプフィールドから時、曜日、月の日付などの特定の時間コンポーネントを返します。 これにより、業務時間、ビジネスウィーク、または特定の日など、時間枠内でのパターンやトレンドを特定することが可能です。

例

過去24時間以内の業務時間におけるデバイスパフォーマンスデータを取得します。

device_performance.events during past 24h
| where start_time.hour() >= 9 and end_time.hour() <= 17

利用可能な関数

hour()

説明: この関数は指定されたタイムスタンプから時間を抽出することを可能にします。

戻り値: 0から23までの数値。

NQLクエリ例: 業務時間中に発生したすべてのイベントを表示します（例: 午前9時から午後5時まで）。

device_performance.events during past 24h
| where start_time.hour() >= 9 and end_time.hour() <= 17

日付から時を抽出するには、クエリ内で分または時間で表現された時間枠を使用する必要があります。例えば、during past 168h を使用する代わりに during past 7d を使用してください。

day()

説明: この関数は、与えられた日付から月の日を抽出することを可能にします。

戻り値: 1から31までの数値。

NQLクエリ例: 月の最初の週からデバイスパフォーマンスデータを取得します。

device_performance.events during past 30d
| where start_time.day() >= 1 and end_time.day() <= 7

day_of_week()

説明: この関数は指定された日にちから曜日を抽出することを可能にします。

戻り値: 1から7までの数値。1は月曜日、7は日曜日を表します。

NQLクエリ例: 月曜日から金曜日などの稼働日からデバイスパフォーマンスデータを取得します。

device_performance.events during past 30d
| where start_time.day_of_week() >= 1 and end_time.day_of_week() < 6

タイムゾーンパラメータ

デフォルトでは、システムはあなたのローカルタイムゾーンで時刻値を返し、日時関数はあなたのローカル時間で値を返します。 関数内でtimezoneパラメーターを提供して異なるタイムゾーンを設定してください。 日時関数は、指定されたタイムゾーンで値を返します。 詳細については、supported-timezones-in-datetime-functions.md を参照してください。

日時関数は指定されたタイムゾーン内のタイムスタンプの時間コンポーネントを取得しますが、時間選択のために使用されるタイムフレームを変更しません。

特定の時間選択フォーマットがクエリ内に含まれる時間枠にどのように影響を与えるかについては、#nqltimeselection-timezones を参照してください。

例

あなたがヘルシンキ（EETタイムゾーン）で午前8時にいて、ロンドン（GMTタイムゾーン）のビジネス時間中のデバイスパフォーマンスデータを取得したいです。 以下のクエリを使用して、ロンドンの業務時間にデータを絞り込みます。

device_performance.events during past 24h
| where start_time.hour(timezone = 'GMT') >= 9 and end_time.hour(timezone = 'GMT') <= 17

以下の画像は、同じクエリを示していますが、異なる時間フォーマットがlist句に含まれています。 返されるタイムフレームと値は時間形式に依存します。

• 時間枠は現在のタイムゾーンの時間を反映しています。

• start_timeは現在のタイムゾーンにおけるイベントの完全なタイムスタンプを返します。

• start_time.hour()は現在のタイムゾーンでのイベントの時間を返します。

• start_time.hour(timezone = 'GMT')はロンドンのタイムゾーンでのイベントの時間を返します。

クエリ内のタイムフレーム選択が日時関数で使用されるタイムゾーンオフセットを含むのに十分な大きさであることを確認してください。