Función DatePart

Devuelve la parte especificada de una fecha dada.

DatePart(intervalo, fecha[, primerdíadelasemana[, primerasemanadelaño]])

Argumentos

intervalo: Necesario. Expresión de cadena que es el intervalo de tiempo que desea devolver. Consulte la sección Valores para ver los valores.
fecha: Necesario. Expresión de fecha que desea evaluar.
primerdíadelasemana: Opcional. Constante que especifica el día de la semana. Si no se especifica, se asume el domingo. Consulte la sección Valores para ver los valores.
primerasemanadelaño: Opcional. Constante que especifica la primera semana del año. Si no se especifica, se asume que la primera semana es la del 1 de enero. Consulte la sección Valores para ver los valores.

Valores

El argumento intervalo puede tener 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 del año
h	Hora
n	Minuto
s	Segundo

El argumento primerdíadelasemana puede tener los siguientes valores:

Constante	Valor	Descripción
vbUseSystemDayOfWeek	0	Usa valores de API de idioma nacional (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 primerasemanadelaño puede tener los siguientes valores:

Constante	Valor	Descripción
vbUseSystem	0	Usa valores de API de idioma nacional (NLS).
vbFirstJan1	1	Comienza con la semana del 1 de enero (valor predeterminado).
vbFirstFourDays	2	Comienza con la semana que tiene al menos cuatro días en el nuevo año.
vbFirstFullWeek	3	Comienza con la primera semana completa del nuevo año.

Observaciones

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íadelasemana 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 especificado se convierte en una parte permanente de dicha fecha. Sin embargo, si fecha está entre comillas (" ") y omite el año, se inserta el año actual en su código cada vez que se evalúe la expresión fecha. Esto hace que sea posible escribir código que se pueda utilizar en años diferentes.

Este ejemplo toma una fecha y, utilizando la función DatePart, muestra el trimestre del año al que pertenece.

Function GetQuarter(TheDate)
   GetQuarter = DatePart("q", TheDate)
End Function

Requisitos

Versión 2

Consulte también

Función DateAdd | Función DateDiff