Atributo datetime do HTML <time>

Definição e uso

datetime A propriedade representa o formato legível pela máquina do elemento <time>.

Exemplos de valores de data e hora válidos:

Data:

<time datetime="1914">  <!-- Representa 1914 -->
<time datetime="1914-12">  <!-- Representa dezembro de 1914 -->
<time datetime="1914-12-20">  <!-- Representa 20 de dezembro de 1914 -->
<time datetime="12-20">  <!-- Representa 20 de dezembro de cada ano -->
<time datetime="1914-W15">  <!-- Representa a 15ª semana de 1914 -->

Data e hora:

<time datetime="1914-12-20T08:00">  <!-- Representa as 8h da manhã de 20 de dezembro de 1914 -->
<time datetime="1914-12-20 08:00">  <!-- Também representa as 8h da manhã de 20 de dezembro de 1914 -->
<time datetime="1914-12-20 08:30:45">  <!-- Inclui minutos e segundos -->
<time datetime="1914-12-20 08:30:45.687">  <!-- Inclui minutos, segundos e milissegundos -->

Data e hora:

<time datetime="08:00">  <!-- Representa as 8h da manhã -->
<time datetime="08:00-03:00">  <!-- Representa as 8h da manhã no horário de Rio de Janeiro (UTC-3 horas) -->
<time datetime="08:00+03:00">  <!-- Representa as 8h da manhã no horário de Madagáscar (UTC+3 horas) -->

Duração:

<time datetime="P2D">  <!-- Representa 2 dias -->
<time datetime="PT15H10M">  <!-- Representa 15 horas e 10 minutos -->

Exemplo

O elemento <time> possui a propriedade <code>datetime</code> configurada para leitura pela máquina:

<p>Eu tive um compromisso no <time datetime="2017-02-14">Dia dos Namorados</time>.</p>

Experimente pessoalmente

Gramática

<time datetime="YYYY-MM-DDThh:mm:ssTZD">

Valor do atributo

Valor Descrição

YYYY-MM-DDThh:mm:ssTZD

ou

PTDHMS

Data ou hora especificada. Explicação dos componentes:

  • YYYY - Ano (por exemplo, 2011)
  • MM - Mês (por exemplo, 01 representa janeiro)
  • DD - Dia (por exemplo, 08)
  • T ou espaço - Separador (se também for especificado o tempo,则需要)
  • hh - Horas (por exemplo, 22 representa 22h)
  • mm - Minutos (por exemplo, 55)
  • ss - Segundos (por exemplo, 03)
  • TZD - Indicador de fuso horário (Z representa Zulu, também conhecido como Hora de Greenwich Meridional)
  • P - Prefixo de "Período"
  • D - Prefixo de "Dias"
  • H - Prefixo de "Horas"
  • M - Prefixo de "Minutos"
  • S - Prefixo de "Segundos"

Suporte do navegador

Os números na tabela indicam a versão do navegador que suporta completamente essa propriedade pela primeira vez.

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
62.0 18.0 22.0 7.0 49.0