DateAndTime.DatePart Метод

Определение

Возвращает целочисленное значение, содержащее указанный компонент данного значения типа Date.Returns an integer value containing the specified component of a given Date value.

Перегрузки

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Возвращает целочисленное значение, содержащее указанный компонент данного значения типа Date.Returns an integer value containing the specified component of a given Date value.

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Возвращает значение, содержащее указанный компонент заданного значения типа Date.Returns an value containing the specified component of a given Date value.

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Возвращает целочисленное значение, содержащее указанный компонент данного значения типа Date.Returns an integer value containing the specified component of a given Date value.

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

Обязательный элемент.Required. Значение перечисления DateInterval или строковое выражение, представляющие возвращаемую часть даты или времени.A DateInterval enumeration value or a string expression representing the part of the date/time value you want to return.

DateValue
DateTime

Обязательный элемент.Required. Значение Date, которое требуется вычислить.The Date value that you want to evaluate.

FirstDayOfWeekValue
FirstDayOfWeek

Необязательный параметр.Optional. Значение, выбранное из перечисления FirstDayOfWeek, указывающее первый день недели.A value chosen from the FirstDayOfWeek enumeration that specifies the first day of the week. Если этот параметр не задан, используется значение Sunday.If not specified, Sunday is used.

FirstWeekOfYearValue
FirstWeekOfYear

Необязательный параметр.Optional. Значение, выбранное из перечисления FirstWeekOfYear, указывающее первую неделю года.A value chosen from the FirstWeekOfYear enumeration that specifies the first week of the year. Если этот параметр не задан, используется значение Jan1.If not specified, Jan1 is used.

Возвращаемое значение

Int32

Целочисленное значение, содержащее указанный компонент данного значения типа Date.An integer value containing the specified component of a given Date value.

Исключения

Недопустимый параметр Interval.Interval is not valid.

DateValue не может быть приведен к Date.DateValue is not coercible to Date.

Примеры

Этот пример принимает дату и, используя функцию DatePart, отображает квартал года, в котором он встречается.This example takes a date and, using the DatePart function, displays the quarter of the year in which it occurs.

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 можно использовать для вычисления значения даты и времени и возврата определенного компонента.You can use the DatePart function to evaluate a date/time value and return a specific component. Например, для вычисления дня недели или текущего часа можно использовать DatePart.For example, you might use DatePart to calculate the day of the week or the current hour.

Если для аргумента Interval выбрано DateInterval.Weekday, возвращаемое значение согласуется со значениями перечисления FirstDayOfWeek.If you choose DateInterval.Weekday for the Interval argument, the returned value is consistent with the values of the FirstDayOfWeek enumeration. При выборе DateInterval.WeekOfYear``DatePart использует классы Calendar и CultureInfo пространства имен System.Globalization для определения текущих параметров.If you choose DateInterval.WeekOfYear, DatePart uses the Calendar and CultureInfo classes of the System.Globalization namespace to determine your current settings.

Аргумент FirstDayOfWeekValue влияет на вычисления, в которых используются параметры DateInterval.Weekday и DateInterval.WeekOfYear Interval.The FirstDayOfWeekValue argument affects calculations that use the DateInterval.Weekday and DateInterval.WeekOfYear Interval settings. Аргумент FirstWeekOfYearValue влияет на вычисления, которые задают DateInterval.WeekOfYear для Interval.The FirstWeekOfYearValue argument affects calculations that specify DateInterval.WeekOfYear for Interval.

Поскольку все значения Date поддерживаются структурой DateTime, ее методы предоставляют дополнительные возможности для получения частей даты и времени.Since every Date value is supported by a DateTime structure, its methods give you additional options in retrieving date/time parts. Например, можно получить все значение даты Date переменной со значением времени, установленным в полночь, следующим образом:For example, you can obtain the entire date value of a Date variable, with the time value set to midnight, as follows:

Dim CurrDatTim As Date = Now   ' Current date and time.  
Dim LastMidnight As Date = CurrDatTim.Date   ' At midnight.  

Аргумент Interval может иметь одно из следующих значений.The Interval argument can have one of the following settings.

