DateAndTime.DatePart Método

Definição

Espaço de Nomes:: Microsoft.VisualBasic

Assemblagem:: Microsoft.VisualBasic.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Devolve um valor inteiro contendo o componente especificado de um dado Date valor.

Sobrecargas

Name	Description
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)	Devolve um valor inteiro contendo o componente especificado de um dado `Date` valor.
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)	Devolve um valor contendo o componente especificado de um dado `Date` valor.

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Devolve um valor inteiro contendo o componente especificado de um dado Date valor.

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

Parâmetros

Interval: DateInterval

Required. Um valor de enumeração ou uma expressão string que DateInterval represente a parte do valor data/hora que quer devolver.

DateValue: DateTime

Required. O Date valor que queres avaliar.

FirstDayOfWeekValue: FirstDayOfWeek

Optional. Um valor escolhido da FirstDayOfWeek enumeração que especifica o primeiro dia da semana. Se não for especificado, Sunday é usado.

FirstWeekOfYearValue: FirstWeekOfYear

Optional. Um valor escolhido da FirstWeekOfYear enumeração que especifica a primeira semana do ano. Se não for especificado, Jan1 é usado.

Devoluções

Int32

Um valor inteiro contendo o componente especificado de um dado Date valor.

Exceções

ArgumentException

Interval não é válido.

InvalidCastException

DateValue não é coercivo a Date.

Exemplos

Este exemplo pega numa data e, usando a DatePart função, mostra o trimestre do ano em que 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)

Observações

Pode usar a DatePart função para avaliar um valor de data/hora e devolver um componente específico. Por exemplo, pode usar DatePart para calcular o dia da semana ou a hora atual.

Se escolher DateInterval.Weekday para o Interval argumento, o valor devolvido é consistente com os valores da FirstDayOfWeek enumeração. Se escolheres DateInterval.WeekOfYear, DatePart usa as Calendar classes e CultureInfo do System.Globalization namespace para determinar as tuas definições atuais.

O FirstDayOfWeekValue argumento afeta os cálculos que utilizam as DateInterval.Weekday definições e.DateInterval.WeekOfYearInterval O FirstWeekOfYearValue argumento afeta cálculos que especificam DateInterval.WeekOfYear para Interval.

Como cada Date valor é suportado por uma DateTime estrutura, os seus métodos dão-lhe opções adicionais para recuperar partes de data/hora. Por exemplo, pode obter o valor total da data de uma Date variável, com o valor do tempo definido para a meia-noite, da seguinte forma:

Dim CurrDatTim As Date = Now   ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date   ' At midnight.

O Interval argumento pode ter um dos seguintes contextos.

Valor de enumeração	String	Parte do valor data/hora para devolver
`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	Trimestre
`DateInterval.Second`	s	Segundo
`DateInterval.Weekday`	w	Dia da semana (1 a 7)
`DateInterval.WeekOfYear`	ss	Semana do ano (1 a 53)
`DateInterval.Year`	yyyy	Ano

O FirstDayOfWeekValue argumento pode ter um dos seguintes contextos.

Valor de enumeração	Value	Description
`FirstDayOfWeek.System`	0	Primeiro dia da semana especificado nas definições do sistema
`FirstDayOfWeek.Sunday`	1	Domingo (predefinição)
`FirstDayOfWeek.Monday`	2	Segunda-feira (cumpre a norma ISO 8601, secção 3.17)
`FirstDayOfWeek.Tuesday`	3	Tuesday
`FirstDayOfWeek.Wednesday`	4	Quarta-feira
`FirstDayOfWeek.Thursday`	5	Quinta-feira
`FirstDayOfWeek.Friday`	6	Sexta-feira
`FirstDayOfWeek.Saturday`	7	Sábado

O FirstWeekOfYearValue argumento pode ter um dos seguintes contextos.

Valor de enumeração	Value	Description
`FirstWeekOfYear.System`	0	A primeira semana do ano especificada nas definições do sistema
`FirstWeekOfYear.Jan1`	1	Semana em que ocorre 1 de janeiro (padrão)
`FirstWeekOfYear.FirstFourDays`	2	Semana que tenha pelo menos quatro dias no novo ano (cumpra a norma ISO 8601, secção 3.17)
`FirstWeekOfYear.FirstFullWeek`	3	Primeira semana completa do ano novo

Ver também

Aplica-se a

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Devolve um valor contendo o componente especificado de um dado Date valor.

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