As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Use carimbos de data/hora do lado do cliente em consultas no Amazon Keyspaces
<a name="client-side-timestamps-how-to-queries"></a>

Depois de ativar os carimbos de data/hora do lado do cliente, você pode passar o carimbo de data/hora em suas declarações`INSERT`, `UPDATE` e `DELETE` com a cláusula `USING TIMESTAMP`. 

O valor do carimbo de data/hora `bigint` representa um número de microssegundos desde a hora base padrão conhecida como epoch: 1º de janeiro de 1970 às 00:00:00 GMT. Um carimbo de data/hora fornecido pelo cliente deve estar entre o intervalo de 2 dias no passado e 5 minutos no futuro a partir do horário atual do relógio.

O Amazon Keyspaces mantém metadados de carimbo de data/hora durante a vida útil dos dados. Você pode usar a função `WRITETIME` para pesquisar registros de data e hora que ocorreram anos atrás. Para obter mais informações sobre sintaxe de CQL, consulte [Declarações DML (linguagem de manipulação de dados) no Amazon Keyspaces](cql.dml.md).

A instrução CQL a seguir é um exemplo de como usar um carimbo de data/hora como um `update_parameter`. 

```
INSERT INTO {{catalog.book_awards}} (year, award, rank, category, book_title, author, publisher)
   VALUES (2022, 'Wolf', 4, 'Non-Fiction', 'Science Update', 'Ana Carolina Silva', 'SomePublisher') 
   USING TIMESTAMP 1669069624;
```

Se você não especificar um carimbo de data/hora na sua consulta CQL, o Amazon Keyspaces usará o carimbo de data/hora passado pelo seu driver de cliente. Se nenhum carimbo de data/hora for fornecido pelo driver de cliente, o Amazon Keyspaces atribuirá um carimbo de data/hora do lado do servidor para sua operação de gravação. 

Para ver o valor do carimbo de data/hora armazenado em uma coluna específica, você pode usar a função `WRITETIME` em uma instrução `SELECT`, conforme mostrado no exemplo a seguir. 

```
SELECT year, award, rank, category, book_title, author, publisher, WRITETIME(year), WRITETIME(award), WRITETIME(rank),
  WRITETIME(category), WRITETIME(book_title), WRITETIME(author), WRITETIME(publisher) from catalog.book_awards;
```