time
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2017.
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
Pruébalo
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-examplesy 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
Specification |
---|
HTML Standard # the-time-element |
Compatibilidad con navegadores
BCD tables only load in the browser
Ver también
- El elemento
<data>
, permite señalizar otro tipo de valores.