DateAndTime.DatePart Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает целочисленное значение, содержащее указанный компонент заданного 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 для вычисления дня недели или текущего часа.
Если выбрать 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 | Первая полная неделя в новом году |
См. также раздел
- 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 для вычисления дня недели или текущего часа.
Если выбрать 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 | Первая полная неделя в новом году |
См. также раздел
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Сводка по типу данных (Visual Basic)
