Partilhar via


DateAndTime.DatePart Método

Definição

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 Date.

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Retorna um valor que contém o componente especificado de um determinado valor de Date.

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 -> 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

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

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 -> 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

Parâ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

Aplica-se a