Función DateSerial

Devuelve una Variant (Date) de un año, mes y día específicos.

Sintaxis

DateSerial(year, month, day )

La sintaxis de la función DateSerial tiene estos argumentos con nombre:

Parte Descripción
year Obligatorio; Integer. Número entre 100 y 9999, ambos inclusive o una expresión numérica.
month Obligatorio; Integer. Cualquier expresión numérica.
day Obligatorio; Integer. Cualquier expresión numérica.

Comentarios

Para especificar una fecha, como el 31 de diciembre de 1991, el intervalo de números de cada argumentoDateSerial debe estar en el intervalo aceptado para la unidad; es decir, 1–31 para días y 1–12 para meses. Sin embargo, también puede especificar fechas relativas para cada argumento mediante cualquier expresión numérica que represente un número de días, meses o años antes o después de una fecha determinada.

El ejemplo siguiente usa expresiones numéricas en lugar de números de fecha absolutos. En este caso la función DateSerial devuelve una fecha que es el día antes del primer día (1 - 1), dos meses antes de agosto (8 - 2), 10 años antes de 1990 (1990 - 10); es decir, el 31 de mayo de 1980.

En Windows 98 o Windows 2000, los años de dos para el argumento year se interpretan según la configuración del equipo definida por el usuario. De forma predeterminada, los valores entre 0 y 29, ambos inclusive, se interpretan como los años 2000-2029. Los valores predeterminados entre 30 y 99 se interpretan como los años 1930–1999. Para todos los demás argumentos de año, utilice el año completo de cuatro dígitos (por ejemplo, 1800).

Las versiones anteriores de Windows interpretan los años de dos dígitos en función de los valores predeterminados descritos anteriormente. Para garantizar que la función devuelva el valor adecuado, utilice un año de cuatro dígitos.

Cuando alguno de los argumentos supera el rango aceptado para dicho argumento, se incrementa hasta la siguiente unidad de mayor valor que corresponda. Por ejemplo, si especifica 35 días, esto se evaluará como un mes y un determinado número de días, en función de dónde se aplique en el año. En caso de que un argumento simple esté fuera del rango -32.768 a 32.767, se producirá un error. Si la fecha especificada por estos tres argumentos queda fuera del rango de fechas aceptable, se producirá un error.

Nota:

Para el año, mes y día, si la configuración de la propiedad Calendar es gregoriana, se presupone que el valor especificado es del calendario gregoriano. Si la configuración de la propiedad Calendar es Hijri, se presupone que el valor proporcionado es Hijri.

La parte de la fecha devuelta se muestra en unidades de periodo de tiempo del calendario de Visual Basic actual. Por ejemplo, si el calendario actual es Hijri y la parte de fecha que se tiene que devolver es el año, el valor del año es un año Hijri. Para el año del argumento, los valores comprendidos entre 0 y 99, ambos inclusive, se interpretan como los años 1400-1499. Para todos los demás valores de año, utilice el año completo de cuatro dígitos (por ejemplo, 1520).

Ejemplo

Este ejemplo usa la función DateSerial para devolver la fecha del día, mes y año especificados.

Dim MyDate
' MyDate contains the date for February 12, 1969.
MyDate = DateSerial(1969, 2, 12)    ' Return a date.

Vea también

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.