Значение перечисленияEnumeration value StringString Часть значения даты и времени для возвратаPart of date/time value to return
DateInterval.Day dd День месяца (от 1 до 31)Day of month (1 through 31)
DateInterval.DayOfYear yy День года (от 1 до 366)Day of year (1 through 366)
DateInterval.Hour hh ЧасHour
DateInterval.Minute nn МинутаMinute
DateInterval.Month mm МесяцMonth
DateInterval.Quarter qq КварталQuarter
DateInterval.Second ss СекундаSecond
DateInterval.Weekday ww День недели (от 1 до 7)Day of week (1 through 7)
DateInterval.WeekOfYear wwww Неделя года (от 1 до 53)Week of year (1 through 53)
DateInterval.Year ггггyyyy ГодYear

Аргумент FirstDayOfWeekValue может иметь одно из следующих значений.The FirstDayOfWeekValue argument can have one of the following settings.

Значение перечисленияEnumeration value ЗначениеValue DescriptionDescription
FirstDayOfWeek.System 00 Первый день недели, указанный в параметрах системыFirst day of week specified in system settings
FirstDayOfWeek.Sunday 11 Воскресенье (по умолчанию)Sunday (default)
FirstDayOfWeek.Monday 22 Понедельник (соответствует стандарту ISO 8601, раздел 3,17)Monday (complies with ISO standard 8601, section 3.17)
FirstDayOfWeek.Tuesday 33 ВторникTuesday
FirstDayOfWeek.Wednesday 44 СредаWednesday
FirstDayOfWeek.Thursday 55 ЧетвергThursday
FirstDayOfWeek.Friday 66 ПятницаFriday
FirstDayOfWeek.Saturday 77 СубботаSaturday

Аргумент FirstWeekOfYearValue может иметь одно из следующих значений.The FirstWeekOfYearValue argument can have one of the following settings.

Значение перечисленияEnumeration value ЗначениеValue DescriptionDescription
FirstWeekOfYear.System 00 Первая неделя года, указанная в параметрах системыFirst week of year specified in system settings
FirstWeekOfYear.Jan1 11 Неделя, в которой происходит 1 января (по умолчанию)Week in which January 1 occurs (default)
FirstWeekOfYear.FirstFourDays 22 Неделя, в которой в новом году по крайней мере четыре дня (соответствует стандарту ISO 8601, раздел 3,17)Week that has at least four days in the new year (complies with ISO standard 8601, section 3.17)
FirstWeekOfYear.FirstFullWeek 33 Первая полная неделя в новом годуFirst full week in new year

Дополнительно

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Возвращает значение, содержащее указанный компонент заданного значения типа Date.Returns an value containing the specified component of a given Date value.

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

Обязательный элемент.Required. Значение перечисления DateInterval или строковое выражение, представляющие возвращаемую часть даты или времени.A DateInterval enumeration value or a string expression representing the part of the date/time value you want to return.

DateValue
Object

Обязательный элемент.Required. Значение Date, которое требуется вычислить.A Date value that you want to evaluate.

DayOfWeek
FirstDayOfWeek

Необязательный параметр.Optional. Значение, выбранное из перечисления FirstDayOfWeek, указывающее первый день недели.A value chosen from the FirstDayOfWeek enumeration that specifies the first day of the week. Если этот параметр не задан, используется значение Sunday.If not specified, Sunday is used.

WeekOfYear
FirstWeekOfYear

Необязательный параметр.Optional. Значение, выбранное из перечисления FirstWeekOfYear, указывающее первую неделю года.A value chosen from the FirstWeekOfYear enumeration that specifies the first week of the year. Если этот параметр не задан, используется значение Jan1.If not specified, Jan1 is used.

Возвращаемое значение

Int32

Целочисленное значение, содержащее указанный компонент данного значения типа Date.An integer value containing the specified component of a given Date value.

Исключения

Interval недопустим.Interval is invalid.

DateValue не может быть приведен к Date.DateValue is not coercible to Date.

Примеры

Этот пример принимает дату и, используя функцию DatePart, отображает квартал года, в котором он встречается.This example takes a date and, using the DatePart function, displays the quarter of the year in which it occurs.

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 можно использовать для вычисления значения даты и времени и возврата определенного компонента.You can use the DatePart function to evaluate a date/time value and return a specific component. Например, для вычисления дня недели или текущего часа можно использовать DatePart.For example, you might use DatePart to calculate the day of the week or the current hour.

