---
title: 日付差SQL
slug: neurons-for-itsm/admin-user-help/jpn/latest/sql
createdAt: 2026-10-29T01:28:23.066Z
---

d**atePart&#x20;**&#x30D1;ラメータと同じ単位の整数値を返します。 戻り値は、最初の日付と時刻から 2 番目の日付と時刻を減算した結果です。 この関数は、DATEDIFF と呼ばれる Microsoft SQL 関数と同じように動作します。

この関数は境界を越える方法を使用して日付の差を計算しますが、Diff 関数 (DiffDays、DiffMinutes、DiffYears など) は全間隔方法を使用します。 境界交差法と全区間法の使用に関する詳細については、「 [日付関数](docId\:C4SWr61vM0CpIcQf6Mgti) 」を参照してください。

## 構文

```bash
DateDiffSQL(日付部分、最初の日付時刻、2 番目の日付時刻、タイムゾーン)
```

## 有効

ビジネス オブジェクト カテゴリの説明については、「有効な対象」に関する注意事項 ( [「有効」に関する注意事項](docId\:y_q2u-OyqqLUwN0aF2Qb7)

| ビジネスオブジェクトカテゴリ                         | はい/いいえ |
| -------------------------------------- | ------ |
| ビジネスルール: 保存前ルール                        | はい     |
| ビジネス ルール: 計算ルール (保存後、ロード時に再計算の有無)      | はい     |
| ビジネス ルール: 計算ルール (保存前または常に、読み込み時に再計算なし) | はい     |
| ビジネス ルール: 計算ルール (保存前または常に、読み込み時に再計算)   | はい     |
| ビジネスルール: ルールの編集                        | はい     |
| ビジネスルール: 初期化ルール                        | はい     |
| ビジネスルール: 読み取り専用ルール                     | はい     |
| ビジネスルール: 必須ルール                         | はい     |
| ビジネスルール: 検証ルール                         | はい     |
| クライアントの表現                              | はい     |
| オブジェクトの権限                              | はい     |
| サービス                                   | はい     |
| LDAP の                                 | はい     |
| 携帯                                     | はい     |
| クイックアクション（UI クイックアクションを除く）             | はい     |
| UI クイックアクション                           | はい     |
| レポート                                   | はい     |
| フィールド参照のない検索/ダッシュボード                   | はい     |
| フィールド参照付き検索/ダッシュボード                    | はい     |

## パラメータ

| パラメータ   | 説明                                                                                                                    |
| ------- | --------------------------------------------------------------------------------------------------------------------- |
| 日付部分    | 間隔の種類。 引用符 (" ") で囲む必要があります。 次の間隔タイプがサポートされています。<br />ミリ秒<br />2番<br />分<br />時間<br />日<br />週<br />月<br />四半期<br />年 |
| 最初の日付時刻 | 比較する最初の日付と時刻。                                                                                                         |
| 秒日時     | 比較する 2 番目の日付と時刻。                                                                                                      |
| タイムゾーン  | (オプション) IANA 形式のタイムゾーン。                                                                                               |

## 戻り値

:::Paragraph{indent="1"}
数値。
:::

:::Paragraph{indent="1"}
f**irstDateTime&#x20;**&#x30D1;ラメータが s**econdDateTime&#x20;**&#x30D1;ラメータより前である場合、返される値は正になります。 f**irstDateTime&#x20;**&#x30D1;ラメータが s**econdDateTime&#x20;**&#x30D1;ラメータの後にある場合、返される値は負になります。 (これは DateDiff() 関数の逆です。)
:::

## 例

:::Paragraph{indent="1"}
クイックアクション内で特定の日付の曜日を計算するには、以下を使用できます。
:::

```bash
$(DateDiffSQL("day", "2012-1-1 12:00 AM", ToString(CurrentDate()) % 7) +1)
```

:::Paragraph{indent="1"}
結果は、日曜日の場合は 1、月曜日の場合は 2 というようになります。
:::
