DateAndTime.DatePart Método

Definición

Devuelve un valor Integer que contiene el componente especificado de un valor Date dado.Returns an integer value containing the specified component of a given Date value.

Sobrecargas

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Devuelve un valor Integer que contiene el componente especificado de un valor Date dado.Returns an integer value containing the specified component of a given Date value.

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Devuelve un valor que contiene el componente especificado de un valor de Date dado.Returns an value containing the specified component of a given Date value.

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

Devuelve un valor Integer que contiene el componente especificado de un valor Date dado.Returns an integer value containing the specified component of a given Date value.

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.Required. Valor de enumeración DateInterval o expresión de cadena que representa la parte correspondiente al valor de fecha u hora que se desea devolver.A DateInterval enumeration value or a string expression representing the part of the date/time value you want to return.

DateValue
DateTime

Obligatorio.Required. Valor de Date que se desea evaluar.The Date value that you want to evaluate.

FirstDayOfWeekValue
FirstDayOfWeek

Opcional.Optional. Valor elegido de la enumeración FirstDayOfWeek que especifica el primer día de la semana.A value chosen from the FirstDayOfWeek enumeration that specifies the first day of the week. Si no se especifica, se utiliza Sunday.If not specified, Sunday is used.

FirstWeekOfYearValue
FirstWeekOfYear

Opcional.Optional. Valor elegido de la enumeración FirstWeekOfYear que especifica la primera semana del año.A value chosen from the FirstWeekOfYear enumeration that specifies the first week of the year. Si no se especifica, se utiliza Jan1.If not specified, Jan1 is used.

Devoluciones

Valor Integer que contiene el componente especificado de un valor de Date dado.An integer value containing the specified component of a given Date value.

Excepciones

Interval no es válido.Interval is not valid.

DateValue no está establecido en Date.DateValue is not coercible to 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.This example takes a date and, using the DatePart function, displays the quarter of the year in which it occurs.

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 utilizar la función DatePart para evaluar un valor de fecha y hora y devolver un componente específico.You can use the DatePart function to evaluate a date/time value and return a specific component. Por ejemplo, puede usar DatePart para calcular el día de la semana o la hora actual.For example, you might use DatePart to calculate the day of the week or the current hour.

Si elige DateInterval.Weekday para el argumento Interval, el valor devuelto es coherente con los valores de la enumeración FirstDayOfWeek.If you choose DateInterval.Weekday for the Interval argument, the returned value is consistent with the values of the FirstDayOfWeek enumeration. Si elige DateInterval.WeekOfYear, DatePart utiliza las clases Calendar y CultureInfo del espacio de nombres System.Globalization para determinar la configuración actual.If you choose DateInterval.WeekOfYear, DatePart uses the Calendar and CultureInfo classes of the System.Globalization namespace to determine your current settings.

El argumento FirstDayOfWeekValue afecta a los cálculos que usan DateInterval.Weekday la configuración de Interval y DateInterval.WeekOfYear.The FirstDayOfWeekValue argument affects calculations that use the DateInterval.Weekday and DateInterval.WeekOfYear Interval settings. El argumento FirstWeekOfYearValue afecta a los cálculos que especifican DateInterval.WeekOfYear para Interval.The FirstWeekOfYearValue argument affects calculations that specify DateInterval.WeekOfYear for Interval.

Puesto que cada valor de Date es compatible con una estructura de DateTime, sus métodos proporcionan opciones adicionales para recuperar las partes de fecha y hora.Since every Date value is supported by a DateTime structure, its methods give you additional options in retrieving date/time parts. 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:For example, you can obtain the entire date value of a Date variable, with the time value set to midnight, as follows:

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.The Interval argument can have one of the following settings.

Valor de enumeraciónEnumeration value StringString Parte del valor de fecha y hora que se va a devolverPart of date/time value to return
DateInterval.Day dd Día del mes (de 1 a 31)Day of month (1 through 31)
DateInterval.DayOfYear yy Día (de 1 a 366)Day of year (1 through 366)
DateInterval.Hour hh HourHour
DateInterval.Minute nn MinuteMinute
DateInterval.Month mm MesMonth
DateInterval.Quarter qq TrimestreQuarter
DateInterval.Second ss SecondSecond
DateInterval.Weekday sw Día de la semana (de 1 a 7)Day of week (1 through 7)
DateInterval.WeekOfYear wwww Semana del año (de 1 a 53)Week of year (1 through 53)
DateInterval.Year yyyyyyyy AñoYear

El argumento FirstDayOfWeekValue puede tener una de las siguientes opciones.The FirstDayOfWeekValue argument can have one of the following settings.

Valor de enumeraciónEnumeration value ValorValue DescripciónDescription
FirstDayOfWeek.System 00 Primer día de la semana especificado en la configuración del sistemaFirst day of week specified in system settings
FirstDayOfWeek.Sunday 11 Sunday (valor predeterminado)Sunday (default)
FirstDayOfWeek.Monday 22 Lunes (cumple con la norma ISO 8601, sección 3,17)Monday (complies with ISO standard 8601, section 3.17)
FirstDayOfWeek.Tuesday 33 MartesTuesday
FirstDayOfWeek.Wednesday 44 MiércolesWednesday
FirstDayOfWeek.Thursday 55 JuevesThursday
FirstDayOfWeek.Friday 66 ViernesFriday
FirstDayOfWeek.Saturday 77 SábadoSaturday

El argumento FirstWeekOfYearValue puede tener una de las siguientes opciones.The FirstWeekOfYearValue argument can have one of the following settings.

Valor de enumeraciónEnumeration value ValorValue DescripciónDescription
FirstWeekOfYear.System 00 Primera semana del año especificada en la configuración del sistemaFirst week of year specified in system settings
FirstWeekOfYear.Jan1 11 Semana en que se produce el 1 de enero (valor predeterminado)Week in which January 1 occurs (default)
FirstWeekOfYear.FirstFourDays 22 Semana que tiene al menos cuatro días en el año nuevo (cumple con la norma ISO 8601, sección 3,17)Week that has at least four days in the new year (complies with ISO standard 8601, section 3.17)
FirstWeekOfYear.FirstFullWeek 33 Primera semana completa del año nuevoFirst full week in new year

Consulte también:

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

Devuelve un valor que contiene el componente especificado de un valor de Date dado.Returns an value containing the specified component of a given Date value.

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.Required. Valor de enumeración DateInterval o expresión de cadena que representa la parte correspondiente al valor de fecha u hora que se desea devolver.A DateInterval enumeration value or a string expression representing the part of the date/time value you want to return.

DateValue
Object

Obligatorio.Required. Valor Date que se desea evaluar.A Date value that you want to evaluate.

DayOfWeek
FirstDayOfWeek

Opcional.Optional. Valor elegido de la enumeración FirstDayOfWeek que especifica el primer día de la semana.A value chosen from the FirstDayOfWeek enumeration that specifies the first day of the week. Si no se especifica, se utiliza Sunday.If not specified, Sunday is used.

WeekOfYear
FirstWeekOfYear

Opcional.Optional. Valor elegido de la enumeración FirstWeekOfYear que especifica la primera semana del año.A value chosen from the FirstWeekOfYear enumeration that specifies the first week of the year. Si no se especifica, se utiliza Jan1.If not specified, Jan1 is used.

Devoluciones

Valor Integer que contiene el componente especificado de un valor de Date dado.An integer value containing the specified component of a given Date value.

Excepciones

Interval no es válido.Interval is invalid.

DateValue no está establecido en Date.DateValue is not coercible to 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.This example takes a date and, using the DatePart function, displays the quarter of the year in which it occurs.

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 utilizar la función DatePart para evaluar un valor de fecha y hora y devolver un componente específico.You can use the DatePart function to evaluate a date/time value and return a specific component. Por ejemplo, puede usar DatePart para calcular el día de la semana o la hora actual.For example, you might use DatePart to calculate the day of the week or the current hour.

