Partilhar via


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

ArgumentException

5

Interval é inválido.

InvalidCastException

13

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 DateAdd (Visual Basic)

Função DateDiff (Visual Basic)

Função Day (Visual Basic)

Função Format

Propriedade agora

Função dia da semana (Visual Basic) 

Função de ano (Visual Basic)

Tipo de dados Data (Visual Basic)

System