DateDiff

Sintaxis básica y Crystal.

Sobrecargas
Argumentos
Devuelve

Un valor Número.

Acción

DateDiff devuelve un número de intervalos de tiempo entre dos fechas especificadas.

Ejemplo(s)

Los siguientes ejemplos son aplicables a las sintaxis básica y Crystal:

Use DateDiff con el tipo de parámetro de intervalo "d" o "a" para encontrar el número de días entre dos fechas:

DateDiff ("d", #10/7/1999#, #10/10/1999#)

Devuelve 3.

Use DateDiff con el tipo de parámetro de intervalo "aaaa" para encontrar el número de años de diferencia entre dos fechas. Este uso de DateDiff es lo mismo que encontrar la diferencia entre el año de fechaHoraFin y el año de fechaHoraInicio.

DateDiff ("aaaa", #10/7/1999#, #2/10/2005#)

Devuelve 6.

DateDiff ("aaaa", #12/31/1999#, #1/1/2000#)

Devuelve 1 (una diferencia de 1 año), aunque sólo hay 1 día de diferencia entre ambas fechas.

DateDiff ("aaaa", #1/1/1999#, #12/31/1999#)

Devuelve 0 (una diferencia de 0 años), aunque hay una diferencia de 364 días.

Suponga que en los ejemplos anteriores la primera fecha es la fecha en la que adquirió un fondo mutuo y que la segunda fecha es la fecha en que lo vendió. La compañía de fondos mutuos debe enviarle un informe anual por cada año en que Ud. poseyó unidades en el fondo. Por lo tanto, en los ejemplos anteriores, Ud. recibiría 7, 2 y 1 informes anuales, respectivamente.

Use DateDiff con el parámetro "t" para encontrar la diferencia del número de trimestres (períodos de 3 meses) entre ambas fechas.

DateDiff ("t", #10/6/1999#, #5/20/2003#)

Devuelve 14.

DateDiff ("t", #3/31/1999#, #4/1/1999#)

Devuelve 1. Las dos fechas caen dentro de trimestres contiguos.

DateDiff ("t", #1/1/1999#, #3/31/1999#)

Devuelve 0. Las dos fechas caen dentro del mismo trimestre.

Suponga que la compañía de fondos mutuos en el ejemplo "aaaa" envío informes trimestrales. Así, en los ejemplos anteriores, tendría que enviar 15, 2 y 1 informes trimestrales, respectivamente.

Use DateDiff con el parámetro "m" para encontrar la diferencia del número de meses entre dos fechas.

DateDiff ("m", #3/15/1999#, #7/13/1999#)

Devuelve 4.

Use DateDiff con el parámetro "s" para calcular el número de semanas entre dos fechas. Por ejemplo, si fechaHoraInicio es un martes, DateDiff cuenta el número de martes entre fechaHoraInicio y fechaHoraFin, sin incluir el martes inicial de fechaHoraInicio. Note, sin embargo, que si fechaHoraFin es un martes, cuenta fechaHoraFin.

DateDiff ("s", #10/19/1999#, #10/25/1999#)

Devuelve 0.

DateDiff ("s", #10/19/1999#, #10/26/1999#)

Devuelve 1.

Use DateDiff con el parámetro "ss" para calcular el número de primerDíaDeLaSemana que existe entre dos fechas. En la función DateDiff, el parámetro "ss" es el único que hace uso del argumento primerDíaDeLaSemana. Todos los demás tipos de parámetros de intervalo la pasan por alto. Por ejemplo, si primerDíaDeLaSemana es crWensday, cuenta el número de días miércoles entre fechaHoraInicio y fechaHoraFin. No cuenta fechaHoraInicio ni siquiera si fechaHoraInicio cae un día miércoles, pero sí cuenta fechaHoraFin si fechaHoraFin cae un día miércoles. Por ejemplo, observe que el 6, 13, 20 y 27 de octubre caen en día miércoles en 1999.

DateDiff ("ss", #10/5/1999#, #10/29/1999#, crWensday)

Devuelve 4.

DateDiff ("ss", #10/6/1999#, #10/29/1999#, crWensday)

Devuelve 3.

DateDiff ("ss", #10/5/1999#, #10/27/1999#, crWensday)

Devuelve 4.

Por ejemplo, suponga que desea calcular el número de días entre la fecha de pedido y la fecha de envío, excluyendo los días sábado y domingo.

Sintaxis básica Rem
Dim d1, d2
d1 = {pedidos.FECHA DEL PEDIDO}
d2 = {Pedidos.Fecha de Envío}
formula = DateDiff("d", d1, d2) - _
          DateDiff("ss", d1, d2, crSaturday) - _
          DateDiff("ss", d1, d2, crSunday)

Sintaxis Crystal
Local DateTimeVar d := {pedidos.FECHA DEL PEDIDO};
Local DateTimeVar d2 := {Pedidos.Fecha de Envío};
DateDiff ("d", d1, d2) -
    DateDiff ("ss", d1, d2, crSaturday) -
    DateDiff ("ss", d1, d2, crSunday)

Comentario

Esta función está diseñada para trabajar exactamente como la función de Visual Basic del mismo nombre.



Seagate Software, Inc.
http://www.seagatesoftware.com
Envíe sus comentarios a:
techpubs@seagatesoftware.com