|
|
DatePart (Función)
Devuelve un valor de tipo Variant (Integer) que contiene la parte especificada de la fecha dada.
Sintaxis
DatePart(intervalo, fecha[,primerdíasemana[, primerasemanaaño]])
La sintaxis de la función DatePart consta de los siguientes argumentos con nombre:
| Parte | Descripción |
|---|---|
| intervalo | Requerido. Expresión de cadena con el intervalo de tiempo que desea devolver. |
| fecha | Requerido. Tipo de valor Variant (Date) que se desea evaluar. |
| primerdíasemana | Opcional. Una constante que especifica el primer día de la semana. Si no se especifica, se asume que es el domingo. |
| primerasemanaaño | Opcional. Una constante que especifica la primera semana del año. Si no se especifica, se asume que es aquélla en la que se encuentre el 1 de enero. |
Valores
El argumento intervalo toma los siguientes valores:
| Valor | 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íasemana toma los siguientes valores:
| Constante | Valor | Descripción |
|---|---|---|
| vbUseSystem | 0 | Utiliza el valor de la API de NLS. |
| vbSunday | 1 | Domingo (predeterminado) |
| vbMonday | 2 | Lunes |
| vbTuesday | 3 | Martes |
| vbWednesday | 4 | Miércoles |
| vbThursday | 5 | Jueves |
| vbFriday | 6 | Viernes |
| vbSaturday | 7 | Sábado |
El argumento primerasemanaaño toma los siguientes valores:
| Constante | Valor | Descripción |
|---|---|---|
| vbUseSystem | 0 | Utiliza el valor de la API de NLS. |
| vbFirstJan1 | 1 | Empieza con la semana en la que se encuentra el 1 de enero (predeterminado). |
| vbFirstFourDays | 2 | Empieza con la primera semana que tenga al menos cuatro días en el nuevo año. |
| vbFirstFullWeek | 3 | Empieza con la primera semana que esté completamente incluida en el nuevo año. |
Comentarios
Puede utilizar la función DatePart para evaluar una fecha y devolver un intervalo de tiempo específico. Por ejemplo, podría utilizar DatePart para calcular el día de la semana o la hora actual.
El argumento primerdíasemana afecta a los cálculos que utilizan los símbolos de intervalo "w" y "ww".
Si fecha es un literal de fecha, el año que se especifica, pasará a ser una parte permanente de la fecha. Sin embargo, si fecha está encerrada entre comillas dobles ("") y se omite el año, se insertará el año en curso en el código cada vez que se evalúe la expresión fecha. Así es posible escribir código que se pueda usar en años distintos.
Nota Para fecha, si la configuración de la propiedad Calendar es gregoriano, la fecha proporcionada debe ser gregoriano. Si el calendario es Hijri, la fecha proporcionada debe ser Hijri.
La parte de la fecha devuelta está en unidades de periodo de tiempo del actual calendario arábico. Por ejemoplo, si el calendario actual es Hijri y la parte de la fecha devuelta es el año, el valor de año es un año Hijri.