Devuelve un tipo de dato Variant (Integer) que contiene la parte especificada de una fecha dada.
| Advertencia Hay un problema con el uso de esta función. El último lunes de algunos años naturales se puede devolver como semana 53 cuando debería ser la semana 1. Para obtener más información y una solución alternativa, consulte Formato o ParcFecha Las funciones pueden devolver un número de semana incorrecto para el último lunes del año. |
|---|
Sintaxis
DatePart(interval, date [, firstdayofweek] [, firstweekofyear] )
La sintaxis de la función ParcFecha tiene los siguientes argumentos:
| Argumento | Descripción |
|---|---|
| intervalo | Obligatorio. Expresión de cadena que es el intervalo de tiempo que desea devolver. |
| fecha | Obligatorio. Valor de variante (fecha) que desea evaluar. |
| primer_día_semana | Opcional. Constante que especifica el primer día de la semana. Si no se especifica ningún valor, se supone que es el domingo. |
| primera_semana_año | Opcional. Constante que especifica la primera semana del año. Si no se especifica, se entiende que la primera semana es aquella que contiene el día 1 de enero. |
Configuración
El argumento interval tiene las siguientes configuraciones:
| Opción | Descripción |
|---|---|
| yyyy | Año |
| q | Trimestre |
| m | Mes |
| y | Día del año |
| d | Día |
| w | Weekday |
| ww | Semana |
| h | Hora |
| n | Minuto |
| s | Segundo |
El argumento firstdayofweek tiene estas opciones de configuración:
| Constante | Valor | Descripción |
|---|---|---|
| vbUseSystem | 0 | Use la configuración de 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 firstweekofyear tiene estas configuraciones:
| Constante | Valor | Descripción |
|---|---|---|
| vbUseSystem | 0 | Use la configuración de API de NLS. |
| vbFirstJan1 | 1 | Empiece con la semana en la que se produce el 1 de enero (predeterminado). |
| vbFirstFourDays | 2 | Comience con la primera semana que tenga al menos cuatro días en el nuevo año. |
| vbFirstFullWeek | 3 | Comience con la primera semana completa del año. |
Observaciones
Puede usar la función ParcFecha para evaluar una fecha y devolver un intervalo de tiempo específico. Por ejemplo, puede usar ParcFecha para calcular el día de la semana o la hora actual.
El argumento firstdayofweek afecta a los cálculos que usan los símbolos de intervalo "w" y "ww".
Si la fecha es un literal de fecha, el año especificado se convierte en una parte permanente de esa fecha. Sin embargo, si la fecha está entre comillas dobles (" ") y 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 hace posible escribir código que se puede utilizar en diferentes años.
Nota
Para la fecha, si el valor de la propiedad Calendar es gregoriano, la fecha proporcionada debe ser gregoriana. Si el calendario es Hijri, la fecha proporcionada debe ser Hijri.
La parte de fecha devuelta se encuentra en las 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 va a devolver es el año, el valor del año es un año Hijri.
Ejemplos de consulta
| Expresión | Resultados |
|---|---|
| SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; | Devuelve el "Año" de los valores de fecha del campo "FechaDeVenta". |
| SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; | Devuelve el 'Trimestre' (basado en año calendario) de los valores de fecha del campo "DateofSale". |
| SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; | Devuelve el 'Día del año' (de 1 a 365) de los valores de fecha del campo "DateofSale". |
| SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; | Devuelve el "Día" de los valores de fecha del campo "FechaDeVenta". |
| SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; | Devuelve el 'Día de la semana' (del 1 al 7, donde 1 representa el domingo) de los valores de fecha del campo "FechaDeVenta". |
| SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; | Devuelve el 'Número de semana' (de 1 a 52) de los valores de fecha del campo "FechaDeVenta". |
| SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; | Devuelve la "Hora" de los valores de fecha del campo "DateTime". |
| SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales; | Devuelve los 'minutos' de los valores de fecha del campo "DateTime". |
| SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; | Devuelve los 'segundos' de los valores de fecha del campo "DateTime". |
Ejemplo VBA:
Nota
Los ejemplos siguientes muestran el uso de esta función en un módulo de Visual Basic para Aplicaciones (VBA). Para obtener más información sobre cómo trabajar con VBA, seleccione referencia para desarrolladores en la lista desplegable situada junto a búsqueda y escriba uno o varios términos en el cuadro de búsqueda.
En este ejemplo se toma una fecha y, mediante la función ParcFecha se muestra el trimestre del año en el que se produce.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg