Elemento input (type=date)

Si no sabes lo que es un elemento o cómo debes usarlo, te recomiendo leer el tutorial "Tags y atributos en HTML" que puedes encontrar en la sección de tutoriales HTML.

Descripción

El elemento input, teniendo el valor "date" en su atributo type, representa un campo para la entrada de una fecha. En los navegadores modernos los campos de fecha son habitualmente representados por controles que permiten a los usuarios cambiar su valor de manera gráfica (como, por ejemplo, un calendario), en lugar de tener que ingresarlo directamente como una cadena.

Previo al envío del formulario, los navegadores que soportan este mecanismo convierten la información ingresada a una cadena que representa una fecha. Las reglas para componer una fecha válida se describen a continuación.

Fechas

La sintaxis de una fecha está compuesta por:

  1. Una sintaxis válida de mes representando un año y un mes.
  2. Un signo menos o guión ("-").
  3. Un día de dos dígitos entre 1 y el número de días del mes y año previamente especificados.

Ejemplo

<time>2014-07-05</time>
<time>1920-12-31</time>

Meses

La sintaxis de un mes está compuesta por:

  1. Un año mayor que cero, compuesto por, al menos, cuatro dígitos.
  2. Un signo menos o guión ("-").
  3. Un mes entre 1 y 12, compuesto de dos dígitos.

Ejemplo

<time>2014-07</time>
<time>0512-12</time>

El soporte provisto por los navegadores para campos de fecha es incompleto. Para mejorar la compatibilidad, los autores pueden tener que recurrir a programas con el fin de proveer controles avanzados y validar los datos antes del envío.

Los atributos min y max pueden ser usados en este elemento para establecer un rango de fechas válidas que el usuario tendrá permitido enviar.

Ejemplos

En el primer ejemplo crearemos solamente un formulario con un control de fecha. Aquí podrás notar la funcionalidad provista por tu navegador (si la tiene) para el control.

<form action="../../form-result.php" method="post" target="_blank">
  <p>Fecha esperada: <input type="date" name="fechaesperada"> <input type="submit" value="Enviar datos"></p>
</form>

Fecha esperada:

En nuestro segundo ejemplo proveeremos una lista de valores sugeridos mediante el elemento datalist, para que el usuario pueda seleccionar rápidamente uno de los valores predefinidos cuando el navegador los sugiera. El control estará enlazado al datalist debido a la coincidencia entre el atributo id de la lista y el atributo list del control.

El soporte provisto por los navegadores para datalist es incompleto. Los autores pueden tener que recurrir a programas para proveer esta funcionalidad consistentemente.

Los valores provistos por el elemento datalist deben acatar los requerimientos de las cadenas de fecha.

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Haz una cita: <input type="date" name="fechacita" list="listafechascita">
    <input type="submit" value="Enviar datos">
  </p>
</form>
<datalist id="listafechascita">
  <option value="2015-05-05">
  <option value="2015-05-12">
  <option value="2015-05-19">
  <option value="2015-05-26">
</datalist>

Haz una cita:

En nuestro último ejemplo trabajaremos con los atributos min, max y step para poner restricciones a los valores que el usuario puede ingresar. Con esta configuración estableceremos una fecha mínima, una fecha máxima, y la distancia entre una fecha seleccionable y la siguiente (en número de días), respectivamente. Más específicamente, sólo permitiremos al usuario seleccionar un viernes en el rango especificado.

Cuando el atributo step está presente, los autores deberían especificar una fecha para ser tomada como paso inicial. Esto puede hacerse mediante los atributos min y value. Cuando ambos están presentes, el atributo min tiene precedencia.

Los valores provistos en los atributos min, max y step deben acatar los requerimientos de las cadenas de fecha.

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Haz una cita: <input type="date" name="fechacita" min="2015-02-20" max="2015-04-24" step="7">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Haz una cita:

Atributos

Atributos específicos

autofocus

