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 -> 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
классы CalendarSystem.Globalization и 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 | Первая полная неделя в новом году |
См. также раздел
- 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 -> 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
использует классы CalendarSystem.Globalization и 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 | Первая полная неделя в новом году |
См. также раздел
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Сводка типов данных (Visual Basic)
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по