Date (Función)

Devuelve un tipo Variant (Date) que contiene la fecha actual del sistema.

Sintaxis

Date

Comentarios

Utilice la instrucción Date para establecer la fecha del sistema.

El comportamiento de Date, y si el calendario es gregoriano, Date$, no cambia por la

configuración de la propiedad Calendar. Si el calendario es Hijri, Date$ devuelve una
cadena de 10 caracteres del tipo mm-dd-yyyy, donde mm (01-12), dd (01-30) y yyyy
(1400-1523) son los meses, días y años Hijri. El intervalo gregoriano equivalente es del
1 de enero de 1980 al 31 de diciembre del 2099.

DateAdd (Función)
Devuelve un valor de tipo Variant (Date) con una fecha a la que se ha agregado un
intervalo de tiempo especificado.

Sintaxis

DateAdd(intervalo, número, fecha)

La sintaxis de la función DateAdd consta de los siguientes argumentos con nombre:

Parte Descripción
intervalo Requerido. Expresión de cadena que contiene el intervalo de tiempo
que se desea agregar.
número Requerido. Expresión numérica con el número de intervalos que se
desea agregar. Puede ser positiva (para obtener fechas futuras) o
negativa (para obtener fechas pasadas).
fecha Requerido. Valor de tipo Variant (Date) o literal que representa la
fecha en la que se agregó el intervalo.

Valores

El argumento intervalo tiene 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
h Hora
n Minuto
s Segundo

Comentarios

Puede utilizar la función DateAdd para agregar o restar un intervalo de tiempo

especificado de una fecha. Por ejemplo, con DateAdd podría calcular una fecha 30 días
posterior al día de hoy o una hora 45 minutos posterior a la actual.

Si desea agregar días a fecha, puede utilizar Día del año ("y"), Día ("d") o Día de la
semana ("w").

La función DateAdd no devuelve nunca una fecha no válida. En el ejemplo siguiente se

agrega un mes al 31 de enero:

DateAdd("m", 1, "31-ene-95")

En este caso, DateAdd devuelve 28-feb-95 y no 31-feb-95. Si fecha es 31-ene-96,

devolverá 29-feb-96, ya que 1996 es un año bisiesto.

Si la fecha calculada va a resultar inferior al año 100 (esto es, se restan más años que los
que hay en fecha), se produce un error.

Si número no es un valor de tipo Long se redondeará al número entero más cercano

antes de ser evaluado.
Nota El formato del valor devuelto por DateAdd es determinado por la configuración
del Panel de control, no por el formato que se pasa en el argumento fecha.

Nota Para fecha, si la configuración de la propiedad Calendar es gregoriano, la fecha

proporcionada debe ser gregoriana. Si el calendario es Hijri, la fecha proporcionada
debe ser Hijri. Si los valores de mes son nombres, el nombre debe ser consistente con la
cofiguración actual de la propiedad Calenda. Para minimizar la posibilidad de
conflictos de los nombres de mes con la configuración actual de Calendar, introduzca
valores de mes numéricos (formato de fecha corta).

Ejemplo de la función DateAdd

Este ejemplo obtiene una fecha y, utilizando la función DateAdd, muestra una fecha
que corresponde a un número especificado de meses en el futuro.

Dim PrimeraFecha As Date ' Declara las variables.

Dim TipoIntervalo As String
Dim Número As Integer
Dim Msj
TipoIntervalo = "m" ' "m" especifica meses como intervalo.
PrimeraFecha = InputBox("Escriba una fecha")
Número = InputBox("Escriba el número de meses a agregar")
Msj = "Nueva fecha: " & DateAdd(TipoIntervalo, Número, PrimeraFecha)
MsgBox Msj

DateDiff (Función)
Devuelve un valor de tipo Variant (Long) que especifica el número de intervalos de
tiempo entre dos fechas determinadas.

Sintaxis

DateDiff(intervalo, fecha1, fecha2[, primerdíasemana[, primerasemanaaño]])

La sintaxis de la función DateDiff consta de los siguientes argumentos con nombre:

Parte Descripción
Intervalo Requerido. Expresión de cadena con el intervalo de tiempo
utilizado para calcular la diferencia entre fecha1 y fecha2.
Fecha1, fecha2 Requerido; Variant (Date). Las dos fechas que se van a
utilizar en el cálculo.
Primerdíasemana Opcional. Constante que especifica el primer día de la semana.
Si no se especifica, se asume que es el domingo.
Primerasemanaaño Opcional. Constante, que especifica la primera semana del
año. Si no se especifica, se asume que es aquélla en la que se
encuentre el 1 de enero.

Valores

El argumento intervalo toma los valores siguientes:

Intervalo 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íasemana toma los siguientes valores:

Constante Valor Descripción

vbUseSystem 0 Utilice la configuración de la
API de 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

Constante Valor Descripción

vbUseSystem 0 Utilice la configuración de la
API de NLS.
vbFirstJan1
vbFirstFourDays
vbFirstFullWeek
1 Empieza con la semana en la
que se encuentra el 1 de
enero (predeterminado).
2 Empieza con la primera
semana que tenga al menos
cuatro días en el nuevo año.
3 Empieza con la primera
semana que esté
completamente incluida en el
nuevo año.

