DateAndTime.DatePart メソッド

定義

指定した Date 値の指定したコンポーネントを含む整数値を返します。

オーバーロード

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

指定した Date 値の指定したコンポーネントを含む整数値を返します。

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

指定した Date 値の指定したコンポーネントを含む値を返します。

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 -> int
Public 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 が無効です。

DateValueDateに強制できません。

次の使用例は、日付を取得し、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を選択した場合、DatePartSystem.Globalization 名前空間の Calendar クラスと CultureInfo クラスを使用して現在の設定を決定します。

FirstDayOfWeekValue 引数は、DateInterval.WeekdayDateInterval.WeekOfYearInterval の設定を使用する計算に影響します。 FirstWeekOfYearValue 引数は、IntervalDateInterval.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 新年の最初の完全な週

こちらもご覧ください

適用対象

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 -> int
Public 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 が無効です。

DateValueDateに強制できません。

次の使用例は、日付を取得し、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を選択した場合、DatePartSystem.Globalization 名前空間の Calendar クラスと CultureInfo クラスを使用して現在の設定を決定します。

FirstDayOfWeekValue 引数は、DateInterval.WeekdayDateInterval.WeekOfYearInterval の設定を使用する計算に影響します。 FirstWeekOfYearValue 引数は、IntervalDateInterval.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 新年の最初の完全な週

こちらもご覧ください

適用対象