Un valor booleano que instruye al navegador a establecer el enfoque sobre este control cuando el documento termina de cargarse o cuando el cuadro de diálogo (dialog) donde el control se encuentra es mostrado. Si el atributo tiene el valor "autofocus" o la cadena vacía (""), o si simplemente está presente, el control debería obtener el enfoque tan pronto como sea posible, luego de que la página o cuadro de diálogo hayan sido cargados.

Ejemplo

<p>Tu cumpleaños: <input type="date" name="cumple" autofocus></p>

disabled

Un valor booleano que indica si el control se encuentra deshabilitado o no. Si el atributo toma el valor "disabled" o la cadena vacía (""), o si está simplemente presente, el control estará deshabilitado.

Los controles deshabilitados son representados en color gris (si son visibles), son impedidos para interactuar con el usuario y, lo más importante, sus valores (si lo tienen) no son enviados cuando el formulario es despachado.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Fecha de la reunión: <input type="date" name="fechareunion" disabled>
    <input type="submit" value="Enviar datos">
  </p>
</form>

Fecha de la reunión:

form

El valor del atributo id del formulario con el que este control está asociado.

Este atributo es nuevo en HTML5 y ayuda a definir la pertenencia de los controles en formularios anidados o distantes.

Ejemplo

<p>Fecha de la parida: <input type="date" name="fechapartida" form="formulario1"></p>
<form id="formulario1" action="../../form-result.php" method="post" target="_blank">
  <p><input type="submit" value="Enviar datos"></p>
</form>

Fecha de la parida:

list

Un identificador que concuerda con el valor del atributo id del elemento datalist con el que este control está asociado. El datalist referenciado por este atributoproveerá un número de sugerencias que los usuarios pueden escoger para autocompletar el control.

El soporte provisto por los navegadores para datalist es incompleto. Los autores pueden tener que recurrir a programas para proveer esta funcionalidad consistentemente.

Los valores provistos por el elemento datalist deben acatar los requerimientos de las cadenas de fecha.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Fecha deseada para el procedimiento: <input type="date" name="fechadeseada" list="listafechasdeseadas">
    <input type="submit" value="Enviar datos">
  </p>
</form>
<datalist id="listafechasdeseadas">
  <option value="2015-03-10">
  <option value="2015-03-23">
  <option value="2015-04-06">
  <option value="2015-04-18">
</datalist>

Fecha deseada para el procedimiento:

max

La fecha máxima que el usuario debería estar habilitado para seleccionar. Los navegadores que soporten el mecanismo deberían impedir la selección de cualquier fecha superior a la especificada en este atributo.

El valor provisto en este atributo debe acatar los requerimientos de las cadenas de fecha.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Esperar hasta: <input type="date" name="esperarhasta" max="2015-12-31">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Esperar hasta:

min

La fecha mínima que el usuario debería estar habilitado para seleccionar. Los navegadores que soporten el mecanismo deberían impedir la selección de cualquier fecha inferior a la especificada en este atributo.

El valor provisto en este atributo debe acatar los requerimientos de las cadenas de fecha.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Nacido en: <input type="date" name="nacidoen" min="2003-02-10">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Nacido en:

name

Un nombre para el control. Este nombre será enviado por el navegador al agente procesador, emparejado con el contenido del atributo value. Ambos atributos juntos conformarán un par nombre-valor que será utilizado para procesar la información del formulario.

Actualmente, el valor isindex, antiguamente utilizado de manera especial por algunos navegadores e incluido en el estándar HTML, no está permitido en este atributo.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Fecha de nacimiento: <input type="date" name="fechanacimiento">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Fecha de nacimiento:

readonly

Un valor booleano que instruye al navegador a impedir que el usuario cambie el valor del control. Si este atributo tiene el valor "readonly" o la cadena vacía (""), o si simplemente está presente, el usuario no tendrá premitido hacer cambios al valor en el control.

