DatePart
Devuelve la parte especificada de una fecha determinada.
Estructura
DatePart(intervalo, fecha[, primer día de la semana[, primera semana del año]])
Parámetros
intervalo - obligatorio. Expresión de cadena que representa el intervalo de tiempo que deseas obtener. Consulte la sección «Configuración» para ver los valores.
fecha - obligatorio. Expresión de fecha que deseas evaluar.
primer día de la semana - opcional. Constante que especifica el día de la semana. Si no se especifica, se considera que es domingo. Consulte la sección «Configuración» para ver los valores.
primera semana del año - opcional. Constante que indica la primera semana del año. Si no se especifica lo contrario, se considera que la primera semana es aquella en la que cae el 1 de enero.
Valores de los parámetros
El argumento «interval» puede tomar los siguientes valores:
Descripción de la configuración
aaaa Año
q Trimestre
m Mes
Día del año
Día D
w Día laborable
Semana del año
h Hora
n minutos
segundo
El parámetro «firstdayofweek» puede tomar los siguientes valores:
Descripción del valor constante:
vbUseSystemDayOfWeek 0 Utilizar la configuración de la API de soporte de idiomas nacionales (NLS).
vbDomingo 1 Domingo (predeterminado)
Lunes 2 de lunes
Martes 3 de marzo
Miércoles 4 de marzo
jueves 5 de abril
vbViernes 6 Viernes
Sábado 7 de sábado
El parámetro «primera semana del año» puede tomar los siguientes valores:
Descripción del valor constante:
vbUseSystem 0: Utiliza la configuración de la API de soporte de idiomas nacionales (NLS).
vbFirstJan1 1 Comienza por la semana en la que cae el 1 de enero (valor predeterminado).
vbFirstFourDays 2 Empieza por la semana que tenga al menos cuatro días en el nuevo año.
vbFirstFullWeek 3: Empieza con la primera semana completa del nuevo año.
Descripción
Puedes utilizar la función DatePart para evaluar una fecha y obtener un intervalo de tiempo específico. Por ejemplo, puedes utilizar DatePart para calcular el día de la semana o la hora actual.
El argumento «firstdayofweek» afecta a los cálculos que utilizan los símbolos de intervalo «w» y «ww».
Si «date» es un literal de fecha, el año especificado pasa a formar parte permanente de dicha fecha. Sin embargo, si la fecha se escribe 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 de fecha. Esto permite escribir código que se pueda utilizar en diferentes años.
Ejemplo
En este ejemplo se toma una fecha y, mediante la función DatePart, se muestra el trimestre del año en el que se sitúa.
Función GetQuarter(TheDate)
GetQuarter = DatePart("q", TheDate)
End Function. |