DateAndTime.DatePart Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna um valor inteiro que contém o componente especificado de um determinado Date valor.
Sobrecargas
| Nome | Description |
|---|---|
| DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
Retorna um valor inteiro que contém o componente especificado de um determinado |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Retorna um valor que contém o componente especificado de um determinado |
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
Retorna um valor inteiro que contém o componente especificado de um determinado 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 -> intPublic 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 IntegerParâmetros
- Interval
- DateInterval
Required. Um DateInterval valor de enumeração ou uma expressão de cadeia de caracteres que representa a parte do valor de data/hora que você deseja retornar.
- DateValue
- DateTime
Required. O Date valor que você deseja avaliar.
- FirstDayOfWeekValue
- FirstDayOfWeek
Optional. Um valor escolhido da FirstDayOfWeek enumeração que especifica o primeiro dia da semana. Se não for especificado, é usado Sunday.
- FirstWeekOfYearValue
- FirstWeekOfYear
Optional. Um valor escolhido da FirstWeekOfYear enumeração que especifica a primeira semana do ano. Se não for especificado, é usado Jan1.
Retornos
Um valor inteiro que contém o componente especificado de um determinado Date valor.
Exceções
Interval não é válido.
DateValue não é coercível a Date.
Exemplos
Este exemplo usa uma data e, usando a DatePart função, 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 DatePart função 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 o Interval argumento, o valor retornado será consistente com os valores da FirstDayOfWeek enumeração. Se você escolherDateInterval.WeekOfYear, DatePart usará as classes e CultureInfo o CalendarSystem.Globalization namespace para determinar suas configurações atuais.
O FirstDayOfWeekValue argumento afeta cálculos que usam as configurações e DateInterval.WeekOfYearInterval o DateInterval.Weekday uso. O FirstWeekOfYearValue argumento afeta cálculos que especificam DateInterval.WeekOfYear para Interval.
Como cada Date valor tem suporte por uma DateTime estrutura, 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 Date variável, 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 Interval argumento pode ter uma das seguintes configurações.
| Valor de enumeração | String | 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 | Minute |
DateInterval.Month |
m | Mês |
DateInterval.Quarter |
q | Trimestre |
DateInterval.Second |
s | Segunda |
DateInterval.Weekday |
w | Dia da semana (1 a 7) |
DateInterval.WeekOfYear |
ss | Semana do ano (1 a 53) |
DateInterval.Year |
aaaa | Ano |
O FirstDayOfWeekValue argumento pode ter uma das seguintes configurações.
| Valor de enumeração | Value | Description |
|---|---|---|
FirstDayOfWeek.System |
0 | Primeiro dia da semana especificado nas configurações do sistema |
FirstDayOfWeek.Sunday |
1 | Domingo (predefiniçã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 | Friday |
FirstDayOfWeek.Saturday |
7 | Sábado |
O FirstWeekOfYearValue argumento pode ter uma das seguintes configurações.
| Valor de enumeração | Value | Description |
|---|---|---|
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
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Resumo do tipo de dados (Visual Basic)
Aplica-se a
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)
Retorna um valor que contém o componente especificado de um determinado 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 -> intPublic 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 IntegerParâmetros
- Interval
- String
Required. Um DateInterval valor de enumeração ou uma expressão de cadeia de caracteres que representa a parte do valor de data/hora que você deseja retornar.
- DateValue
- Object
Required. Um Date valor que você deseja avaliar.
- DayOfWeek
- FirstDayOfWeek
Optional. Um valor escolhido da FirstDayOfWeek enumeração que especifica o primeiro dia da semana. Se não for especificado, é usado Sunday.
- WeekOfYear
- FirstWeekOfYear
Optional. Um valor escolhido da FirstWeekOfYear enumeração que especifica a primeira semana do ano. Se não for especificado, é usado Jan1.
Retornos
Um valor inteiro que contém o componente especificado de um determinado Date valor.
Exceções
Interval é inválido.
DateValue não é coercível a Date.
Exemplos
Este exemplo usa uma data e, usando a DatePart função, 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 DatePart função 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 o Interval argumento, o valor retornado será consistente com os valores da FirstDayOfWeek enumeração. Se você escolherDateInterval.WeekOfYear, DatePart usará as classes e CultureInfo o CalendarSystem.Globalization namespace para determinar suas configurações atuais.
O FirstDayOfWeekValue argumento afeta cálculos que usam as configurações e DateInterval.WeekOfYearInterval o DateInterval.Weekday uso. O FirstWeekOfYearValue argumento afeta cálculos que especificam DateInterval.WeekOfYear para Interval.
Como cada Date valor tem suporte por uma DateTime estrutura, 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 Date variável, 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 Interval argumento pode ter uma das seguintes configurações.
| Valor de enumeração | String | 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 | Minute |
DateInterval.Month |
m | Mês |
DateInterval.Quarter |
q | Trimestre |
DateInterval.Second |
s | Segunda |
DateInterval.Weekday |
w | Dia da semana (1 a 7) |
DateInterval.WeekOfYear |
ss | Semana do ano (1 a 53) |
DateInterval.Year |
aaaa | Ano |
O FirstDayOfWeekValue argumento pode ter uma das seguintes configurações.
| Valor de enumeração | Value | Description |
|---|---|---|
FirstDayOfWeek.System |
0 | Primeiro dia da semana especificado nas configurações do sistema |
FirstDayOfWeek.Sunday |
1 | Domingo (predefiniçã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 | Friday |
FirstDayOfWeek.Saturday |
7 | Sábado |
O FirstWeekOfYearValue argumento pode ter uma das seguintes configurações.
| Valor de enumeração | Value | Description |
|---|---|---|
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
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Resumo do tipo de dados (Visual Basic)