DateAndTime.DatePart Метод

Определение

Возвращает целочисленное значение, содержащее указанный компонент данного значения типа Date.

Перегрузки

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Возвращает целочисленное значение, содержащее указанный компонент данного значения типа Date.

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Возвращает значение, содержащее указанный компонент заданного значения типа Date.

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Возвращает целочисленное значение, содержащее указанный компонент данного значения типа 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.

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

Int32

Целочисленное значение, содержащее указанный компонент данного значения типа 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 и классы System.Globalization пространства имен используются Calendar CultureInfo для определения текущих параметров.

Аргумент FirstDayOfWeekValue влияет на вычисления, использующие DateInterval.Weekday DateInterval.WeekOfYear Interval и параметры. Аргумент 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 да День года (от 1 до 366)
DateInterval.Hour h Час
DateInterval.Minute n Минута
DateInterval.Month m Месяц
DateInterval.Quarter q Quarter
DateInterval.Second s Second
DateInterval.Weekday w День недели (от 1 до 7)
DateInterval.WeekOfYear ww Неделя года (от 1 до 53)
DateInterval.Year гггг 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)

Возвращает значение, содержащее указанный компонент заданного значения типа 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.

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

Int32

Целочисленное значение, содержащее указанный компонент данного значения типа 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 и классы System.Globalization пространства имен используются Calendar CultureInfo для определения текущих параметров.

Аргумент FirstDayOfWeekValue влияет на вычисления, использующие DateInterval.Weekday DateInterval.WeekOfYear Interval и параметры. Аргумент 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 да День года (от 1 до 366)
DateInterval.Hour h Час
DateInterval.Minute n Минута
DateInterval.Month m Месяц
DateInterval.Quarter q Quarter
DateInterval.Second s Second
DateInterval.Weekday w День недели (от 1 до 7)
DateInterval.WeekOfYear ww Неделя года (от 1 до 53)
DateInterval.Year гггг 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 Первая полная неделя в новом году

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

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