DateAndTime.DatePart Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает целочисленное значение, содержащее указанный компонент заданного Date значения.
Перегрузки
| Имя | Описание |
|---|---|
| DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
Возвращает целочисленное значение, содержащее указанный компонент заданного |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Возвращает значение, содержащее указанный компонент заданного |
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
- Исходный код:
- DateAndTime.vb
- Исходный код:
- DateAndTime.vb
- Исходный код:
- 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
Optional. Значение, выбранное FirstDayOfWeek из перечисления, указывающее первый день недели. Если этот параметр не задан, используется значение Sunday.
- FirstWeekOfYearValue
- FirstWeekOfYear
Optional. Значение, выбранное 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.WeekOfYearDatePart используется 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 может иметь один из следующих параметров.
| Значение перечисления | String | Часть возвращаемого значения даты и времени |
|---|---|---|
DateInterval.Day |
d | День месяца (от 1 до 31) |
DateInterval.DayOfYear |
г | День года (от 1 до 366) |
DateInterval.Hour |
х | Час |
DateInterval.Minute |
н | Минута |
DateInterval.Month |
m | Месяц |
DateInterval.Quarter |
q | Квартал |
DateInterval.Second |
s | Второе |
DateInterval.Weekday |
w | День недели (от 1 до 7) |
DateInterval.WeekOfYear |
ww | Неделя года (от 1 до 53) |
DateInterval.Year |
гггг | Год |
Аргумент FirstDayOfWeekValue может иметь один из следующих параметров.
| Значение перечисления | Ценность | Description |
|---|---|---|
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 может иметь один из следующих параметров.
| Значение перечисления | Ценность | Description |
|---|---|---|
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
- Исходный код:
- 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
Optional. Значение, выбранное FirstDayOfWeek из перечисления, указывающее первый день недели. Если этот параметр не задан, используется значение Sunday.
- WeekOfYear
- FirstWeekOfYear
Optional. Значение, выбранное 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.WeekOfYearDatePart используется 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 может иметь один из следующих параметров.
| Значение перечисления | String | Часть возвращаемого значения даты и времени |
|---|---|---|
DateInterval.Day |
d | День месяца (от 1 до 31) |
DateInterval.DayOfYear |
г | День года (от 1 до 366) |
DateInterval.Hour |
х | Час |
DateInterval.Minute |
н | Минута |
DateInterval.Month |
m | Месяц |
DateInterval.Quarter |
q | Квартал |
DateInterval.Second |
s | Второе |
DateInterval.Weekday |
w | День недели (от 1 до 7) |
DateInterval.WeekOfYear |
ww | Неделя года (от 1 до 53) |
DateInterval.Year |
гггг | Год |
Аргумент FirstDayOfWeekValue может иметь один из следующих параметров.
| Значение перечисления | Ценность | Description |
|---|---|---|
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 может иметь один из следующих параметров.
| Значение перечисления | Ценность | Description |
|---|---|---|
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)
