Devuelve un tipo de dato Variant (Date) para un año, mes y día especificados.
Sintaxis
DateSerial ( año, mes, día )
Advertencia Asegúrese de que los argumentos están en el rango de valores correcto. Un argumento no válido puede dar como resultado incorrecto.
La sintaxis de la función SerieFecha tiene estos argumentos:
|
Argumento |
Descripción |
|
año |
Requerido. Entero. Número entre 100 y 9999, ambos inclusive, o un expresión numérica. |
|
mes |
Requerido. Entero. Cualquier expresión numérica. |
|
día |
Requerido. Entero. Cualquier expresión numérica. |
Comentarios
Para especificar una fecha, como 31 de diciembre de 1991, el intervalo de números de cadaargumentoDateSerial debe estar en el intervalo aceptado para la unidad; es decir, 1-31 para los días y 1-12 para los meses. Sin embargo, también puede especificar fechas relativas para cada argumento mediante cualquier expresión numérica que represente algún número de días, meses o años antes o después de una fecha determinada.
En el ejemplo siguiente se usan expresiones numéricas en lugar de números de fecha absolutos. Aquí la función SerieFecha devuelve una fecha que es el día anterior al primer día (1 - 1), dos meses antes de agosto (8 - 2), 10 años antes de 1990 (1990 - 10); en otras palabras, 31 de mayo de 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Los años de dos dígitos para el argumento año se interpretan en función de la configuración del equipo definida por el usuario. La configuración predeterminada es que 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 , use un año de cuatro dígitos (por ejemplo, 1800).
Las versiones de Windows anteriores a Windows 2000 interpretan los años de dos dígitos en función de los valores predeterminados descritos anteriormente. Para asegurarse de que la función devuelve el valor correcto, use un año de cuatro dígitos.
Cuando un argumento supera el rango aceptado para ese argumento, se incrementa a la siguiente unidad mayor según corresponda. Por ejemplo, si especifica 35 días, se evalúa como un mes y algún número de días, dependiendo de dónde se aplique en el año. Si alguno de los argumentos está fuera del intervalo de -32.768 a 32.767, se produce un error. Si la fecha especificada por los tres argumentos se encuentra fuera del intervalo aceptable de fechas, se produce un error.
Nota: Para el año, mes y día, si el valor de la propiedad Calendario es gregoriano, se supone que el valor proporcionado es gregoriano. Si el valor de la propiedad Calendario es Hijri, se supone que el valor proporcionado es Hijri.
La parte de fecha devuelta se encuentra en las unidades de período de tiempo del calendario actual de Visual Basic. Por ejemplo, si el calendario actual es Hijri y la parte de fecha que se devolverá es el año, el valor del año es un año Hijri. Para el año del argumento, los valores entre 0 y 99, ambos inclusive, se interpretan como los años 1400-1499. Para todos los demás valores de año , use el año de cuatro dígitos completo (por ejemplo, 1520).
Ejemplo de consulta
|
Expression |
Resultados |
|
SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; |
Devuelve la "fecha" para el año, mes y día especificados en los argumentos de la función y se muestra en la columna "Nueva Fecha". Resultado: "12/13/2018". |
Ejemplo VBA:
Nota: Los ejemplos siguientes muestran el uso de esta función en un módulo de Visual Basic para Aplicaciones (VBA). Para obtener más información sobre cómo trabajar con VBA, seleccione referencia para desarrolladores en la lista desplegable situada junto a búsqueda y escriba uno o varios términos en el cuadro de búsqueda.
En este ejemplo se usa la función SerieFecha para devolver la fecha del año, mes y día especificados.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.
