# NQL datetime関数

Datetime関数は、タイムスタンプフィールドから時刻の成分（例えば、時、曜日、月の日など）を返します。 これにより、例えば営業時間、営業週、または月中特定の日など、時間ウィンドウ内のパターンやトレンドを識別することができます。

## 例

過去24時間以内の営業時間中のデバイスパフォーマンスデータを取得します。

{% code overflow="wrap" lineNumbers="true" %}

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

{% endcode %}

## 利用可能な関数

### 時間()

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

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

**NQLクエリの例**: 例えば、9時から17時の営業時間中に発生したすべてのイベントを表示します。

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

{% hint style="info" %}
日にちから時間を抽出するには、クエリに分または時間で表現された時間枠を使用する必要があります。例えば、`during past 7d`の代わりに`during past 168h`を使用してください。
{% endhint %}

### 日()

**説明**: この関数は指定された日付から月の日を抽出します。

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

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

{% code overflow="wrap" lineNumbers="true" %}

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

{% endcode %}

### day\_of\_week()

**説明**: この関数は指定された日付から曜日を抽出します。

**戻り値**: 数字の1は月曜日、7は日曜日を表します。

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

{% code overflow="wrap" lineNumbers="true" %}

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

{% endcode %}

## タイムゾーンパラメーター

デフォルトでは、システムはローカルタイムゾーンの時間値を返し、Datetime関数はローカル時間で値を返します。 関数内で`タイムゾーン`パラメーターを使用して、異なるタイムゾーンを指定します。 Datetime関数は指定されたタイムゾーンで値を返します。 詳しくは、[supported-timezones-in-datetime-functions](https://docs.nexthink.com/platform/ja/understanding-key-data-platform-concepts/nexthink-query-language-nql/nql-functions/nql-date-time-functions/supported-timezones-in-datetime-functions "mention")を参照してください。

{% hint style="info" %}
Datetime関数は、指定されたタイムゾーンでのタイムスタンプの時間成分を取得しますが、時間の選択に使用する時間枠を変更することはありません。

特定の時間選択形式が、クエリに含められた時間枠にどのように影響するかに関しては、[#nqltimeselection-timezones](https://docs.nexthink.com/platform/ja/understanding-key-data-platform-concepts/nql-syntax-overview/nql-time-selection#nqltimeselection-timezones "mention")を参照してください。
{% endhint %}

**例**

ヘルシンキ（EETタイムゾーン）で午前8時にいて、ロンドン（GMTタイムゾーン）の営業時間中のデバイスパフォーマンスデータを取得したい場合。 ロンドンの営業時間にデータを絞り込むには、次のクエリを使用します。

{% code overflow="wrap" lineNumbers="true" %}

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

{% endcode %}

以下の画像は、同じクエリですが`list`句に異なる時間形式が含まれています。 時間枠と戻り値は、時間形式に依存します。

* 時間枠は現在のタイムゾーンの時間を反映します。
* `start_time`は、イベントのタイムスタンプ全体を現在のタイムゾーンで返します。
* `start_time.hour()`は、イベントの時間を現在のタイムゾーンで返します。
* `start_time.hour(timezone = 'GMT')`は、イベントの時間をロンドンのタイムゾーンで返します。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-35e0e9036dd176efa9c9a8f633502362a2571b5f%2FNQL_date_time_function_time_zone_parameter%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
クエリの時間枠選択がDatetime関数で使用されるタイムゾーンのオフセットを含むのに十分な大きさであることを確認してください。
{% endhint %}