> ## Documentation Index
> Fetch the complete documentation index at: https://edzo.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Clock Question Block

> Learn how to use Clock Question blocks to create interactive time-telling activities.

The **Clock Question** block creates interactive time-telling activities with customizable analog and digital clock displays. Learners set the time by adjusting clock hands or entering digital time values.

Perfect for teaching time concepts from basic hour recognition to complex 24-hour notation.

> [!NOTE]
>
> Clock Questions support both analog and digital clock displays, with options for 12-hour and 24-hour notation.

## When to use Clock Questions

Clock questions work well for:

* Teaching time-telling skills (o'clock, half past, quarter past/to)
* Reading analog clock faces
* Converting between analog and digital time
* Understanding 12-hour and 24-hour notation
* Elapsed time and duration activities

## Settings

### Display settings

**Display** `select` (default: both)

Which clock display(s) to show:

* **Both**: Shows both analog and digital clocks
* **Analog**: Shows only the analog clock face
* **Digital**: Shows only the digital time display

**Notation** `select` (default: 12)

The time format for the digital display:

* **12-hour**: Uses AM/PM notation (e.g., 3:30 PM)
* **24-hour**: Uses 24-hour format (e.g., 15:30)

Only visible when display includes digital clock.

**Period** `select` (default: AM)

The default time period for 12-hour notation: **AM** or **PM**.

Only visible when using 12-hour notation with digital display.

### Analog clock settings

**Show hour hand** `switch` (default: true)

When enabled, displays the hour hand on the analog clock.

**Show minute hand** `switch` (default: true)

When enabled, displays the minute hand on the analog clock.

**Show seconds** `switch` (default: true)

When enabled, includes seconds in the time display.

**Show hour numerals** `switch` (default: true)

When enabled, displays numbers (1–12) around the clock face.

**Show hour intervals** `switch` (default: true)

When enabled, displays tick marks at hour positions on the clock face.

**Show minute intervals** `switch` (default: true)

When enabled, displays tick marks at minute positions on the clock face.

### Additional display options

**Show time in words** `switch` (default: true)

When enabled, displays the time written in words (e.g., "half past three").

**Show labels** `switch` (default: true)

When enabled, displays labels for clock elements.

**Show period** `switch` (default: true)

When enabled, displays the AM/PM indicator.

## Answer and Marking

Set the correct time that learners must match. The answer includes:

* Hour (1–12 or 0–23 depending on notation)
* Minute (0–59)
* Second (0–59, if seconds are shown)
* Period (AM/PM, if using 12-hour notation)

The question is marked correct when the learner sets all displayed time components correctly.

## Response settings

**Response requirement** `select` (default: Correct)

Determines when the question is considered complete:

* **Correct**: The learner must answer correctly to proceed.
* **Answered**: Any response is accepted; correctness isn't required.
* **Optional**: The learner can skip the question entirely.

**Max responses** `slider` (default: 0)

The number of attempts the learner can make before the question is locked (0–3). Set to **0** for unlimited attempts.

**XP points** `slider` (default: 5)

The experience points awarded for answering the question correctly (0–10).

## Tips for teachers and parents

**Best practices:**

* Start with **analog only** for learners first learning to read clock faces
* Use **digital only** for practicing number-based time reading
* Hide minute intervals for more challenging analog clock reading
* Use "time in words" display to reinforce vocabulary (o'clock, half past, quarter to)
* Progress from o'clock → half past → quarter past/to → 5-minute intervals → any minute
* For 24-hour time, start with conversions from familiar 12-hour times


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.