Visual Basic Scripting Edition  

Función DateDiff

Devuelve el número de intervalos entre dos fechas.

DateDiff(intervalo, fecha1, fecha2 [,primerdíadelasemana[, primerasemanadelaño]])

La sintaxis de la función DateDiff se compone de:

Argumentos

intervalo
Necesario. Expresión de cadena que es el intervalo que desea utilizar para calcular las diferencias entre fecha1 y fecha2. Consulte la sección Valores para ver los valores.
fecha1, fecha2
Necesario. Expresiones de fecha. Dos fechas que desee utilizar en el cálculo.
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, la primera semana se asume que es la semana 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
vbUseSystem 0 Usa valores de API de idioma nacional (NLS).
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 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 DateDiff para determinar cuántos intervalos de tiempo especificados existen entre dos fechas. por ejemplo, podría utilizar DateDiff para calcular el número de días entre dos fechas o el número de semanas entre hoy y el final del año.

Para calcular el número de días entre fecha1 y fecha2, puede utilizar Día del año ("y") o Día ("d"). Cuando el intervalo es Día de la semana ("w"), DateDiff devuelve el número de semanas entre las dos fechas. Si fecha1 es un lunes, DateDiff cuenta el número de lunes hasta fecha2. Cuenta fecha2 pero no fecha1. Si intervalo es Semana ("ww"), sin embargo, la función DateDiff devuelve el número de semanas del calendario entre dos fechas. Cuenta el número de domingos entre fecha1 y fecha2. DateDiff cuenta fecha2 si es un domingo; pero no cuenta fecha1, aunque sea un domingo.

Si fecha1 hace referencia a un punto en el tiempo posterior a fecha2, la función DateDiff devuelve un número negativo.

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

Si fecha1 o fecha2 es un literal de fecha, el año especificado se convierte en parte permanente de dicha fecha. Sin embargo, si fecha1 o fecha2 está entre comillas (" ") 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 fecha1 o fecha2. Esto hace que sea posible escribir el código que se puede utilizar en años diferentes.

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

El siguiente ejemplo utiliza la función DateDiff para mostrar el número de días entre una fecha dada y el día de hoy:

Function DiffADate(theDate)
  DiffADate = "Días a partir de hoy: " & DateDiff("d", Ahora, theDate)
End Function

Requisitos

Versión 2

Consulte también

Función DateAdd | Función DatePart

Ayuda de Javascript y Vbscript para Javascripts.astalaweb.com.