Comentarios

Puede utilizar la función DateDiff para determinar el número de intervalos

especificados que existen entre dos fechas. Por ejemplo, con DateDiff podría calcular el
número de días entre dos fechas o el número de semanas entre hoy y el final del año.

Si desea saber el número de días entre fecha1 y fecha2, puede utilizar Día del año ("y")
o Día ("d"). Cuando intervalo es Día de la semana ("w"), DateDiff devuelve el número
de semanas entre las dos fechas. Si fecha1 es lunes, DateDiff contará el número de
lunes hasta fecha2. En la cuenta incluirá fecha2, pero no fecha1. Si intervalo es
Semana ("ww"), la función DateDiff devolverá el número de semanas entre las dos
fechas. En este caso contará el número de domingos entre fecha1 y fecha2. DateDiff
contará fecha2 si es domingo, pero no fecha1, aunque sea domingo.

Si fecha1 se refiere a un momento posterior en el tiempo a fecha2, la función DateDiff

devolverá un número negativo.

El argumento primerdíasemana afecta a los cálculos que utilizan "w" y "ww" como
símbolos de intervalo.

Si fecha1 o fecha2 es un literal de fecha, el año, si se especifica, pasará a ser una parte
permanente de la fecha. Sin embargo, si fecha1 o fecha2 está comprendida entre
comillas dobles ("") y se omite el año, se insertará el año en curso en el código cada vez
que se evalúe la expresión fecha1 o fecha2. Así es posible escribir código que se pueda
usar en años distintos.

Cuando compara el 31 de diciembre con el 1 de enero del año siguiente, DateDiff para
un año ("yyyy") devolverá 1 aunque sólo haya pasado un día.

Nota Para fecha1 y fecha2, si la configuración de la propiedad Calendar es

gregoriano, la fecha proporcionada debe ser gregoriano. Si el calendario es Hijri, la
fecha proporcionada debe ser Hijri.

Ejemplo de la función DateDiff

Este ejemplo utiliza la función DateDiff para mostrar el número de días entre una fecha
dada y hoy.
Dim LaFecha As Date ' Declara las variables.
Dim Msj
LaFecha = InputBox("Escriba una fecha")
Msj = "Días desde hoy: " & DateDiff("d", Now, LaFecha)
MsgBox Msj

DatePart (Función)
Devuelve un valor de tipo Variant (Integer) que contiene la parte especificada de la
fecha dada.

Sintaxis

DatePart(intervalo, fecha[,primerdíasemana[, primerasemanaaño]])

La sintaxis de la función DatePart consta de los siguientes argumentos con nombre:

Parte Descripción
intervalo Requerido. Expresión de cadena con el intervalo de tiempo
que desea devolver.
fecha Requerido. Tipo de valor Variant (Date) que se desea
evaluar.
primerdíasemana Opcional. Una constante que especifica el primer día de la
semana. Si no se especifica, se asume que es el domingo.
primerasemanaaño Opcional. Una constante que especifica la primera semana
del año. Si no se especifica, se asume que es aquélla en la
que se encuentre el 1 de enero.

Valores

El argumento intervalo toma 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
h Hora
n Minuto
s Segundo

El argumento primerdíasemana toma los siguientes valores:

Constante Valor Descripción

vbUseSystem 0 Utiliza el valor de la API de 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 primerasemanaaño toma los siguientes valores:

Constante Valor Descripción

vbUseSystem 0 Utiliza el valor de la API de
NLS.
vbFirstJan1 1 Empieza con la semana en la
que se encuentra el 1 de
enero (predeterminado).
vbFirstFourDays 2 Empieza con la primera
semana que tenga al menos
cuatro días en el nuevo año.
vbFirstFullWeek 3 Empieza con la primera
semana que esté
completamente incluida en el
nuevo año.

Comentarios

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íasemana 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 que se especifica, pasará a ser una parte
permanente de la fecha. Sin embargo, si fecha está encerrada entre comillas dobles ("")
y se omite el año, se insertará el año en curso en el código cada vez que se evalúe la
expresión fecha. Así es posible escribir código que se pueda usar en años distintos.

Nota Para fecha, si la configuración de la propiedad Calendar es gregoriano, la fecha

proporcionada debe ser gregoriano. Si el calendario es Hijri, la fecha proporcionada
debe ser Hijri.

La parte de la fecha devuelta está en unidades de periodo de tiempo del actual

calendario arábico. Por ejemoplo, si el calendario actual es Hijri y la parte de la fecha
devuelta es el año, el valor de año es un año Hijri.

Ejemplo de la función DatePart

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

Dim LaFecha As Date ' Declara las variables.

Dim Msj
LaFecha = InputBox("Escriba una fecha:")
Msj = "Trimestre: " & DatePart("q", LaFecha)
MsgBox Msj

Now (Función)
Devuelve un valor de tipo Variant (Date) que especifica la fecha y hora actuales de
acuerdo con la configuración de la fecha y la hora del sistema de su equipo.

Sintaxis

Now