El elemento HTML <time>
representa un periodo específico en el tiempo. Puede incluir el atributo datetime
para convertir las fechas en un formato interno legible por un ordenador, permitiendo mejores resultados en los motores de búsqueda o características personalizadas como recordatorios.
Puede representar uno de los contenidos siguientes:
- Una hora en formato de 24 horas
- Una fecha precisa en el Calendario Gregoriano (con hora y zona horaria opcionales)
- Un periodo de tiempo válido
La fuente de este ejemplo interactivo está almacenada en un repositorio de GitHub. Si desea contribuir al projecto, por favor clone https://github.com/mdn/interactive-examples y envíe su solicitud de extracción (pull request).
Categorías de contenido | Contenido de flujo, contenido de fraseo, contenido palpable. |
---|---|
Contenido permitido | Contenido de fraseo. |
Omisión de etiquetas | Ninguna; tanto la etiqueta de inicio como de fin son obligatorias. |
Padres permitidos | Cualquier elemento que acepte contenido de fraseo. |
Roles permitidos en ARIA | Cualquiera |
Interfaz DOM | HTMLTimeElement |
Atributos
Como todos los elementos de HTML, este elemento soporta los atributos globales.
datetime
- Este atributo indica la hora y/o fecha del elemento y debe estar escrito en uno de los formatos que se muestran posteriomente.
Notas de uso
Este elemento es para presentar fechas y horas en un formato legible por el equipo. Por ejemplo, este puede ayudar a un agente de usuario ofrecer añadir un evento al calendario del usuario.
Este elemento no debe ser usado para fechas anteriores a la introducción del calendario Gregoriano (debido a complicaciones en el cálculo de dichas fechas).
El valor de fecha y hora (el valor legible por el equipo) es el valor del atributo del elemento datetime
, que debe estar en el formato correcto (vea más adelante). Si el elemento no tiene un atributo datetime
, no debe tener ningún elemento descendiente, y el valor datetime es el contenido de texto del hijo del elemento.
Valores datetime válidos
- una cadena válida de año
2011
0001
- una cadena válida de mes
2011-11
- una cadena válida de fecha
2011-11-18
- una cadena de fecha sin año válida
11-18
- una cadena de semana válida
2011-W47
- una cadena de hora válida
14:54
14:54:39
14:54:39.929
- una cadena de fecha y hora local válida
2011-11-18T14:54:39.929
2011-11-18 14:54:39.929
- una cadena de fecha y hora global válida
2011-11-18T14:54:39.929Z
2011-11-18T14:54:39.929-0400
2011-11-18T14:54:39.929-04:00
2011-11-18 14:54:39.929Z
2011-11-18 14:54:39.929-0400
2011-11-18 14:54:39.929-04:00
- una cadena valida de duración
PT4H18M3S
Ejemplos
Ejemplo Simple
HTML
<p>El concierto empieza a las <time>20:00</time>.</p>
Output
Ejemplo con datetime
HTML
<p>El concierto fué el <time
datetime="2001-05-15T19:00">15 de Mayo</time>.</p>
Output
Especificaciones
Especificación | Estado | Comentario |
---|---|---|
HTML Living Standard La definición de '<time>' en esta especificación. |
Living Standard | Sin cambios desde HTML 5.1 |
HTML 5.1 La definición de '<time>' en esta especificación. |
Recommendation | Sin cambios desde HTML5 |
HTML5 La definición de '<time>' en esta especificación. |
Recommendation | Definición inicial |
Compatibilidad de los navegadores
BCD tables only load in the browser
Ver también
- El elemento
<data>
, permite señalizar otro tipo de valores.