指定した日付時刻の、年,月,日など（基準となる単位を指定できます）の数値を返します。
使用例
| 表記例 | 出力例 | 説明 |
|---|---|---|
| DatePart("yyyy",#2015/03/15#) | 2015 | 単位として年（yyyy）を指定した例 |
| DatePart("q",#2015/03/15#) | 1 | 四半期を指定した例。戻り値は1-3月四半期が1、4-6月四半期が2…となります |
| DatePart("m",#2015/03/15#) | 3 | 月を指定した例 |
| DatePart("w",#2015/03/15#) | 1 | 日曜から始まる1週間を基準として（第3引数を省略）週の何日目かを指定した例 |
| DatePart("w",#2015/03/15#,4) | 5 | 水曜から始まる1週間を基準として（第3引数=4）週の何日目かを指定した例 |
| DatePart("ww",#2015/03/15#) | 12 | 日曜から始まる1週間を基準とし（第3引数を省略）、1月1日が属する週をその年の第1週とみなし（第4引数を省略）、その年の何週目かを指定した例 |
| DatePart("ww",#2015/03/15#,4,3) | 10 | 水曜から始まる1週間を基準とし（第3引数=4）、7つすべての曜日を含む（長さが7日である）最初の週をその年の第1週とみなし（第4引数=3）、その年の何週目かを指定した例 |
| DatePart("y",#2015/03/15#) | 75 | 年間通算日（その年の何日目か）を指定した例 |
| DatePart("d",#2015/03/15#) | 14 | 日を指定した例 |
| DatePart("h",#2015/03/15 13:02:03#) | 13 | 時を指定した例 |
| DatePart("n",#2015/03/15 13:02:03#) | 2 | 分を指定した例 |
| DatePart("s",#2015/03/15 13:02:03#) | 3 | 秒を指定した例 |
書式
DatePart(基準単位,日付時刻[,週初日の曜日,年の初週])
基準単位として指定できる値は次の通りです。
DateDiff関数の引数と同じですが、異なる意味になるものもありますので注意してください（週や日に関するもの）。
| 基準単位 | 意味 |
|---|---|
| yyyy | 年 |
| q | 四半期（1月から3月、4月から6月、7月から9月、10月から12月の4区分） |
| m | 月 |
| w | 週日（その週の何日目か） |
| ww | 週（その年の何週目か） |
| y | 年間通算日（その年の何日目か） |
| d | 日 |
| h | 時 |
| n | 分 |
| s | 秒 |
週初日の曜日及び年の初週は、日付がその年の何週目であるかを求める場合に影響します。
このうち週初日の曜日は、週が何曜日から始まるのかを指定する値です。意味は以下の表のようになります。
省略した場合は1としたときと同じく、日曜日を指定したものとみなされます。
| 週初日の曜日 | 指定される曜日 |
|---|---|
| 0 | NLS APIの設定を使用 |
| 1 | 日曜日 |
| 2 | 月曜日 |
| 3 | 火曜日 |
| 4 | 水曜日 |
| 5 | 木曜日 |
| 6 | 金曜日 |
| 7 | 土曜日 |
また、年の初週は、どのような週をその年の最初の週とするかを指定する値です。意味は以下の表のようになります。
省略した場合は1としたときと同じく、1月1日が属する週を指定したものとみなされます。
| 年の初週 | 指定される週 |
|---|---|
| 0 | NLS APIの設定を使用 |
| 1 | 1月1日が属する週 |
| 2 | 4つ以上の曜日を含む（長さが4日以上である）最初の週 |
| 3 | 7つすべての曜日を含む（長さが7日である）最初の週 |
備考
年や時などの値を取得する場合はYear関数やHour関数などで代用できます。
第1引数（基準単位）として指定できる値はDateDiff関数と同じであるものの、一部は意味が異なりますので注意が必要です。
