Função DatePart (Visual Basic)
Retorna um valor Integer contendo o componente especificado de um determinado Date valor.
Public Overloads Function DatePart( _
ByVal Interval As DateInterval, _
ByVal DateValue As DateTime, _
Optional ByVal FirstDayOfWeekValue As FirstDayOfWeek = VbSunday, _
Optional ByVal FirstWeekOfYearValue As FirstWeekOfYear = VbFirstJan1 _
) As Integer
' -or-
Public Overloads Function DatePart( _
ByVal Interval As String, _
ByVal DateValue As Object, _
Optional ByVal DayOfWeek As FirstDayOfWeek = FirstDayOfWeek.Sunday, _
Optional ByVal WeekOfYear As FirstWeekOfYear = FirstWeekOfYear.Jan1 _
) As Integer
Parâmetros
Interval
Obrigatório.DateInterval valor de enumeração ou String expressão de seqüência de caracteres que representa a parte a data / valor temporal você deseja retornar.DateValue
Obrigatório.Date valor que você deseja avaliar.FirstDayOfWeekValue, DayOfWeek
Opcional.Um valor escolhido da enumeração FirstDayOfWeek que especifica o primeiro dia da semana.Se não especificado, FirstDayOfWeek.Sunday é usado.FirstWeekOfYearValue, WeekOfYear
Opcional.Um valor escolhido da enumeração FirstWeekOfYear que especifica o primeiro dia da semana.Se não especificado, FirstWeekOfYear.Jan1 é usado.
Configurações
O argumento Interval pode ter uma das seguintes configurações.
Valor de enumeração |
String |
Parte de data / valor de tempo a retornar |
|---|---|---|
DateInterval.Day |
d |
Dia do mês (de 1 a 31) |
DateInterval.DayOfYear |
y |
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 |
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 (compatível com padrão 8601, Seção 3.17 ISO) |
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 especificado nas configurações do sistema |
FirstWeekOfYear.Jan1 |
1 |
Semana em que 1 º de janeiro ocorre (padrão) |
FirstWeekOfYear.FirstFourDays |
2 |
Semana que tenha pelo menos quatro dias no novo ano (obedece padrão ISO 8601, seção 3.17 ) |
FirstWeekOfYear.FirstFullWeek |
3 |
Primeira semana completa no ano novo |
Exceções
Tipo de exceção |
Número de erro |
Condição |
|---|---|---|
Interval é inválido. |
||
DateValue é não conversível para Date. |
Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.
Comentários
Você pode usar a função DatePart para avaliar uma data / valor de tempo 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 é consistente com os valores da enumeração FirstDayOfWeek.Se você escolher DateInterval.WeekOfYear,DatePart usa as classes Calendar e CultureInfo do espaço de nomes System.Globalization para determinar as configurações atuais.
O argumento FirstDayOfWeekValue afeta cálculos que utilizam o DateInterval.Weekday e configurações DateInterval.WeekOfYearInterval.O argumento FirstWeekOfYearValue afeta cálculos que especificam DateInterval.WeekOfYear para Interval.
Desde que cada valor Date seja suportado por uma estrutura DateTime, seus métodos oferecem opções adicionais na recuperação partes de data/hora.Por exemplo, você pode obter o valor inteiro data de uma variável Date, com o valor de tempo definido para meia-noite, como a seguir:
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
Exemplo
Este exemplo usa uma data e, usando a função DatePart, exibe o trimestre do ano em que ele ocorre.
Dim FirstDate, Msg As String 'Declare variables.
Dim SecondDate As Date
FirstDate = InputBox("Enter a date:")
SecondDate = CDate(FirstDate)
Msg = "Quarter: " & DatePart(DateInterval.Quarter, SecondDate)
MsgBox(Msg)
Requisitos
Namespace: Microsoft.VisualBasic
**Módulo:**DateAndTime
Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)
Consulte também
Referência
Função DateDiff (Visual Basic)
Função dia da semana (Visual Basic)