Compartir a través de

Función DatePart

  • Artículo

Advertencia

Hay un problema con el uso de esta función. El último lunes en algunos años naturales se puede devolver como la semana 53 cuando debería ser la semana 1. Para obtener más información y una solución alternativa, vea Las funciones Format o DatePart pueden devolver un número de semana incorrecto para el último lunes del año. Devuelve un valor Variant (Integer) que contiene la parte especificada de una fecha determinada.

Sintaxis

DatePart(interval, date, [ firstdayofweek, [ firstweekofyear ]])

La sintaxis de la función DatePart tiene estos argumentos con nombre:

Parte Descripción
interval Obligatorio. Expresión de cadena que es el intervalo de tiempo que desea devolver.
date Obligatorio. Valor Variant (Date) que desea evaluar.
firstdayofweek Opcional. Constante que especifica el primer día de la semana. Si no se especifica, se usa domingo.
firstweekofyear Opcional. Constante que especifica la primera semana del año. Si no se especifica la primera semana, se presupone que es la semana del 1 de enero.

Configuración

El argumentointerval 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 Día de la semana
ww Semana
h Hora
n Minuto
s Segundo

El argumento primerDíaDeLaSemana tiene los siguientes valores:

Constante Valor Descripción
vbUseSystem 0 Se usa la configuración NLS API (compatibilidad con el idioma nacional).
vbSunday 1 Domingo (valor 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 los siguientes valores:

Constante Valor Descripción
vbUseSystem 0 Se usa la configuración NLS API (compatibilidad con el idioma nacional).
vbFirstJan1 1 Se comienza con la semana en la que transcurre el 1 enero (predeterminado).
vbFirstFourDays 2 Se comienza con la primera semana que tenga como mínimo cuatro días en el año nuevo.
vbFirstFullWeek 3 Se comienza con la primera semana completa del año.

Observaciones

Use la función DatePart para evaluar una fecha y devolver un intervalo de tiempo específico. Por ejemplo, se puede usar DatePart para calcular el día de la semana o la hora actual.

El argumento primerDíaDeLaSemana afecta a los cálculos que usan los símbolos de intervalo "w" y "ww".

Si date es un literal de fecha, el año especificado se convierte en una parte permanente de dicha fecha. Sin embargo, si date está incluido entre comillas dobles (" ") y se 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 permite escribir código que puede usarse en años diferentes.

Nota:

Para la fecha, si la configuración de la propiedad Calendar está establecida en gregoriano, la fecha proporcionada debe ser gregoriana. Si el calendario es Hijri, la fecha especificada tiene que ser Hijri.

La parte de fecha devuelta está expresada en 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 tiene que devolver es el año, el valor del año es un año Hijri.

Ejemplo:

En este ejemplo, se toma una fecha y, mediante la función DatePart, se muestra el trimestre del año en que tiene lugar.

Dim TheDate As Date    ' Declare variables.
Dim Msg    
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg

Vea también

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.

Las funciones Format o DatePart pueden devolver un número de semana incorrecto para el último lunes del año