Ferramenta de Contagem Regressiva Gaokao

A contagem regressiva do Gaokao mostra quanto tempo falta para o exame nacional chinês de ingresso na universidade, geralmente em dias, horas, minutos e segundos. Ela funciona como uma referência comum para organizar revisões, simulados, descanso, documentos e deslocamentos antes da prova. Estudantes, famílias e professores podem olhar para o mesmo prazo sem fazer contas repetidas. A ferramenta não mede preparo nem prevê nota; seu papel é transformar uma data futura em um orçamento de tempo visível, útil principalmente na reta final, quando pequenas semanas disponíveis fazem diferença no planejamento.

A contagem regressiva é uma subtração de uma linha envolta em um loop de atualização. A duração restante é calculada como `target.getTime() - Date.now()` em milissegundos, depois decomposta por divisão inteira: dias = `Math.floor(diff / 86400000)`, horas = `Math.floor(diff / 3600000) % 24`, minutos = `Math.floor(diff / 60000) % 60`, segundos = `Math.floor(diff / 1000) % 60`. O momento-alvo é fixo: o Gaokao é realizado anualmente em 7 de junho começando às 09:00 Horário Padrão da China (UTC+8), com algumas províncias do novo Gaokao estendendo para um quarto dia. A regra de virada compara `Date.now()` com `new Date(year, 5, 9, 17, 0)` — meses em JS são indexados em 0, então 5 é junho — e avança `year` em um assim que aquele instante passa.

Duas armadilhas de temporização impulsionam o loop de atualização. Primeiro, `setInterval(fn, 1000)` desvia: o callback pode disparar 1003-1020 ms depois sob contenção da thread principal, e o desvio acumula porque o próximo prazo é agendado a partir do disparo anterior, não de uma âncora de relógio de parede. A correção é agendar `setTimeout` com um atraso de `1000 - (Date.now() % 1000)` para que cada tick se realinhe ao próximo segundo inteiro, ou recalcular o valor exibido a partir de `Date.now()` a cada disparo em vez de incrementar um contador. Segundo, a Page Visibility API do HTML5 e a limitação do navegador reduzem os temporizadores de abas ocultas para aproximadamente uma vez por minuto (1 Hz mínimo no Chrome/Firefox/Safari modernos quando a aba está oculta); a página reconcilia recalculando a partir de `Date.now()` no `visibilitychange` em vez de contar disparos de intervalo. `requestAnimationFrame` é reservado para a animação suave de flip dos dígitos e é pausado automaticamente quando a aba está oculta, então não deve ser a fonte de verdade para o carimbo de data/hora.

A localização usa o fuso horário do dispositivo retornado por `Intl.DateTimeFormat().resolvedOptions().timeZone`. Para um candidato sentado fora do UTC+8, a contagem regressiva exibida ainda tem como alvo o Horário Padrão da China, então o alvo é construído uma vez com `Date.UTC(year, 5, 7, 1, 0, 0)` — 09:00 CST é 01:00 UTC — em vez do construtor `Date` de horário local que usaria silenciosamente o deslocamento do dispositivo. Anos bissextos importam apenas quando o planejamento do usuário cai em 29 de fevereiro: um sprint de 100 dias iniciado em 29 de fevereiro cai em uma data diferente do mesmo sprint iniciado em 28 de fevereiro de um ano não bissexto. O armazenamento é `localStorage` para o tema opcional e substituições de data-alvo; a notificação opcional em T-0 usa `Notification.requestPermission()` uma vez por sessão e `new Notification(title, { body })` para exibir um alerta no nível do sistema sem sair da página.

• Fórmula principal: `diff = target.getTime() - Date.now()`; dias = `Math.floor(diff / 86400000)`, depois `% 24`, `% 60`, `% 60` para h/m/s. Constantes: 86.400.000 ms/dia, 3.600.000 ms/hora, 60.000 ms/min.
• Alvo: 7 de junho, 09:00 Horário Padrão da China (UTC+8). O índice de mês em JS é 5 para junho. A virada é acionada quando `Date.now() > new Date(year, 5, 9, 17, 0)`; então `year += 1`.
• Desvio do temporizador: `setInterval(fn, 1000)` desvia sob carga da thread principal. Padrão autocorretivo: `setTimeout(fn, 1000 - Date.now() % 1000)` realinha cada tick ao próximo segundo inteiro.
• Limitação em segundo plano: Page Visibility API + política do navegador reduz temporizadores de abas ocultas para 1 Hz (Chrome/Firefox/Safari). Reconcilie recalculando a partir de `Date.now()` no `visibilitychange`, não contando disparos.
• Fuso horário: construa o alvo via `Date.UTC(year, 5, 7, 1, 0, 0)` (09:00 CST = 01:00 UTC) para que candidatos fora do UTC+8 ainda vejam uma contagem regressiva correta para o momento do exame, não seu 09:00 local.
• Persistência: `localStorage.setItem(key, value)` (síncrono, ~5 MB de cota por origem) para tema e substituições de alvo. Notificações usam `Notification.requestPermission()` e depois `new Notification(title, { body, icon })`.
• Renderização: `requestAnimationFrame` controla a animação de flip dos dígitos (pausada automaticamente quando oculta); os dígitos exibidos são recalculados a partir de `Date.now()` a cada frame, não incrementados, então um frame perdido nunca subconta.