Segundos bissextos UTC↔TAI
Descubra a diferença entre o tempo atômico e o UTC em qualquer data, ou veja a lista dos segundos bissextos por trás dela: em 2 de janeiro de 2017, TAI−UTC é de 37 segundos. A tabela vem embutida. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Modo de cálculo
- Offset
- Data
- 2017-01-02
- Diferença TAI−UTC (segundos)
- 37
Liste os segundos bissextos (leap seconds) embutidos da IERS e converta datas civis UTC em deslocamentos TAI-UTC, sem acesso à rede.
Segundos bissextos e a diferença TAI−UTC
O Tempo Atômico Internacional e o Tempo Universal Coordenado não andam perfeitamente juntos: a diferença entre eles é definida pelos segundos bissextos já acrescentados ao UTC. Esta ferramenta guarda uma tabela embutida dos segundos bissextos do IERS e responde a duas perguntas com ela. A primeira é a diferença: você informa uma data do calendário em UTC e recebe quantos segundos o TAI está à frente do UTC naquele dia, por exemplo 37 segundos em 2 de janeiro de 2017. A segunda é a lista: ela mostra os segundos bissextos da tabela, se quiser entre duas datas, para você ver exatamente quando a diferença mudou.
Quando ajuda e o que observar
A diferença importa sempre que um horário em tempo atômico precisa ser comparado com um horário em UTC; sem ela, seria preciso manter à mão uma planilha com os segundos bissextos passados. Os erros mais comuns são esperar que o fuso horário mude o resultado, quando só conta a data do calendário em UTC; informar um intervalo de datas que termina antes de começar, o que é recusado em vez de adivinhado; e deixar a data em branco. Como a tabela vem embutida e nada é buscado online, a mesma data sempre dá o mesmo número de segundos.
Entradas e saídas
Os campos obrigatórios do esquema precisam estar presentes e com o tipo correto; os campos opcionais adotam os valores padrão documentados. Toda resposta de sucesso inclui sempre os campos de saída principais, para que as ligações da interface permaneçam estáveis e você não precise tratar ausências inesperadas. A ordem de validação é fixa: primeiro os tipos, depois os intervalos e por fim a aritmética.
Assim, cada erro tem uma causa clara e uma mensagem estável, o que facilita escrever testes automatizados e diagnosticar problemas em produção. Consulte os exemplos dourados para ver, lado a lado, uma entrada válida e uma entrada rejeitada.
Casos limite
Strings vazias, tipos incorretos e intervalos contraditórios são rejeitados logo no início, antes de qualquer processamento. Datas civis sem fuso horário são tratadas como datas de calendário, sem conversão implícita para outro fuso. As tabelas de segundos bissextos viajam embutidas dentro da própria pasta da capacidade, portanto não há nenhuma chamada de rede em tempo de execução: o resultado é o mesmo estando você on-line ou off-line.
Como os dados da IERS são fixos até a próxima atualização publicada, é importante revisar os exemplos e a data da tabela embutida antes de integrar a capacidade em cálculos sensíveis. Para conversões próximas de um segundo bissexto, confira sempre o deslocamento TAI-UTC informado na saída.
Casos de uso
Trabalho diário
Obtenha uma resposta confiável sem precisar de planilha.
Perguntas frequentes
O que significa TAI−UTC?
É quantos segundos o Tempo Atômico Internacional está à frente do Tempo Universal Coordenado em uma data. A diferença só muda quando um segundo bissexto é acrescentado ao UTC, por isso ela é lida da tabela de segundos bissextos.
Dá para ver a lista de segundos bissextos?
Sim. Escolha a opção de lista para ver os segundos bissextos da tabela embutida, se quiser limitados a um intervalo entre duas datas. Um intervalo que termina antes de começar é recusado, em vez de adivinhado.
A ferramenta consulta algo na internet?
Não. A tabela de segundos bissextos vem embutida e nada é buscado durante o uso, então a mesma data sempre dá a mesma diferença em segundos.
Preciso informar horário ou fuso horário?
Não. Digite só a data do calendário. Uma data sem fuso é lida como um simples dia em UTC, então o lugar onde você está nunca muda a diferença que recebe.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/date/leap-seconds \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"mode":"offset","date":"2017-01-02"}'const res = await fetch("https://api.kit.forhosting.com/date/leap-seconds", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"mode": "offset",
"date": "2017-01-02"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/leap-seconds",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"mode": "offset",
"date": "2017-01-02"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/leap-seconds", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"mode":"offset","date":"2017-01-02"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"mode":"offset","date":"2017-01-02"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/leap-seconds", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"mode": "offset",
"date": "2017-01-02"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.leap_seconds",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Como funciona
Esta ferramenta lista os segundos bissextos (leap seconds) embutidos da tabela da IERS e converte datas civis em UTC para o deslocamento correspondente entre TAI e UTC. Recomendamos ler os exemplos dourados de sucesso e de erro antes de incorporar a capacidade em fluxos de produção ou em testes automatizados, pois eles congelam o contrato e servem de referência estável para a certificação. Todo o cálculo é determinista e roda de graça no seu navegador, com exatamente a mesma função pura que o API executa nos servidores. Isso garante que o resultado visto na página gratuita seja idêntico ao que você obtém ao integrar a capacidade por API. As entradas passam por validação de tipo antes de qualquer aritmética, de modo que um valor mal formado vira um erro invalid_input com uma mensagem clara, em vez de um resultado silenciosamente errado.
Entradas e saídas
Quando um cálculo intermediário fica grande demais e ultrapassa o limite do ponto flutuante IEEE-754, a capacidade devolve um erro de valor fora do intervalo, em vez de um nulo silencioso que quebraria as etapas seguintes.
Casos de integração
Automação
A mesma função pura no widget e na API.
Ensino
Fixtures dourados estáveis para demonstrações.
Perguntas técnicas
É gratuita?
Sim, tier A no navegador.
Usa rede?
Sem rede; o processamento ocorre no dispositivo.
Entrada inválida?
invalid_input com uma correspondência clara.
É estável?
Os goldens deterministas congelam o contrato.
Autor?
samurai.