Función DatePart
Advertencia
Hay un problema con el uso de esta función. El último lunes en algunos años naturales se puede devolver como la semana 53 cuando debería ser la semana 1. Para obtener más información y una solución alternativa, vea Funciones de Formato o DatePart que pueden devolver un número de semana incorrecto para el último lunes del año. Devuelve un valor Variant (Integer) que contiene la parte especificada de una fecha determinada.
Sintaxis
DatePart(interval, date, [ firstdayofweek, [ firstweekofyear ]])
La sintaxis de la función DatePart tiene estos argumentos con nombre:
| Parte | Descripción |
|---|---|
| interval | Obligatorio. Expresión de cadena que es el intervalo de tiempo que desea devolver. |
| date | Obligatorio. Valor Variant (Date) que desea evaluar. |
| firstdayofweek | Opcional. Constante que especifica el primer día de la semana. Si no se especifica, se usa domingo. |
| firstweekofyear | Opcional. Constante que especifica la primera semana del año. Si no se especifica la primera semana, se presupone que es la semana del 1 de enero. |
Configuración
El argumentointerval tiene esta configuración:
| Configuración | Descripción |
|---|---|
| yyyy | Año |
| q | Trimestre |
| m | Mes |
| y | Día del año |
| d | Día |
| w | Día de la semana |
| ww | Semana |
| h | Hora |
| n | Minuto |
| s | Segundo |
El argumento primerDíaDeLaSemana tiene los siguientes valores:
| Constante | Valor | Descripción |
|---|---|---|
| vbUseSystem | 0 | Se usa la configuración NLS API (compatibilidad con el idioma nacional). |
| vbSunday | 1 | Domingo (valor predeterminado) |
| vbMonday | 2 | lunes |
| vbTuesday | 3 | martes |
| vbWednesday | 4 | miércoles |
| vbThursday | 5 | jueves |
| vbFriday | 6 | viernes |
| vbSaturday | 7 | Sábado |
El argumento firstweekofyear tiene los siguientes valores:
| Constante | Valor | Descripción |
|---|---|---|
| vbUseSystem | 0 | Se usa la configuración NLS API (compatibilidad con el idioma nacional). |
| vbFirstJan1 | 1 | Se comienza con la semana en la que transcurre el 1 enero (predeterminado). |
| vbFirstFourDays | 2 | Se comienza con la primera semana que tenga como mínimo cuatro días en el año nuevo. |
| vbFirstFullWeek | 3 | Se comienza con la primera semana completa del año. |
Observaciones
Use la función DatePart para evaluar una fecha y devolver un intervalo de tiempo específico. Por ejemplo, se puede usar DatePart para calcular el día de la semana o la hora actual.
El argumento primerDíaDeLaSemana afecta a los cálculos que usan los símbolos de intervalo "w" y "ww".
Si date es un literal de fecha, el año especificado se convierte en una parte permanente de dicha fecha. Sin embargo, si date está incluido entre comillas dobles (" ") y se omite el año, el año actual se inserta en el código cada vez que se evalúa la expresión date. Esto permite escribir código que puede usarse en años diferentes.
Nota:
Para la fecha, si la configuración de la propiedad Calendar está establecida en gregoriano, la fecha proporcionada debe ser gregoriana. Si el calendario es Hijri, la fecha especificada tiene que ser Hijri.
La parte de fecha devuelta está expresada en unidades de período de tiempo del calendario árabe actual. Por ejemplo, si el calendario actual es Hijri y la parte de fecha que se tiene que devolver es el año, el valor del año es un año Hijri.
Ejemplo
En este ejemplo, se toma una fecha y, mediante la función DatePart, se muestra el trimestre del año en que tiene lugar.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg
Vea también
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.