```meta
title: @countdown — uma contagem regressiva
description: Conta até uma data e uma hora, e diz outra coisa quando o momento chega: um lançamento, uma abertura, o fim das inscrições.
```

_flows.md · documentação · [Blocos](/@docs/blocks)_

# @countdown

Conta até uma data e uma hora, e diz outra coisa quando o momento chega — um lançamento, uma abertura de portas, o fim das inscrições.

## Ao vivo

```@countdown to:2027-03-15T19:00-03:00 label:"A loja do Ateliê Exemplo abre em" done:"A loja está aberta"
```

~~~text
```@countdown to:2027-03-15T19:00-03:00 label:"A loja do Ateliê Exemplo abre em" done:"A loja está aberta"
```
~~~

Depois de 15 de março de 2027, este mesmo bloco diz "A loja está aberta" — é o `done:`.

## Só os dias

`show:days` conta só os dias, para algo a semanas de distância.

```@countdown to:2027-06-01 label:"Faltam para as inscrições fecharem" show:days done:"As inscrições fecharam"
```

~~~text
```@countdown to:2027-06-01 label:"Faltam para as inscrições fecharem" show:days done:"As inscrições fecharam"
```
~~~

## Argumentos

- `to` — o momento, como `2027-03-15` ou `2027-03-15T19:00-03:00`. Sem fuso, é lido em UTC.
- `label` — o que se espera, acima do relógio.
- `done` — o que o bloco diz depois que o momento passou.
- `show` — `full` (dias, horas, minutos e segundos) ou `days`.

Para pôr o momento na agenda do leitor, um [@event](/@docs/blocks/event) ao lado.