DateSerial (año, mes, día)

Sintaxis básica y Crystal.

Argumentos
Devuelve

Un valor Fecha.

Acción

DateSerial devuelve un valor Fecha para el año, mes y día especificados. También maneja expresiones Date relativas.

Uso(s) típico(s)

Puede usarse DateSerial en lugar de CDate o DateValue para crear un valor Fecha a partir del año, mes y día.

Una característica útil de DateSerial es que el argumento de mes no tiene que estar entre 1 y 12, y el argumento de día no tiene que estar en el rango válido para el número de días del mes. Tales fechas se interpretan como fechas relativas y DateSerial producirá un valor Fecha válido. Esta función puede usarse para realizar diversos cómputos con fechas, sin verificar casos especiales, tales como fin de año, años bisiestos y el número de días de un mes. Examine los siguientes ejemplos de algunas aplicaciones típicas.

Ejemplo(s)

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

DateSerial (1999, 6, 15)
DateSerial (2000, 1 - 7, 15)
DateSerial (1999, 1, 166)

Los tres devuelven la fecha 15 de junio de 1999. El segundo indica que 7 meses antes del 1 de enero de 2000 es el 15 de junio de 1999. El tercero indica que el día 166th de 1999 es el 15 de junio de 1999.

DateSerial (1996 + 12, 2 + 13, 29 + 14)

Devuelve el 12 de abril de 2009. Lo que significa es que 12 años, 13 meses y 14 días a contar del 29 de febrero de 1996 es el 12 de abril de 2009.

Suponga que desea calcular el último día del mes para el campo Fecha/hora {pedidos.FECHA DEL PEDIDO}. Observe que en los cálculos DateSerial(Año(d), Mes(d) + 1, 1) es el primer día del mes siguiente {pedidos.FECHA DEL PEDIDO} y que al restar un día se obtiene el resultado deseado:

Sintaxis básica Rem
Dim d
d = {pedidos.FECHA DEL PEDIDO}
formula = DateSerial(Año(d), Mes(d) + 1, 1 - 1)

Sintaxis Crystal
Local DateTimeVar d := {pedidos.FECHA DEL PEDIDO};
DateSerial(Año(d), Mes(d) + 1, 1 - 1)

Con frecuencia es útil combinar DateSerial con otras funciones de fecha. Por ejemplo, si desea calcular la fecha del último viernes del mes en el campo {pedidos.FECHA DEL PEDIDO}, puede hacer lo siguiente.

El cálculo se realiza encontrando el último día del mes y luego restando un número de días para llegar hasta un día viernes. Ya que algunos meses tienen 5 viernes (ejemplo: octubre de 1999) y otros 4 (ejemplo: noviembre de 1999), este enfoque es más fácil que trabajar a partir del primer día de un mes.

Sintaxis básica Rem
Dim d1, d2
d1 = {pedidos.FECHA DEL PEDIDO}
d2 = DateSerial(Year(d1), Month(d1) + 1, 1 - 1)
formula = d2 - (WeekDay(d2, crFriday) - 1)

Sintaxis Crystal
Local DateTimeVar d := {pedidos.FECHA DEL PEDIDO};
Local DateVar d2;
d2 = DateSerial(Año(d1), Mes(d1) + 1, 1 - 1)
d2 - (DayOfWeek(d2, crFriday) - 1)

Devuelve un valor Fecha 27 de marzo de 1998 si {pedidos.FECHA DEL PEDIDO} es el 18 de marzo de 1998.

Este es un ejemplo que devuelve la fecha del segundo martes del mes 3 meses antes {pedidos.FECHA DEL PEDIDO}:

Sintaxis básica Rem
Dim d1, d2
d1 = {pedidos.FECHA DEL PEDIDO}
d2 = DateSerial(Año(d1), Mes(d1) - 3, 1)
formula = d2 + (2 * 7 - (WeekDay(d2, crTuesday) - 1))

Sintaxis Crystal
Local DateTimeVar d := {pedidos.FECHA DEL PEDIDO};
Local DateVar d2 := DateSerial(Año(d1), Mes(d1) - 3, 1);
d2 + (2 * 7 - (DayOfWeek(d2, crTuesday) - 1))

Devuelve el valor Fecha 9 de diciembre de 1997 si {pedidos.FECHA DEL PEDIDO} es el 18 de marzo de 1998.

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