DateSerial (Función)

Visual Basic VBLR

DateSerial (Función)

       

Devuelve un tipo Variant (Date) para un año, mes y día especificados.

Sintaxis

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

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

Parte Descripción
año Se requiere; Integer. Número entre 100 y 9999, inclusive o una expresión numérica.
mes Se requiere; Integer. Cualquier expresión numérica.
día Se requiere; Integer. Cualquier expresión numérica.

Comentarios

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

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

DateSerial(1990 - 10, 8 - 2, 1 - 1)

Bajo Windows 98 y Windows NT 5, los años de dos dígitos para el argumento año se interpretan basados en la configuración de la máquina definida por el usuario. Los valores predeterminados son los valores entre 0 y 29, 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 el resto de los argumentos año se usa un año con los cuatro dígitos (por ejemplo, 1800).

Versiones más recientes de Windows interpretan los años de dos dígitos basados en los valores predeterminados descriots anteriormente. Para estar seguro de que la función devuelve el valor apropiado, utilice un año de cuatro dígitos.

Cuando un argumento no esté incluido en el intervalo aceptado normalmente para él, se incrementa hasta la siguiente unidad mayor, según convenga. Por ejemplo, si especifica 35 días, se evalúa como un mes y algunos días, dependiendo de la parte del año donde se aplique. No obstante, si un solo argumento está fuera de su intervalo -32.768 a 32.767 o si la fecha especificada por los tres argumentos, directamente o mediante expresión, no se incluye en el intervalo aceptable de fechas, se produce un error.

Nota   Para fecha, mes y día, 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. Para el aergumento año, los valores entre 0 y 99, inclusive, se interpretan como los años 1400-1499. Para todos los valores año, utilice el año completo de cuatro dígitos (por ejemplo, 1520).