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 en algunos años calendario se puede devolver como semana 53, cuando debería ser la semana 1. Para obtener más información y una solución alternativa, vea Las funciones Formato o ParcFecha pueden devolver un número de semana incorrecto para el lunes pasado en Año. |
Sintaxis
DatePart ( interval, date [, firstdayofweek] [, firstweekofyear] )
La sintaxis de la función ParcFecha tiene estos argumentos:
Argumento |
Descripción |
intervalo |
Requerido. Expresión de cadena que es el intervalo de tiempo que desea devolver. |
fecha |
Requerido. Valor variant (Date) que desea evaluar. |
primer_día_semana |
Opcional. Una 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 de intervalo 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 |
Weekday |
ww |
Semana |
h |
Hora |
n |
Minuto |
s |
Segundo |
El argumento primer_día_semana tiene esta configuración:
Constante |
Valor |
Descripción |
vbUseSystem |
0 |
Use la configuración de la API 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 primera_semana_año tiene esta configuración:
Constante |
Valor |
Descripción |
vbUseSystem |
0 |
Use la configuración de la API NLS. |
vbFirstJan1 |
1 |
Comience 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 año nuevo. |
vbFirstFullWeek |
3 |
Comience con la primera semana completa del año. |
Comentarios
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 primer_día_semana afecta a los cálculos que usan los símbolos de intervalo "w" e "ww".
Si date es una 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 de fecha . Esto permite escribir código que se puede usar en diferentes años.
Nota: Para la fecha, si el valor de la propiedad Calendario es gregoriano, la fecha proporcionada debe ser gregoriana. Si el calendario es Hijri, la fecha suministrada 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 devolverá es el año, el valor del año es un año Hijri.
Ejemplos de consulta
Expression |
Resultados |
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; |
Devuelve el "Año" de los valores de fecha del campo "DateofSale". |
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; |
Devuelve el 'Trimestre' (basado en el 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 "DateofSale". |
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; |
Devuelve el "Día laborable" (de 1 a 7, donde 1 representa el domingo) de los valores de fecha del campo "DateofSale". |
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 "FechaDeVentas". |
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 el valor "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, con 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