Si elige DateInterval.Weekday para el argumento Interval, el valor devuelto es coherente con los valores de la enumeración FirstDayOfWeek.If you choose DateInterval.Weekday for the Interval argument, the returned value is consistent with the values of the FirstDayOfWeek enumeration. Si elige DateInterval.WeekOfYear, DatePart utiliza las clases Calendar y CultureInfo del espacio de nombres System.Globalization para determinar la configuración actual.If you choose DateInterval.WeekOfYear, DatePart uses the Calendar and CultureInfo classes of the System.Globalization namespace to determine your current settings.

El argumento FirstDayOfWeekValue afecta a los cálculos que usan DateInterval.Weekday la configuración de Interval y DateInterval.WeekOfYear.The FirstDayOfWeekValue argument affects calculations that use the DateInterval.Weekday and DateInterval.WeekOfYear Interval settings. El argumento FirstWeekOfYearValue afecta a los cálculos que especifican DateInterval.WeekOfYear para Interval.The FirstWeekOfYearValue argument affects calculations that specify DateInterval.WeekOfYear for Interval.

Puesto que cada valor de Date es compatible con una estructura de DateTime, sus métodos proporcionan opciones adicionales para recuperar las partes de fecha y hora.Since every Date value is supported by a DateTime structure, its methods give you additional options in retrieving date/time parts. 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:For example, you can obtain the entire date value of a Date variable, with the time value set to midnight, as follows:

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.The Interval argument can have one of the following settings.

Valor de enumeraciónEnumeration value StringString Parte del valor de fecha y hora que se va a devolverPart of date/time value to return
DateInterval.Day dd Día del mes (de 1 a 31)Day of month (1 through 31)
DateInterval.DayOfYear yy Día (de 1 a 366)Day of year (1 through 366)
DateInterval.Hour hh HourHour
DateInterval.Minute nn MinuteMinute
DateInterval.Month mm MesMonth
DateInterval.Quarter qq TrimestreQuarter
DateInterval.Second ss SecondSecond
DateInterval.Weekday sw Día de la semana (de 1 a 7)Day of week (1 through 7)
DateInterval.WeekOfYear wwww Semana del año (de 1 a 53)Week of year (1 through 53)
DateInterval.Year yyyyyyyy AñoYear

El argumento FirstDayOfWeekValue puede tener una de las siguientes opciones.The FirstDayOfWeekValue argument can have one of the following settings.

Valor de enumeraciónEnumeration value ValorValue DescripciónDescription
FirstDayOfWeek.System 00 Primer día de la semana especificado en la configuración del sistemaFirst day of week specified in system settings
FirstDayOfWeek.Sunday 11 Sunday (valor predeterminado)Sunday (default)
FirstDayOfWeek.Monday 22 Lunes (cumple con la norma ISO 8601, sección 3,17)Monday (complies with ISO standard 8601, section 3.17)
FirstDayOfWeek.Tuesday 33 MartesTuesday
FirstDayOfWeek.Wednesday 44 MiércolesWednesday
FirstDayOfWeek.Thursday 55 JuevesThursday
FirstDayOfWeek.Friday 66 ViernesFriday
FirstDayOfWeek.Saturday 77 SábadoSaturday

El argumento FirstWeekOfYearValue puede tener una de las siguientes opciones.The FirstWeekOfYearValue argument can have one of the following settings.

Valor de enumeraciónEnumeration value ValorValue DescripciónDescription
FirstWeekOfYear.System 00 Primera semana del año especificada en la configuración del sistemaFirst week of year specified in system settings
FirstWeekOfYear.Jan1 11 Semana en que se produce el 1 de enero (valor predeterminado)Week in which January 1 occurs (default)
FirstWeekOfYear.FirstFourDays 22 Semana que tiene al menos cuatro días en el año nuevo (cumple con la norma ISO 8601, sección 3,17)Week that has at least four days in the new year (complies with ISO standard 8601, section 3.17)
FirstWeekOfYear.FirstFullWeek 33 Primera semana completa del año nuevoFirst full week in new year

Consulte también:

Se aplica a