DateAndTime.DatePart Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna um valor inteiro que contém o componente especificado de determinado valor Date.
Sobrecargas
| DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
Retorna um valor inteiro que contém o componente especificado de determinado valor |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Retorna um valor que contém o componente especificado de determinado valor |
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
- Origem:
- DateAndTime.vb
- Origem:
- DateAndTime.vb
- Origem:
- DateAndTime.vb
Retorna um valor inteiro que contém o componente especificado de determinado valor 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 IntegerParâmetros
- Interval
- DateInterval
Obrigatórios. Um valor de enumeração DateInterval ou uma expressão de cadeia de caracteres que representa a parte do valor de data/hora que você deseja retornar.
- DateValue
- DateTime
Obrigatórios. O valor Date que você deseja avaliar.
- FirstDayOfWeekValue
- FirstDayOfWeek
Opcional. Um valor escolhido na enumeração de FirstDayOfWeek que especifica o primeiro dia da semana. Se não for especificado, é usado Sunday.
- FirstWeekOfYearValue
- FirstWeekOfYear
Opcional. Um valor escolhido na enumeração de FirstWeekOfYear que especifica a primeira semana do ano. Se não for especificado, é usado Jan1.
Retornos
Um valor inteiro que contém o componente especificado de determinado valor Date.
Exceções
Interval não é válido.
DateValue não é coercível para Date.
Exemplos
Este exemplo usa uma data e, usando a DatePart função , exibe o trimestre do ano em que ela ocorre.
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)
Comentários
Você pode usar a DatePart função para avaliar um valor de data/hora e retornar um componente específico. Por exemplo, você pode usar DatePart para calcular o dia da semana ou a hora atual.
Se você escolher DateInterval.Weekday para o Interval argumento , o valor retornado será consistente com os valores da FirstDayOfWeek enumeração . Se você escolher DateInterval.WeekOfYear, DatePart usará as Calendar classes e CultureInfo do System.Globalization namespace para determinar suas configurações atuais.
O FirstDayOfWeekValue argumento afeta cálculos que usam as DateInterval.Weekday configurações e DateInterval.WeekOfYearInterval . O FirstWeekOfYearValue argumento afeta cálculos que especificam DateInterval.WeekOfYear para Interval.
Como cada Date valor tem suporte de uma DateTime estrutura, seus métodos oferecem opções adicionais para recuperar partes de data/hora. Por exemplo, você pode obter o valor de data inteiro de uma Date variável, com o valor de hora definido como meia-noite, da seguinte maneira:
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
O Interval argumento pode ter uma das configurações a seguir.
| Valor de enumeração | String | Parte do valor de data/hora a ser retornado |
|---|---|---|
DateInterval.Day |
d | Dia do mês (de 1 a 31) |
DateInterval.DayOfYear |
s | Dia do ano (de 1 a 366) |
DateInterval.Hour |
h | Hora |
DateInterval.Minute |
n | Minuto |
DateInterval.Month |
m | Mês |
DateInterval.Quarter |
q | Trimestre |
DateInterval.Second |
s | Segundo |
DateInterval.Weekday |
w | Dia da semana (de 1 a 7) |
DateInterval.WeekOfYear |
ww | Semana do ano (de 1 a 53) |
DateInterval.Year |
yyyy | Year |
O FirstDayOfWeekValue argumento pode ter uma das configurações a seguir.
| Valor de enumeração | Valor | Descrição |
|---|---|---|
FirstDayOfWeek.System |
0 | Primeiro dia da semana especificado nas configurações do sistema |
FirstDayOfWeek.Sunday |
1 | Domingo (padrão) |
FirstDayOfWeek.Monday |
2 | Segunda-feira (em conformidade com o padrão ISO 8601, seção 3.17) |
FirstDayOfWeek.Tuesday |
3 | Terça-feira |
FirstDayOfWeek.Wednesday |
4 | Quarta-feira |
FirstDayOfWeek.Thursday |
5 | Quinta-feira |
FirstDayOfWeek.Friday |
6 | Friday |
FirstDayOfWeek.Saturday |
7 | Sábado |
O FirstWeekOfYearValue argumento pode ter uma das configurações a seguir.
| Valor de enumeração | Valor | Descrição |
|---|---|---|
FirstWeekOfYear.System |
0 | Primeira semana do ano especificada nas configurações do sistema |
FirstWeekOfYear.Jan1 |
1 | Semana em que ocorre 1º de janeiro (padrão) |
FirstWeekOfYear.FirstFourDays |
2 | Semana que tem pelo menos quatro dias no ano novo (está em conformidade com o padrão ISO 8601, seção 3.17) |
FirstWeekOfYear.FirstFullWeek |
3 | Primeira semana completa no ano novo |
Confira também
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Resumo do tipo de dados (Visual Basic)
Aplica-se a
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)
- Origem:
- DateAndTime.vb
- Origem:
- DateAndTime.vb
- Origem:
- DateAndTime.vb
Retorna um valor que contém o componente especificado de determinado valor 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 IntegerParâmetros
- Interval
- String
Obrigatórios. Um valor de enumeração DateInterval ou uma expressão de cadeia de caracteres que representa a parte do valor de data/hora que você deseja retornar.
- DateValue
- Object
Obrigatórios. Um valor Date que você deseja avaliar.
- DayOfWeek
- FirstDayOfWeek
Opcional. Um valor escolhido na enumeração de FirstDayOfWeek que especifica o primeiro dia da semana. Se não for especificado, é usado Sunday.
- WeekOfYear
- FirstWeekOfYear
Opcional. Um valor escolhido na enumeração de FirstWeekOfYear que especifica a primeira semana do ano. Se não for especificado, é usado Jan1.
Retornos
Um valor inteiro que contém o componente especificado de determinado valor Date.
Exceções
Interval é inválido.
DateValue não é coercível para Date.
Exemplos
Este exemplo usa uma data e, usando a DatePart função , exibe o trimestre do ano em que ela ocorre.
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)
Comentários
Você pode usar a DatePart função para avaliar um valor de data/hora e retornar um componente específico. Por exemplo, você pode usar DatePart para calcular o dia da semana ou a hora atual.
Se você escolher DateInterval.Weekday para o Interval argumento , o valor retornado será consistente com os valores da FirstDayOfWeek enumeração. Se você escolher DateInterval.WeekOfYear, DatePart usará as Calendar classes e CultureInfo do System.Globalization namespace para determinar suas configurações atuais.
O FirstDayOfWeekValue argumento afeta cálculos que usam as DateInterval.Weekday configurações e DateInterval.WeekOfYearInterval . O FirstWeekOfYearValue argumento afeta cálculos que especificam DateInterval.WeekOfYear para Interval.
Como cada Date valor tem suporte em uma DateTime estrutura, seus métodos oferecem opções adicionais na recuperação de partes de data/hora. Por exemplo, você pode obter todo o valor de data de uma Date variável, com o valor de hora definido como meia-noite, da seguinte maneira:
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
O Interval argumento pode ter uma das configurações a seguir.
| Valor de enumeração | String | Parte do valor de data/hora a ser retornado |
|---|---|---|
DateInterval.Day |
d | Dia do mês (de 1 a 31) |
DateInterval.DayOfYear |
s | Dia do ano (de 1 a 366) |
DateInterval.Hour |
h | Hora |
DateInterval.Minute |
n | Minuto |
DateInterval.Month |
m | Mês |
DateInterval.Quarter |
q | Trimestre |
DateInterval.Second |
s | Segundo |
DateInterval.Weekday |
w | Dia da semana (de 1 a 7) |
DateInterval.WeekOfYear |
ww | Semana do ano (de 1 a 53) |
DateInterval.Year |
yyyy | Year |
O FirstDayOfWeekValue argumento pode ter uma das configurações a seguir.
| Valor de enumeração | Valor | Descrição |
|---|---|---|
FirstDayOfWeek.System |
0 | Primeiro dia da semana especificado nas configurações do sistema |
FirstDayOfWeek.Sunday |
1 | Domingo (padrão) |
FirstDayOfWeek.Monday |
2 | Segunda-feira (está em conformidade com o ISO standard 8601, seção 3.17) |
FirstDayOfWeek.Tuesday |
3 | Terça-feira |
FirstDayOfWeek.Wednesday |
4 | Quarta-feira |
FirstDayOfWeek.Thursday |
5 | Quinta-feira |
FirstDayOfWeek.Friday |
6 | Friday |
FirstDayOfWeek.Saturday |
7 | Sábado |
O FirstWeekOfYearValue argumento pode ter uma das configurações a seguir.
| Valor de enumeração | Valor | Descrição |
|---|---|---|
FirstWeekOfYear.System |
0 | Primeira semana do ano especificada nas configurações do sistema |
FirstWeekOfYear.Jan1 |
1 | Semana em que ocorre 1º de janeiro (padrão) |
FirstWeekOfYear.FirstFourDays |
2 | Semana que tem pelo menos quatro dias no ano novo (está em conformidade com o padrão ISO 8601, seção 3.17) |
FirstWeekOfYear.FirstFullWeek |
3 | Primeira semana completa no ano novo |
Confira também
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Resumo do tipo de dados (Visual Basic)
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de