# Tempo e quadros

> Por que todo tempo é uma string com unidade, e como a taxa de quadros do projeto define onde as coisas caem.

Source: https://alexgalhardo.github.io/vukem-video/pt-br/docs/concepts/time/

## A ideia

Dentro de um projeto, o tempo é um número inteiro de quadros na taxa de quadros do projeto. Um corte nunca cai entre dois quadros, então duas edições "no mesmo instante" são o mesmo quadro.

Em toda entrada, um tempo é uma string com unidade: `12.5s`, `375f` ou `00:00:12.500`. Um número puro é recusado, porque `5` poderia significar segundos, quadros ou milissegundos. A única exceção é `wait_ms`, cuja unidade está no nome.

Os resultados mostram os dois: `{"frame": 150, "seconds": 5}`. Quando você pede `1.01s` a 30 quadros por segundo, o núcleo arredonda para um quadro e informa o que usou em `effective`.

## Início rápido

A 30 quadros por segundo:

| Você escreve | Quadro | Segundos |
| --- | --- | --- |
| `1s` | 30 | 1 |
| `45f` | 45 | 1,5 |
| `00:00:02.000` | 60 | 2 |

## Erros comuns

- Escrever `5`. O erro é `E_INVALID_TIME` e a dica indica as unidades.
- Pedir um quadro depois do fim da linha do tempo. O `view` responde `E_INVALID_TIME` com o último tempo válido na dica.

## Próximos passos

- [Comandos, lotes e revisões](/docs/concepts/commands-and-revisions)
