DateAndTime.DatePart メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した Date 値の指定したコンポーネントを含む整数値を返します。
オーバーロード
| DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
指定した |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
指定した |
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
- ソース:
- DateAndTime.vb
- ソース:
- DateAndTime.vb
- ソース:
- DateAndTime.vb
指定した Date 値の指定したコンポーネントを含む整数値を返します。
public static int DatePart (Microsoft.VisualBasic.DateInterval Interval, DateTime DateValue, Microsoft.VisualBasic.FirstDayOfWeek FirstDayOfWeekValue = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear FirstWeekOfYearValue = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);static member DatePart : Microsoft.VisualBasic.DateInterval * DateTime * Microsoft.VisualBasic.FirstDayOfWeek * Microsoft.VisualBasic.FirstWeekOfYear -> intPublic Function DatePart (Interval As DateInterval, DateValue As DateTime, Optional FirstDayOfWeekValue As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Optional FirstWeekOfYearValue As FirstWeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1) As Integerパラメーター
- Interval
- DateInterval
必須。 DateInterval 列挙値、または返す日付/時刻値の一部を表す文字列式。
- DateValue
- DateTime
必須。 評価する Date 値。
- FirstDayOfWeekValue
- FirstDayOfWeek
随意。 週の最初の曜日を指定する FirstDayOfWeek 列挙体から選択された値。 指定しない場合は、Sunday が使用されます。
- FirstWeekOfYearValue
- FirstWeekOfYear
随意。 年の最初の週を指定する FirstWeekOfYear 列挙体から選択された値。 指定しない場合は、Jan1 が使用されます。
戻り値
指定した Date 値の指定したコンポーネントを含む整数値。
例外
Interval が無効です。
DateValue は Dateに強制できません。
例
次の使用例は、日付を取得し、DatePart 関数を使用して、発生する年の四半期を表示します。
Dim DateString, Msg As String
Dim ActualDate As Date
' Enter February 12, 2008, or 2/12/2008.
DateString = InputBox("Enter a date:")
ActualDate = CDate(DateString)
' The first two examples use enumeration values for the interval.
Msg = "Quarter: " & DatePart(DateInterval.Quarter, ActualDate)
' The quarter is 1.
MsgBox(Msg)
Msg = "The day of the month: " & DatePart(DateInterval.Day, ActualDate)
' The day of the month is 12.
MsgBox(Msg)
' The next two examples use string values for the interval parameter.
Msg = "The week of the year: " & DatePart("ww", ActualDate)
' The week of the year is 7.
MsgBox(Msg)
Msg = "The day of the week: " & DatePart("w", ActualDate)
' The day of the week is 3 (Tuesday).
MsgBox(Msg)
注釈
DatePart 関数を使用して、日付/時刻値を評価し、特定のコンポーネントを返すことができます。 たとえば、DatePart を使用して、曜日または現在の時間を計算できます。
Interval 引数に DateInterval.Weekday を選択した場合、戻り値は FirstDayOfWeek 列挙体の値と一致します。
DateInterval.WeekOfYearを選択した場合、DatePart は System.Globalization 名前空間の Calendar クラスと CultureInfo クラスを使用して現在の設定を決定します。
FirstDayOfWeekValue 引数は、DateInterval.Weekday と DateInterval.WeekOfYearInterval の設定を使用する計算に影響します。
FirstWeekOfYearValue 引数は、Intervalの DateInterval.WeekOfYear を指定する計算に影響します。
すべての Date 値は DateTime 構造体でサポートされているため、そのメソッドを使用すると、日付/時刻部分を取得するための追加のオプションが提供されます。 たとえば、次のように、時刻値を午前 0 時に設定して、Date 変数の日付値全体を取得できます。
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
Interval 引数には、次のいずれかの設定を指定できます。
| 列挙値 | 糸 | 返される日付/時刻値の一部 |
|---|---|---|
DateInterval.Day |
d | 月の日 (1 ~ 31) |
DateInterval.DayOfYear |
y | 年の日 (1 から 366) |
DateInterval.Hour |
h | 時 |
DateInterval.Minute |
n | 分 |
DateInterval.Month |
m | 月 |
DateInterval.Quarter |
q | 四半期 |
DateInterval.Second |
s | 秒 |
DateInterval.Weekday |
w | 曜日 (1 ~ 7) |
DateInterval.WeekOfYear |
ww | 年の週 (1 ~ 53) |
DateInterval.Year |
yyyy | 年 |
FirstDayOfWeekValue 引数には、次のいずれかの設定を指定できます。
| 列挙値 | 価値 | 形容 |
|---|---|---|
FirstDayOfWeek.System |
0 | システム設定で指定された週の最初の曜日 |
FirstDayOfWeek.Sunday |
1 | 日曜日 (既定) |
FirstDayOfWeek.Monday |
2 | 月曜日 (ISO 標準 8601、セクション 3.17 に準拠) |
FirstDayOfWeek.Tuesday |
3 | 火曜日 |
FirstDayOfWeek.Wednesday |
4 | 水曜日 |
FirstDayOfWeek.Thursday |
5 | 木曜日 |
FirstDayOfWeek.Friday |
6 | 金曜日 |
FirstDayOfWeek.Saturday |
7 | 土曜日 |
FirstWeekOfYearValue 引数には、次のいずれかの設定を指定できます。
| 列挙値 | 価値 | 形容 |
|---|---|---|
FirstWeekOfYear.System |
0 | システム設定で指定された年の最初の週 |
FirstWeekOfYear.Jan1 |
1 | 1 月 1 日が発生する週 (既定) |
FirstWeekOfYear.FirstFourDays |
2 | 新年に 4 日以上ある週 (ISO 標準 8601、セクション 3.17 に準拠) |
FirstWeekOfYear.FirstFullWeek |
3 | 新年の最初の完全な週 |
こちらもご覧ください
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- データ型の概要 (Visual Basic)
適用対象
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)
- ソース:
- DateAndTime.vb
- ソース:
- DateAndTime.vb
- ソース:
- DateAndTime.vb
指定した Date 値の指定したコンポーネントを含む値を返します。
public static int DatePart (string Interval, object? DateValue, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear WeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);public static int DatePart (string Interval, object DateValue, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear WeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);static member DatePart : string * obj * Microsoft.VisualBasic.FirstDayOfWeek * Microsoft.VisualBasic.FirstWeekOfYear -> intPublic Function DatePart (Interval As String, DateValue As Object, Optional DayOfWeek As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Optional WeekOfYear As FirstWeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1) As Integerパラメーター
- Interval
- String
必須。 DateInterval 列挙値、または返す日付/時刻値の一部を表す文字列式。
- DateValue
- Object
必須。 評価する Date 値。
- DayOfWeek
- FirstDayOfWeek
随意。 週の最初の曜日を指定する FirstDayOfWeek 列挙体から選択された値。 指定しない場合は、Sunday が使用されます。
- WeekOfYear
- FirstWeekOfYear
随意。 年の最初の週を指定する FirstWeekOfYear 列挙体から選択された値。 指定しない場合は、Jan1 が使用されます。
戻り値
指定した Date 値の指定したコンポーネントを含む整数値。
例外
Interval が無効です。
DateValue は Dateに強制できません。
例
次の使用例は、日付を取得し、DatePart 関数を使用して、発生する年の四半期を表示します。
Dim DateString, Msg As String
Dim ActualDate As Date
' Enter February 12, 2008, or 2/12/2008.
DateString = InputBox("Enter a date:")
ActualDate = CDate(DateString)
' The first two examples use enumeration values for the interval.
Msg = "Quarter: " & DatePart(DateInterval.Quarter, ActualDate)
' The quarter is 1.
MsgBox(Msg)
Msg = "The day of the month: " & DatePart(DateInterval.Day, ActualDate)
' The day of the month is 12.
MsgBox(Msg)
' The next two examples use string values for the interval parameter.
Msg = "The week of the year: " & DatePart("ww", ActualDate)
' The week of the year is 7.
MsgBox(Msg)
Msg = "The day of the week: " & DatePart("w", ActualDate)
' The day of the week is 3 (Tuesday).
MsgBox(Msg)
注釈
DatePart 関数を使用して、日付/時刻値を評価し、特定のコンポーネントを返すことができます。 たとえば、DatePart を使用して、曜日または現在の時間を計算できます。
Interval 引数に DateInterval.Weekday を選択した場合、戻り値は FirstDayOfWeek 列挙体の値と一致します。
DateInterval.WeekOfYearを選択した場合、DatePart は System.Globalization 名前空間の Calendar クラスと CultureInfo クラスを使用して現在の設定を決定します。
FirstDayOfWeekValue 引数は、DateInterval.Weekday と DateInterval.WeekOfYearInterval の設定を使用する計算に影響します。
FirstWeekOfYearValue 引数は、Intervalの DateInterval.WeekOfYear を指定する計算に影響します。
すべての Date 値は DateTime 構造体でサポートされているため、そのメソッドを使用すると、日付/時刻部分を取得するための追加のオプションが提供されます。 たとえば、次のように、時刻値を午前 0 時に設定して、Date 変数の日付値全体を取得できます。
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
Interval 引数には、次のいずれかの設定を指定できます。
| 列挙値 | 糸 | 返される日付/時刻値の一部 |
|---|---|---|
DateInterval.Day |
d | 月の日 (1 ~ 31) |
DateInterval.DayOfYear |
y | 年の日 (1 から 366) |
DateInterval.Hour |
h | 時 |
DateInterval.Minute |
n | 分 |
DateInterval.Month |
m | 月 |
DateInterval.Quarter |
q | 四半期 |
DateInterval.Second |
s | 秒 |
DateInterval.Weekday |
w | 曜日 (1 ~ 7) |
DateInterval.WeekOfYear |
ww | 年の週 (1 ~ 53) |
DateInterval.Year |
yyyy | 年 |
FirstDayOfWeekValue 引数には、次のいずれかの設定を指定できます。
| 列挙値 | 価値 | 形容 |
|---|---|---|
FirstDayOfWeek.System |
0 | システム設定で指定された週の最初の曜日 |
FirstDayOfWeek.Sunday |
1 | 日曜日 (既定) |
FirstDayOfWeek.Monday |
2 | 月曜日 (ISO 標準 8601、セクション 3.17 に準拠) |
FirstDayOfWeek.Tuesday |
3 | 火曜日 |
FirstDayOfWeek.Wednesday |
4 | 水曜日 |
FirstDayOfWeek.Thursday |
5 | 木曜日 |
FirstDayOfWeek.Friday |
6 | 金曜日 |
FirstDayOfWeek.Saturday |
7 | 土曜日 |
FirstWeekOfYearValue 引数には、次のいずれかの設定を指定できます。
| 列挙値 | 価値 | 形容 |
|---|---|---|
FirstWeekOfYear.System |
0 | システム設定で指定された年の最初の週 |
FirstWeekOfYear.Jan1 |
1 | 1 月 1 日が発生する週 (既定) |
FirstWeekOfYear.FirstFourDays |
2 | 新年に 4 日以上ある週 (ISO 標準 8601、セクション 3.17 に準拠) |
FirstWeekOfYear.FirstFullWeek |
3 | 新年の最初の完全な週 |
こちらもご覧ください
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- データ型の概要 (Visual Basic)
適用対象
.NET