DateAndTime.DatePart Método

Origem:

DateAndTime.vb

Origem:

DateAndTime.vb

Origem:

DateAndTime.vb

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

Retornos

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

Exceções

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.

O argumento FirstDayOfWeekValue pode ter uma das seguintes configurações.

O argumento FirstWeekOfYearValue pode ter uma das seguintes configurações.

Confira também

• DateAdd
• DateDiff
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• System
• resumo do tipo de dados (Visual Basic)

Origem:

DateAndTime.vb

Origem:

DateAndTime.vb

Origem:

DateAndTime.vb

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

Retornos

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

Exceções

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.

O argumento FirstDayOfWeekValue pode ter uma das seguintes configurações.

O argumento FirstWeekOfYearValue pode ter uma das seguintes configurações.

Confira também

• DateAdd
• DateDiff
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• System
• resumo do tipo de dados (Visual Basic)