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

Elegir la función de fecha correcta

¿Necesita más ayuda?

¿Quiere más opciones?

Explore las ventajas de las suscripciones, examine los cursos de aprendizaje, aprenda a proteger su dispositivo y mucho más.

Las comunidades le ayudan a formular y responder preguntas, enviar comentarios y leer a expertos con conocimientos extensos.