DateAndTime.DatePart Método

Definición

Devuelve un valor entero que contiene el componente especificado de un valor de Date determinado.

Sobrecargas

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Devuelve un valor entero que contiene el componente especificado de un valor de Date determinado.

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Devuelve un valor que contiene el componente especificado de un valor de Date determinado.

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Source:
DateAndTime.vb
Source:
DateAndTime.vb
Source:
DateAndTime.vb

Devuelve un valor entero que contiene el componente especificado de un valor de Date determinado.

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

Obligatorio. Un DateInterval valor de enumeración o una expresión de cadena que representa la parte del valor de fecha y hora que desea devolver.

DateValue
DateTime

Obligatorio. Valor de Date que desea evaluar.

FirstDayOfWeekValue
FirstDayOfWeek

Opcional. Valor elegido de la enumeración FirstDayOfWeek que especifica el primer día de la semana. Si no se especifica, se usa Sunday.

FirstWeekOfYearValue
FirstWeekOfYear

Opcional. Valor elegido de la enumeración FirstWeekOfYear que especifica la primera semana del año. Si no se especifica, se usa Jan1.

Devoluciones

Valor entero que contiene el componente especificado de un valor de Date determinado.

Excepciones

Interval no es válido.

DateValue no es coercible para Date.

Ejemplos

En este ejemplo se toma una fecha y, con la función DatePart, se muestra el trimestre del año en el que se produce.

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)

Comentarios

Puede usar la función DatePart para evaluar un valor de fecha y hora y devolver un componente específico. Por ejemplo, puede usar DatePart para calcular el día de la semana o la hora actual.

Si elige DateInterval.Weekday para el argumento Interval, el valor devuelto es coherente con los valores de la enumeración FirstDayOfWeek. Si elige DateInterval.WeekOfYear, DatePart usa las clases Calendar y CultureInfo del espacio de nombres de System.Globalization para determinar la configuración actual.

El argumento FirstDayOfWeekValue afecta a los cálculos que usan la configuración de DateInterval.Weekday y DateInterval.WeekOfYearInterval. El argumento FirstWeekOfYearValue afecta a los cálculos que especifican DateInterval.WeekOfYear para Interval.

Dado que cada Date valor es compatible con una estructura de DateTime, sus métodos proporcionan opciones adicionales para recuperar elementos de fecha y hora. Por ejemplo, puede obtener el valor de fecha completo de una variable de Date, con el valor de hora establecido en medianoche, como se indica a continuación:

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

El argumento Interval puede tener una de las siguientes opciones de configuración.

Valor de enumeración Cuerda Parte del valor de fecha y hora que se va a devolver
DateInterval.Day d Día del mes (de 1 a 31)
DateInterval.DayOfYear y Día del año (de 1 a 366)
DateInterval.Hour h Hora
DateInterval.Minute n Minuto
DateInterval.Month m Mes
DateInterval.Quarter q Cuarto
DateInterval.Second s Segundo
DateInterval.Weekday w Día de la semana (de 1 a 7)
DateInterval.WeekOfYear Ww Semana del año (de 1 a 53)
DateInterval.Year aaaa Año

El argumento FirstDayOfWeekValue puede tener una de las siguientes opciones de configuración.

Valor de enumeración Valor Descripción
FirstDayOfWeek.System 0 Primer día de la semana especificado en la configuración del sistema
FirstDayOfWeek.Sunday 1 Domingo (valor predeterminado)
FirstDayOfWeek.Monday 2 Lunes (cumple con la norma ISO 8601, sección 3.17)
FirstDayOfWeek.Tuesday 3 Martes
FirstDayOfWeek.Wednesday 4 Miércoles
FirstDayOfWeek.Thursday 5 Jueves
FirstDayOfWeek.Friday 6 Viernes
FirstDayOfWeek.Saturday 7 Sábado

El argumento FirstWeekOfYearValue puede tener una de las siguientes opciones de configuración.

Valor de enumeración Valor Descripción
FirstWeekOfYear.System 0 Primera semana del año especificada en la configuración del sistema
FirstWeekOfYear.Jan1 1 Semana en la que se produce el 1 de enero (valor predeterminado)
FirstWeekOfYear.FirstFourDays 2 Semana que tiene al menos cuatro días en el año nuevo (cumple con la norma ISO 8601, sección 3.17)
FirstWeekOfYear.FirstFullWeek 3 Primera semana completa en el año nuevo

Consulte también

Se aplica a

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Source:
DateAndTime.vb
Source:
DateAndTime.vb
Source:
DateAndTime.vb

Devuelve un valor que contiene el componente especificado de un valor de Date determinado.

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

Obligatorio. Un DateInterval valor de enumeración o una expresión de cadena que representa la parte del valor de fecha y hora que desea devolver.

DateValue
Object

Obligatorio. Valor de Date que desea evaluar.

DayOfWeek
FirstDayOfWeek

Opcional. Valor elegido de la enumeración FirstDayOfWeek que especifica el primer día de la semana. Si no se especifica, se usa Sunday.

WeekOfYear
FirstWeekOfYear

Opcional. Valor elegido de la enumeración FirstWeekOfYear que especifica la primera semana del año. Si no se especifica, se usa Jan1.

Devoluciones

Valor entero que contiene el componente especificado de un valor de Date determinado.

Excepciones

Interval no es válido.

DateValue no es coercible para Date.

Ejemplos

En este ejemplo se toma una fecha y, con la función DatePart, se muestra el trimestre del año en el que se produce.

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)

Comentarios

Puede usar la función DatePart para evaluar un valor de fecha y hora y devolver un componente específico. Por ejemplo, puede usar DatePart para calcular el día de la semana o la hora actual.

Si elige DateInterval.Weekday para el argumento Interval, el valor devuelto es coherente con los valores de la enumeración FirstDayOfWeek. Si elige DateInterval.WeekOfYear, DatePart usa las clases Calendar y CultureInfo del espacio de nombres de System.Globalization para determinar la configuración actual.

El argumento FirstDayOfWeekValue afecta a los cálculos que usan la configuración de DateInterval.Weekday y DateInterval.WeekOfYearInterval. El argumento FirstWeekOfYearValue afecta a los cálculos que especifican DateInterval.WeekOfYear para Interval.

Dado que cada Date valor es compatible con una estructura de DateTime, sus métodos proporcionan opciones adicionales para recuperar elementos de fecha y hora. Por ejemplo, puede obtener el valor de fecha completo de una variable de Date, con el valor de hora establecido en medianoche, como se indica a continuación:

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

El argumento Interval puede tener una de las siguientes opciones de configuración.

Valor de enumeración Cuerda Parte del valor de fecha y hora que se va a devolver
DateInterval.Day d Día del mes (de 1 a 31)
DateInterval.DayOfYear y Día del año (de 1 a 366)
DateInterval.Hour h Hora
DateInterval.Minute n Minuto
DateInterval.Month m Mes
DateInterval.Quarter q Cuarto
DateInterval.Second s Segundo
DateInterval.Weekday w Día de la semana (de 1 a 7)
DateInterval.WeekOfYear Ww Semana del año (de 1 a 53)
DateInterval.Year aaaa Año

El argumento FirstDayOfWeekValue puede tener una de las siguientes opciones de configuración.

Valor de enumeración Valor Descripción
FirstDayOfWeek.System 0 Primer día de la semana especificado en la configuración del sistema
FirstDayOfWeek.Sunday 1 Domingo (valor predeterminado)
FirstDayOfWeek.Monday 2 Lunes (cumple con la norma ISO 8601, sección 3.17)
FirstDayOfWeek.Tuesday 3 Martes
FirstDayOfWeek.Wednesday 4 Miércoles
FirstDayOfWeek.Thursday 5 Jueves
FirstDayOfWeek.Friday 6 Viernes
FirstDayOfWeek.Saturday 7 Sábado

El argumento FirstWeekOfYearValue puede tener una de las siguientes opciones de configuración.

Valor de enumeración Valor Descripción
FirstWeekOfYear.System 0 Primera semana del año especificada en la configuración del sistema
FirstWeekOfYear.Jan1 1 Semana en la que se produce el 1 de enero (valor predeterminado)
FirstWeekOfYear.FirstFourDays 2 Semana que tiene al menos cuatro días en el año nuevo (cumple con la norma ISO 8601, sección 3.17)
FirstWeekOfYear.FirstFullWeek 3 Primera semana completa en el año nuevo

Consulte también

Se aplica a