Aunque este atributo previene que el valor del control sea editado, no toda interacción es bloqueada: los usuario aún podrán seleccionar y copiar el texto en el control.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Cita: <input type="date" name="cita" value="2015-05-15" readonly>
    <input type="submit" value="Enviar datos">
  </p>
</form>

Cita:

required

Un valor booleano que indica si este control puede ser dejado en blanco o no. Si este atributo tiene el valor "required" o la cadena vacía (""), o si está siplemente presente, el usuario tendrá que rellenar el control a fin de poder enviar el formulario.

Si un control con el atributo required presente es dejado en blanco, los navegadores que soporten este mecanismo arrojarán un error previo al envío y cancelarán el proceso inmediatamente.

El soporte provisto por los navegadores para el atributo required es incompleto. Los autores pueden tener que recurrir a programas para proveer esta funcionalidad consistentemente.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Miembro desde: <input type="date" name="miembrodesde" required>
    <input type="submit" value="Enviar datos">
  </p>
</form>

Miembro desde:

step

Un número de días para ser usado como la cantidad de espacio entre un valor permitido y el siguiente. La presencia de este atributo reduce el número de opciones que tendrá el usuario al restringir la selección de valores intermedios.

El valor especial any quita la restricción por defecto sobre la granularidad del control y permite a los usuarios ingresar valores tan precisos como deseen.

Para evitar comportamientos inesperados, los autores deberían especificar una fecha para ser tomada como paso inicial. Esto puede hacerse mediante los atributos min y value. Cuando ambos están presentes, el atribtuo min tiene precedencia.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Próxima cita (solo los lunes): <input type="date" name="proximacita" step="7" min="2015-02-16">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Próxima cita (solo los lunes):

type

Un valor que indica el tipo de campo que representa este elemento. Existen veintidós valores posibles (insensibles a mayúsculas/minúsculas):

  • hidden: un control oculto utilizado para enviar información al servidor, típicamente manejado por programas.
  • text: un control usado para la entrada de una sola línea de texto.
  • search: igaul a text pero con fines de búsqueda.
  • tel: un control usado para proveer un número de teléfono.
  • url: una caja de texto usada para el ingreso de un único URL absoluto.
  • email: un control diseñado para editar una o más direcciones de e-mail.
  • password: una caja de texto para la edición de contraseñas, donde los caracteres son representados por puntos.
  • date: un control para ingresar una fecha específica.
  • month: un control para ingresar un mes específico.
  • week: un control para ingresar una semana específica.
  • time: un control para ingresar una hora específica.
  • datetime-local: un control para ingresar una fecha y hora local específica.
  • number: un control para ingresar un número.
  • range: un control para ingresar uno o dos números dentro de un rango.
  • color: un control para ingresar un color.
  • checkbox: un control para ingresar un valor booleano (verdadero/falso).
  • radio: un control para elegir una única opción entre varias.
  • file: un control usado para subir archivos al servidor.
  • submit: un botón usado para enviar el formulario.
  • image: igual a submit pero con la habilidad de verse como una imagen en lugar de usar la apariencia predeterminada de los botones.
  • reset: un botón usado para reiniciar los controles del formulario a sus valores iniciales.
  • button: un botón sin una acción predeterminada asociada.

Cuando este atributo está ausente, el elemento se comporta como si tuviera el valor "text".

Ejemplo

<input type="date" name="fechainicio">

value

Un valor inicial para el control, que será establecido cuando la página se cargue y cuando el botón de reinicio sea presionado.

El valor provisto en este atributo debe acatar los requerimientos de las cadenas de fecha.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>Envíame una alerta en: <input type="date" name="fechalerta" value="2015-02-21"></p>
  <p>
    <input type="submit" value="Enviar datos">
    <input type="reset" value="Restaurar formulario">
  <p>
</form>

Envíame una alerta en:

Atributos globales

Para más información acerca de los atributos globales refiérete a esta lista de atributos gloables en HTML5.

Eventos

Eventos globales

Para más información acerca de los eventos globales refiérete a esta lista de eventos globales en HTML5.