Fração do trimestre decorrida
Ao meio-dia UTC de 15 de fevereiro de 2024, o primeiro trimestre está exatamente na metade: uma fração de 0,5. Digite uma data, ou data e hora com o fuso, e veja quanto do trimestre já passou e quanto falta, medido em segundos. 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
- Data e hora
- 2024-02-15T12:00:00Z
- Ano
- 2.024
- Mês
- 2
- Dia
- 15
- Hora
- 12
A fração do trimestre decorrida responde a uma pergunta operacional precisa: em um instante civil explícito, quanto o relógio já avançou no trimestre gregoriano atual, expresso como um número contínuo entre zero e um, e não como contagem de dias inteiros nem como percentual do ano. Equipes financeiras que planejam fechamentos trimestrais, painéis de produto com barras de progresso do trimestre e calendários de SLA que reiniciam nos limites do trimestre precisam dessa proporção sem depender do relógio da máquina hospedeira nem de tabelas de horário de verão locais. Esta calculadora aceita uma única data-hora ISO-8601 (ou uma string só de data tratada como meia-noite UTC), converte o instante para tempo universal coordenado, identifica qual dos quatro trimestres de calendário o contém, mede os segundos desde a primeira meia-noite do trimestre até esse instante e divide pelo comprimento total do trimestre em segundos.
Como a fração de um trimestre de calendário é calculada em UTC
Comece com um carimbo de tempo explícito escrito em forma ISO-8601 para que todo cliente concorde nos mesmos componentes civis: ano de quatro dígitos, mês de dois dígitos, dia de dois dígitos e, opcionalmente, horas, minutos, segundos, um segundo fracionário que este motor trunca para segundos inteiros, e um Z final para UTC ou um deslocamento numérico como mais ou menos horas e minutos. Strings só de data, sem parte horária, são tratadas como meia-noite no início daquele dia civil em UTC.
O analisador rejeita formas incorretas, meses fora de faixa, dias impossíveis como o trinta e um de abril e o vinte e nove de fevereiro em anos não bissextos, para que dados ruins nunca se tornem um valor de progresso inventado. Mapeie o mês UTC para o trimestre gregoriano padrão: janeiro a março é o trimestre um, abril a junho o dois, julho a setembro o três e outubro a dezembro o quatro.
O trimestre começa à meia-noite UTC no primeiro dia do seu primeiro mês e termina de forma exclusiva à meia-noite UTC no primeiro dia do trimestre seguinte, de modo que o primeiro segundo de um trimestre tem fração zero e o último segundo tem fração que se aproxima de um sem entrar no próximo.
Os segundos decorridos equivalem à época UTC da entrada menos a do início do trimestre; o comprimento do trimestre é a época do início do próximo menos a do atual, o que cobre automaticamente trimestres de noventa, noventa e um ou noventa e dois dias e o dia extra de fevereiro em anos bissextos no primeiro trimestre. A fração reportada é segundos decorridos divididos pelo comprimento do trimestre, limpa para um float estável de doze dígitos significativos para goldens reproduzíveis.
A fração restante é um menos esse valor, e os segundos restantes completam a visão de contagem regressiva.
Onde o progresso fracionário do trimestre aparece no trabalho real
Equipes de produto e finanças desenham barras de progresso do trimestre para OKRs, metas de receita e pacotes de diretoria e precisam de uma proporção contínua de zero a um que respeite os limites civis do trimestre, em vez de um contador de dias inteiros que ignora o progresso intradía. Calendários de operações e SRE que reiniciam orçamentos de erro ou planos de capacidade no início do trimestre usam a mesma fração para colocar o instante UTC atual em um eixo normalizado para alertas e relatórios.
Marketing e operações de vendas agendam campanhas e períodos de cota perguntando quanto do trimestre atual já decorreu quando um lançamento ou marco está fixado em forma ISO. Software que deve permanecer livre de bibliotecas de fuso do hospedeiro ainda precisa de uma fração pura de trimestre em UTC para janelas de conformidade, ciclos de faturamento e widgets de produtividade pessoal definidos por trimestres de calendário.
Se mais tarde você precisar apenas de uma contagem de dias inteiros no trimestre, do número do trimestre sem fração, das datas inclusivas de um trimestre nomeado ou do progresso anual em percentual, trate-os como intenções de busca e landings separadas, em vez de sobrecarregar esta página de fração do trimestre decorrida.
Casos de uso
Painéis de OKR e finanças trimestrais
Converta qualquer data-hora ISO em uma fração 0–1 de progresso do trimestre para que barras e rótulos de fração restante respeitem anos bissextos e UTC sem relógios do hospedeiro.
Calendários de SLA e orçamento de erro
Coloque o marco atual em um eixo de trimestre normalizado para alertas e relatórios que reiniciam nos limites Q1–Q4.
Perguntas frequentes
Como a fração do trimestre é calculada?
fraction = (época UTC da data-hora − época UTC do início do trimestre) ÷ (época UTC do início do próximo trimestre − início do trimestre). Q1 é jan–mar, Q2 abr–jun, Q3 jul–set, Q4 out–dez. O resultado fica entre 0 e 1.
Isso é o mesmo que dias decorridos no trimestre?
Não. Dias decorridos devolve um inteiro de dias inteiros desde a data de início do trimestre. Esta capacidade devolve uma fração contínua da duração total do trimestre em uma data-hora explícita: outra intenção de busca.
Um ano bissexto altera a fração?
Sim no Q1. Anos bissextos adicionam 29 de fevereiro, então o Q1 tem 91 dias (7,862,400 segundos) em vez de 90. O mesmo instante de fevereiro–março mapeia para uma fração um pouco menor em ano bissexto.
O que acontece se a data-hora for inválida?
Forma errada, mês fora de faixa, dias impossíveis como 2023-02-29 ou componentes de hora inválidos são rejeitados e não cobrados.
Quanto custa?
A ferramenta do navegador é gratuita e roda localmente.
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/fraction-of-quarter-elapsed \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"datetime":"2024-02-15T12:00:00Z"}'const res = await fetch("https://api.kit.forhosting.com/date/fraction-of-quarter-elapsed", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"datetime": "2024-02-15T12:00:00Z"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/fraction-of-quarter-elapsed",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"datetime": "2024-02-15T12:00:00Z"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/fraction-of-quarter-elapsed", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"datetime":"2024-02-15T12:00:00Z"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"datetime":"2024-02-15T12:00:00Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/fraction-of-quarter-elapsed", 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
{
"datetime": "2024-02-15T12:00:00Z"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.fraction_of_quarter_elapsed",
"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
A resposta também devolve a fração restante, os segundos decorridos e restantes, rótulos do trimestre e as datas inclusivas de início e fim, para que os clientes renderizem progresso e contagens regressivas a partir de um único payload determinístico. Dias de calendário impossíveis e carimbos de tempo malformados falham com um erro invalid_input claro em vez de um ajuste silencioso.
O que você envia, o que recebe de volta e como os erros se comportam
Envie um campo de string obrigatório chamado datetime contendo um instante ISO-8601 estrito, por exemplo dois mil vinte e quatro hífen zero dois hífen um cinco T doze dois pontos zero zero dois pontos zero zero Z, ou uma string só de data como dois mil vinte e quatro hífen zero quatro hífen zero um. Dias que batem com o padrão mas não são datas gregorianas reais, incluindo 29 de fevereiro não bissexto e meses fora de um a doze, também falham com uma mensagem que nomeia o problema para que você possa corrigir a entrada sem adivinhar. Verificações clássicas incluem a primeira meia-noite de janeiro mapeando para fração zero no trimestre um, meados de fevereiro perto da metade de um primeiro trimestre bissexto ou comum conforme o estado bissexto, o primeiro segundo de abril mapeando para zero no trimestre dois, e o último segundo de um trimestre aproximando-se de um enquanto permanece nesse trimestre. Os aliases date, iso, at, when, value e on são aceitos com o mesmo significado, para que clientes existentes liguem o campo sem renomeá-lo. Campos ausentes, valores que não são string, strings vazias e strings que não batem com a forma ISO suportada falham com invalid_input e não são cobrados. Em sucesso a resposta ecoa uma data-hora UTC normalizada com sufixo Z, o ano, mês, dia, hora, minuto e segundo numéricos em UTC, o número do trimestre de um a quatro, um quarter_label como Q2, uma string legível do intervalo de meses, quarter_start e quarter_end como datas de calendário inclusivas YYYY-MM-DD, um booleano is_leap_year relevante para o comprimento do primeiro trimestre, inteiros elapsed_seconds e remaining_seconds, quarter_seconds como duração total do trimestre, fraction e remaining_fraction no intervalo unitário, e uma string formula curta que documenta a definição UTC. O preço de chamadas API bem-sucedidas é a base publicada de US$ 0,002 por item; falhas de validação não consomem saldo pré-pago.
Onde o progresso fracionário do trimestre aparece no trabalho real
Como esta capacidade é um motor parse puro, o preço da API é a base publicada de US$ 0,002 por item bem-sucedido e a validação falha não consome saldo.
Casos de integração
Marcos de campanhas e cotas
Marque lançamentos e cotas de vendas com uma fração de trimestre determinística a partir de entradas ISO estritas, com invalid_input claro em carimbos inválidos.