> For the complete documentation index, see [llms.txt](https://ebay.gitbook.io/mindpatterns/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ebay.gitbook.io/mindpatterns/messaging/time.md).

# Time

![Time left on eBay auction page](/files/-LXQcI8NwaZFbbLo1Fx7)

### Introduction

Time-based patterns can be used to indicate the elapsed time from a start point (stopwatch), the time remaining until an end point (timer), or simply the current time (clock).

For sighted users, a clock, timer or stopwatch will update every second visually. For non-sighted users we must be careful **not** to convey this 'ticking' of the timer aurally.

### Working Examples

Experience the pattern in action on our companion [eBay MIND Patterns examples website](https://ebay.github.io/mindpatterns/messaging/time).

### Best Practices

Screen reader **must not** announce updates every second because this creates too much noise and distraction.

We must audibly convey only the most important thresholds. For example "30 seconds left".

Announcements must be spaced *at least* 15 seconds apart. This will give the screen reader enough time to announce the new value, even on the slowest screen reader speech rate, in any language.

### Interaction Design

#### Keyboard

As the time pattern contains no interactive elements, there are no specific call-outs for keyboard interaction.

#### Screen Reader

Without losing their current point of focus, the screen reader must be alerted of any *critical* points in the passage of time.

### Developer Guide

The section is not yet available.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ebay.gitbook.io/mindpatterns/messaging/time.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.