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 недопустимо.

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 для вычисления дня недели или текущего часа.

Если выбрать DateInterval.Weekday для аргумента Interval, возвращаемое значение соответствует значениям перечисления FirstDayOfWeek. Если выбрать DateInterval.WeekOfYear, DatePart использует классы Calendar и CultureInfo пространства имен System.Globalization для определения текущих параметров.

Аргумент FirstDayOfWeekValue влияет на вычисления, использующие параметры DateInterval.Weekday и DateInterval.WeekOfYearInterval. Аргумент FirstWeekOfYearValue влияет на вычисления, указывающие DateInterval.WeekOfYear для Interval.

Так как каждое Date значение поддерживается структурой DateTime, его методы предоставляют дополнительные параметры для получения частей даты и времени. Например, можно получить все значение даты переменной 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 гггг Год

Аргумент 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 января (по умолчанию)
FirstWeekOfYear.FirstFourDays 2 Неделя, которая имеет по крайней мере четыре дня в новом году (соответствует стандарту 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 недопустимо.

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 для вычисления дня недели или текущего часа.

Если выбрать DateInterval.Weekday для аргумента Interval, возвращаемое значение соответствует значениям перечисления FirstDayOfWeek. Если выбрать DateInterval.WeekOfYear, DatePart использует классы Calendar и CultureInfo пространства имен System.Globalization для определения текущих параметров.

Аргумент FirstDayOfWeekValue влияет на вычисления, использующие параметры DateInterval.Weekday и DateInterval.WeekOfYearInterval. Аргумент FirstWeekOfYearValue влияет на вычисления, указывающие DateInterval.WeekOfYear для Interval.

Так как каждое Date значение поддерживается структурой DateTime, его методы предоставляют дополнительные параметры для получения частей даты и времени. Например, можно получить все значение даты переменной 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 гггг Год

Аргумент 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 января (по умолчанию)
FirstWeekOfYear.FirstFourDays 2 Неделя, которая имеет по крайней мере четыре дня в новом году (соответствует стандарту ISO 8601, раздел 3.17)
FirstWeekOfYear.FirstFullWeek 3 Первая полная неделя в новом году

См. также раздел

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