# LocalTimeSource

> CompositionLocal providing the [TimeSource] for [TimeText].

## API Reference

> Source set: Android

```kotlin
public val LocalTimeSource: ProvidableCompositionLocal<TimeSource> = staticCompositionLocalOf {
    DefaultTimeSource()
}
```

CompositionLocal providing the [TimeSource](https://composables.com/jetpack-compose/androidx.wear.compose/compose-material3/interfaces/TimeSource/api.md) for [TimeText](https://composables.com/jetpack-compose/androidx.wear.compose/compose-material3/components/TimeText/api.md).

This provides the mechanism to override the time source for composables that may display
[TimeText](https://composables.com/jetpack-compose/androidx.wear.compose/compose-material3/components/TimeText/api.md) without providing a slot for an explicit `timeSource` parameter, such as the fallback
[TimeText](https://composables.com/jetpack-compose/androidx.wear.compose/compose-material3/components/TimeText/api.md) provided by [AppScaffold](https://composables.com/jetpack-compose/androidx.wear.compose/compose-material3/components/AppScaffold/api.md) or [ScreenScaffold](https://composables.com/jetpack-compose/androidx.wear.compose/compose-material3/components/ScreenScaffold/api.md) for platform builds that do not support
the system status bar.

Example of providing a fixed time for testing:

## Code Examples

### TimeTextOverrideTimeSourceForTesting

```kotlin
@Sampled
@Composable
fun TimeTextOverrideTimeSourceForTesting() {
    val fixedTimeSource = remember {
        object : TimeSource {
```