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 um determinado valor de Date.
Sobrecargas
| DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
Retorna um valor inteiro que contém o componente especificado de um determinado valor de |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Retorna um valor que contém o componente especificado de um determinado valor de |
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 um determinado valor de 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
Necessário. 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
Necessário. O valor Date que você deseja avaliar.
- FirstDayOfWeekValue
- FirstDayOfWeek
Opcional. Um valor escolhido da enumeração FirstDayOfWeek que especifica o primeiro dia da semana. Se não for especificado, Sunday será usado.
- FirstWeekOfYearValue
- FirstWeekOfYear
Opcional. Um valor escolhido da enumeração FirstWeekOfYear que especifica a primeira semana do ano. Se não for especificado, Jan1 será usado.
Retornos
Um valor inteiro que contém o componente especificado de um determinado valor de Date.
Exceções
Interval não é válido.
DateValue não é coagido a Date.
Exemplos
Este exemplo usa uma data e, usando a função DatePart, 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 função DatePart 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 argumento Interval, o valor retornado será consistente com os valores da enumeração FirstDayOfWeek. Se você escolher DateInterval.WeekOfYear, DatePart usará as classes Calendar e CultureInfo do namespace System.Globalization para determinar suas configurações atuais.
O argumento FirstDayOfWeekValue afeta cálculos que usam as configurações de DateInterval.Weekday e DateInterval.WeekOfYearInterval. O argumento FirstWeekOfYearValue afeta cálculos que especificam DateInterval.WeekOfYear para Interval.
Como cada valor Date é suportado por uma estrutura DateTime, seus métodos oferecem opções adicionais na recuperação de partes de data/hora. Por exemplo, você pode obter o valor de data inteiro de uma variável Date, 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 argumento Interval pode ter uma das seguintes configurações.
| Valor de enumeração | Corda | Parte do valor de data/hora a ser retornado |
|---|---|---|
DateInterval.Day |
d | Dia do mês (1 a 31) |
DateInterval.DayOfYear |
y | Dia do ano (1 a 366) |
DateInterval.Hour |
h | Hora |
DateInterval.Minute |
n | Minuto |
DateInterval.Month |
m | Mês |
DateInterval.Quarter |
q | Quarto |
DateInterval.Second |
s | Segundo |
DateInterval.Weekday |
w | Dia da semana (1 a 7) |
DateInterval.WeekOfYear |
Ww | Semana do ano (1 a 53) |
DateInterval.Year |
yyyyy | Ano |
O argumento FirstDayOfWeekValue pode ter uma das seguintes configurações.
| 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 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 | Sexta-feira |
FirstDayOfWeek.Saturday |
7 | Sábado |
O argumento FirstWeekOfYearValue pode ter uma das seguintes configurações.
| 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 1º de janeiro ocorre (padrão) |
FirstWeekOfYear.FirstFourDays |
2 | Semana que tem pelo menos quatro dias no ano novo (em conformidade com o ISO standard 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 um determinado valor de 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
Necessário. 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
Necessário. Um valor Date que você deseja avaliar.
- DayOfWeek
- FirstDayOfWeek
Opcional. Um valor escolhido da enumeração FirstDayOfWeek que especifica o primeiro dia da semana. Se não for especificado, Sunday será usado.
- WeekOfYear
- FirstWeekOfYear
Opcional. Um valor escolhido da enumeração FirstWeekOfYear que especifica a primeira semana do ano. Se não for especificado, Jan1 será usado.
Retornos
Um valor inteiro que contém o componente especificado de um determinado valor de Date.
Exceções
Interval é inválido.
DateValue não é coagido a Date.
Exemplos
Este exemplo usa uma data e, usando a função DatePart, 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 função DatePart 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 argumento Interval, o valor retornado será consistente com os valores da enumeração FirstDayOfWeek. Se você escolher DateInterval.WeekOfYear, DatePart usará as classes Calendar e CultureInfo do namespace System.Globalization para determinar suas configurações atuais.
O argumento FirstDayOfWeekValue afeta cálculos que usam as configurações de DateInterval.Weekday e DateInterval.WeekOfYearInterval. O argumento FirstWeekOfYearValue afeta cálculos que especificam DateInterval.WeekOfYear para Interval.
Como cada valor Date é suportado por uma estrutura DateTime, seus métodos oferecem opções adicionais na recuperação de partes de data/hora. Por exemplo, você pode obter o valor de data inteiro de uma variável Date, 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 argumento Interval pode ter uma das seguintes configurações.
| Valor de enumeração | Corda | Parte do valor de data/hora a ser retornado |
|---|---|---|
DateInterval.Day |
d | Dia do mês (1 a 31) |
DateInterval.DayOfYear |
y | Dia do ano (1 a 366) |
DateInterval.Hour |
h | Hora |
DateInterval.Minute |
n | Minuto |
DateInterval.Month |
m | Mês |
DateInterval.Quarter |
q | Quarto |
DateInterval.Second |
s | Segundo |
DateInterval.Weekday |
w | Dia da semana (1 a 7) |
DateInterval.WeekOfYear |
Ww | Semana do ano (1 a 53) |
DateInterval.Year |
yyyyy | Ano |
O argumento FirstDayOfWeekValue pode ter uma das seguintes configurações.
| 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 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 | Sexta-feira |
FirstDayOfWeek.Saturday |
7 | Sábado |
O argumento FirstWeekOfYearValue pode ter uma das seguintes configurações.
| 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 1º de janeiro ocorre (padrão) |
FirstWeekOfYear.FirstFourDays |
2 | Semana que tem pelo menos quatro dias no ano novo (em conformidade com o ISO standard 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)
