Elemento input (type=time)

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 "time" en su atributo type, representa un campo para la entrada de una hora. En los navegadores modernos, los campos de hora son habitualmente representados por controles que permiten a los usuarios cambiar su valor de manera gráfica, 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 hora. Las reglas para componer una hora válida se describen a continuación.

Horas

La sintaxis de una hora está compuesta por:

  1. Dos dígitos representando una hora entre 0 y 23.
  2. Un carácter de dos puntos (":").
  3. Un minuto de dos dígitos entre 0 y 59.
  4. La siguiente información, que es opcional si el número de segundos es cero:
    1. Un carácter de dos puntos (":").
    2. Dos dígitos representando la parte entera de los segundos, entre 0 y 59.
    3. La siguiente información, que es opcional si el número de segundos es entero:
      1. Un punto (".").
      2. La parte fraccionaria de los segundos compuesta por uno, dos o tres dígitos.

Ejemplo

<time>23:59:59.999</time>
<time>10:20:00.000</time>
<time>10:20</time>
<time>10:20:00</time>

El soporte provisto por los navegadores para campos de hora 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 tiempos válidos que el usuario tendrá permitido enviar.

Ejemplos

En el primer ejemplo crearemos solamente un formulario con un control de hora. 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>Tiempo estimado de arribo: <input type="time" name="eta"> <input type="submit" value="Enviar datos"></p>
</form>

Tiempo estimado de arribo:

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.

Para que este ejemplo trabaje correctamente, estableceremos el atributo step a 0.01 segundos. El atributo step será tratado en el siguiente ejemplo.

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 hora.

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Elije un límite de tiempo: <input type="time" name="limitetiempo" list="listalimitestiempo" step="0.001">
    <input type="submit" value="Enviar datos">
  </p>
</form>
<datalist id="listalimitestiempo">
  <option value="06:40">
  <option value="08:24">
  <option value="12:31:30">
  <option value="23:59:59.999">
</datalist>

Elije un límite de tiempo:

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 hora mínima, una hora máxima, y la distancia entre una hora seleccionable y la siguiente (como número de segundos), respectivamente. Más específicamente, sólo permitiremos al usuario seleccionar una hora entre 12:00 y 16:00 y un número de minutos mútiplo de diez (sin segundos).

Cuando el atributo step está presente, los autores deberían especificar una hora 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 hora.

Nota que le valor por defecto para step es 60 segundos. Estando este atributo ausente, el usuario no podrá cambiar el número de segundos, ni seleccionar valores con segundos de un datalist.

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Adivina la hora de arribo: <input type="time" name="horaarribo" min="12:00" max="18:00" step="600">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Adivina la hora de arribo:

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>Haz una cita para hoy: <input type="time" name="horacita" 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>
    Contctarme desde: <input type="time" name="contactarmedesde" disabled>
    <input type="submit" value="Enviar datos">
  </p>
</form>

Contctarme desde:

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>Hora de partida: <input type="time" name="horapartida" form="formulario1"></p>
<form id="formulario1" action="../../form-result.php" method="post" target="_blank">
  <p><input type="submit" value="Enviar datos"></p>
</form>

Hora de partida:

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 hora.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Hora deseada para recibir la llamada: <input type="time" name="horadeseada" list="listahorasdeseadas">
    <input type="submit" value="Enviar datos">
  </p>
</form>
<datalist id="listahorasdeseadas">
  <option value="16:00">
  <option value="16:30">
  <option value="17:00">
  <option value="17:30">
</datalist>

Hora deseada para recibir la llamada:

max

La hora 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 hora superior a la especificada en este atributo.

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

Ejemplo

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

Esperar hasta:

min

La hora 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 hora inferior a la especificada en este atributo.

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

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>
    Start time: <input type="time" name="starttime" min="09:00">
    <input type="submit" value="Send data">
  </p>
</form>

Start time:

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>
    Comienzo: <input type="time" name="comienzo">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Comienzo:

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>
    Hora de la cita: <input type="time" name="horacita" value="16:05" readonly>
    <input type="submit" value="Enviar datos">
  </p>
</form>

Hora de la 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>
    La clase comienza: <input type="time" name="comienzoclase" required>
    <input type="submit" value="Enviar datos">
  </p>
</form>

La clase comienza:

step

Un número de segundos 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 hora 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>
    Selecciona una hora (sin minutos): <input type="time" name="hour" step="3600" min="00:00">
    <input type="submit" value="Enviar datos">
  </p>
</form>

Selecciona una hora (sin minutos):

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="time" name="horacomienzo">

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 hora.

Ejemplo

<form action="../../form-result.php" method="post" target="_blank">
  <p>Enviarme una alerta a las: <input type="time" name="horaalerta" value="07:45"></p>
  <p>
    <input type="submit" value="Enviar datos">
    <input type="reset" value="Restaurar formulario">
  <p>
</form>

Enviarme una alerta a las:

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.