Если для аргумента Interval выбрано DateInterval.Weekday, возвращаемое значение согласуется со значениями перечисления FirstDayOfWeek.If you choose DateInterval.Weekday for the Interval argument, the returned value is consistent with the values of the FirstDayOfWeek enumeration. При выборе DateInterval.WeekOfYear``DatePart использует классы Calendar и CultureInfo пространства имен System.Globalization для определения текущих параметров.If you choose DateInterval.WeekOfYear, DatePart uses the Calendar and CultureInfo classes of the System.Globalization namespace to determine your current settings.

Аргумент FirstDayOfWeekValue влияет на вычисления, в которых используются параметры DateInterval.Weekday и DateInterval.WeekOfYear Interval.The FirstDayOfWeekValue argument affects calculations that use the DateInterval.Weekday and DateInterval.WeekOfYear Interval settings. Аргумент FirstWeekOfYearValue влияет на вычисления, которые задают DateInterval.WeekOfYear для Interval.The FirstWeekOfYearValue argument affects calculations that specify DateInterval.WeekOfYear for Interval.

Поскольку все значения Date поддерживаются структурой DateTime, ее методы предоставляют дополнительные возможности для получения частей даты и времени.Since every Date value is supported by a DateTime structure, its methods give you additional options in retrieving date/time parts. Например, можно получить все значение даты Date переменной со значением времени, установленным в полночь, следующим образом:For example, you can obtain the entire date value of a Date variable, with the time value set to midnight, as follows:

Dim CurrDatTim As Date = Now   ' Current date and time.  
Dim LastMidnight As Date = CurrDatTim.Date   ' At midnight.  

Аргумент Interval может иметь одно из следующих значений.The Interval argument can have one of the following settings.

Значение перечисленияEnumeration value StringString Часть значения даты и времени для возвратаPart of date/time value to return
DateInterval.Day dd День месяца (от 1 до 31)Day of month (1 through 31)
DateInterval.DayOfYear yy День года (от 1 до 366)Day of year (1 through 366)
DateInterval.Hour hh ЧасHour
DateInterval.Minute nn МинутаMinute
DateInterval.Month mm МесяцMonth
DateInterval.Quarter qq КварталQuarter
DateInterval.Second ss СекундаSecond
DateInterval.Weekday ww День недели (от 1 до 7)Day of week (1 through 7)
DateInterval.WeekOfYear wwww Неделя года (от 1 до 53)Week of year (1 through 53)
DateInterval.Year ггггyyyy ГодYear

Аргумент FirstDayOfWeekValue может иметь одно из следующих значений.The FirstDayOfWeekValue argument can have one of the following settings.

Значение перечисленияEnumeration value ЗначениеValue DescriptionDescription
FirstDayOfWeek.System 00 Первый день недели, указанный в параметрах системыFirst day of week specified in system settings
FirstDayOfWeek.Sunday 11 Воскресенье (по умолчанию)Sunday (default)
FirstDayOfWeek.Monday 22 Понедельник (соответствует стандарту ISO 8601, раздел 3,17)Monday (complies with ISO standard 8601, section 3.17)
FirstDayOfWeek.Tuesday 33 ВторникTuesday
FirstDayOfWeek.Wednesday 44 СредаWednesday
FirstDayOfWeek.Thursday 55 ЧетвергThursday
FirstDayOfWeek.Friday 66 ПятницаFriday
FirstDayOfWeek.Saturday 77 СубботаSaturday

Аргумент FirstWeekOfYearValue может иметь одно из следующих значений.The FirstWeekOfYearValue argument can have one of the following settings.

Значение перечисленияEnumeration value ЗначениеValue DescriptionDescription
FirstWeekOfYear.System 00 Первая неделя года, указанная в параметрах системыFirst week of year specified in system settings
FirstWeekOfYear.Jan1 11 Неделя, в которой происходит 1 января (по умолчанию)Week in which January 1 occurs (default)
FirstWeekOfYear.FirstFourDays 22 Неделя, в которой в новом году по крайней мере четыре дня (соответствует стандарту ISO 8601, раздел 3,17)Week that has at least four days in the new year (complies with ISO standard 8601, section 3.17)
FirstWeekOfYear.FirstFullWeek 33 Первая полная неделя в новом годуFirst full week in new year

Дополнительно

Применяется к