---
title: countdownDuration
framework: alarmkit
role: symbol
role_heading: Instance Property
path: alarmkit/alarm/countdownduration-swift.property
---

# countdownDuration

The time left before an alert, in seconds.

## Declaration

```swift
var countdownDuration: Alarm.CountdownDuration?
```

## Discussion

Discussion When set to a non-nil value, the system shows the countdown in the Lock Screen for the specified duration. The UI will appear at a time equal to the next scheduled alert date minus the duration.

## See Also

### Defining a countdown duration

- [Alarm.CountdownDuration](alarmkit/alarm/countdownduration-swift.struct.md)
- [id](alarmkit/alarm/id.md)
- [Alarm.State](alarmkit/alarm/state-swift.enum.md)
- [state](alarmkit/alarm/state-swift.property.md)
