DateAndTime.DatePart Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve un valor Integer que contiene el componente especificado de un valor Date
dado.
Sobrecargas
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
Devuelve un valor Integer que contiene el componente especificado de un valor |
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
Devuelve un valor que contiene el componente especificado de un valor de |
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
Devuelve un valor Integer que contiene el componente especificado de un valor Date
dado.
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. 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.
- DateValue
- DateTime
Obligatorio. Valor de Date
que se 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 utiliza Sunday.
- FirstWeekOfYearValue
- FirstWeekOfYear
Opcional. Valor elegido de la enumeración FirstWeekOfYear que especifica la primera semana del año. Si no se especifica, se utiliza Jan1.
Devoluciones
Valor Integer que contiene el componente especificado de un valor de Date
dado.
Excepciones
Interval
no es válido.
DateValue
no está establecido en Date
.
Ejemplos
En este ejemplo se toma una fecha y, con la DatePart
función , 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 DatePart
función 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 Interval
argumento , el valor devuelto es coherente con los valores de la FirstDayOfWeek
enumeración. Si elige DateInterval.WeekOfYear
, DatePart
usa las Calendar clases y CultureInfo del System.Globalization espacio de nombres para determinar la configuración actual.
El FirstDayOfWeekValue
argumento afecta a los cálculos que usan la DateInterval.Weekday
configuración y DateInterval.WeekOfYear
Interval
. El FirstWeekOfYearValue
argumento afecta a los cálculos que especifican DateInterval.WeekOfYear
para Interval
.
Dado que cada Date
valor es compatible con una DateTime estructura, sus métodos proporcionan opciones adicionales para recuperar partes de fecha y hora. Por ejemplo, puede obtener el valor de fecha completo de una Date
variable, 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 Interval
argumento puede tener una de las siguientes opciones de configuración.
Valor de enumeración | String | 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 |
s | Día (de 1 a 366) |
DateInterval.Hour |
h | Hora |
DateInterval.Minute |
n | Minute |
DateInterval.Month |
m | Month (Mes) |
DateInterval.Quarter |
q | Quarter (Trimestre) |
DateInterval.Second |
s | Second |
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 | Year |
El FirstDayOfWeekValue
argumento puede tener una de las siguientes opciones de configuración.
Valor de enumeración | Value | 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 FirstWeekOfYearValue
argumento puede tener una de las siguientes opciones de configuración.
Valor de enumeración | Value | 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
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Resumen de tipos de datos (Visual Basic)
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
dado.
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. 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.
- DateValue
- Object
Obligatorio. Valor Date
que se 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 utiliza Sunday.
- WeekOfYear
- FirstWeekOfYear
Opcional. Valor elegido de la enumeración FirstWeekOfYear que especifica la primera semana del año. Si no se especifica, se utiliza Jan1.
Devoluciones
Valor Integer que contiene el componente especificado de un valor de Date
dado.
Excepciones
Interval
no es válido.
DateValue
no está establecido en Date
.
Ejemplos
En este ejemplo se toma una fecha y, con la DatePart
función , 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 DatePart
función 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 Interval
argumento , el valor devuelto es coherente con los valores de la FirstDayOfWeek
enumeración. Si elige DateInterval.WeekOfYear
, DatePart
usa las clases y CultureInfo del System.Globalization espacio de nombres para determinar la Calendar configuración actual.
El FirstDayOfWeekValue
argumento afecta a los cálculos que usan la DateInterval.Weekday
configuración y DateInterval.WeekOfYear
Interval
. El FirstWeekOfYearValue
argumento afecta a los cálculos que especifican DateInterval.WeekOfYear
para Interval
.
Dado que cada Date
valor es compatible con una DateTime estructura, sus métodos proporcionan opciones adicionales para recuperar partes de fecha y hora. Por ejemplo, puede obtener el valor de fecha completo de una Date
variable, 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 Interval
argumento puede tener una de las siguientes opciones de configuración.
Valor de enumeración | String | 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 |
s | Día (de 1 a 366) |
DateInterval.Hour |
h | Hora |
DateInterval.Minute |
n | Minute |
DateInterval.Month |
m | Month (Mes) |
DateInterval.Quarter |
q | Quarter (Trimestre) |
DateInterval.Second |
s | Second |
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 | Year |
El FirstDayOfWeekValue
argumento puede tener una de las siguientes opciones de configuración.
Valor de enumeración | Value | 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 FirstWeekOfYearValue
argumento puede tener una de las siguientes opciones de configuración.
Valor de enumeración | Value | 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 del año nuevo |
Consulte también
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- Resumen de tipos de datos (Visual Basic)
Se aplica a
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de