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

# locale

> The language, region and calendar this device is set to

Reads the device's current locale directly — no hook installed. One reading,
taken once when the instrument activates.

| | |
| - | - |
| [Delivery](/instruments/metadata) | reading, once |
| Mechanism | statusRead |
| [Requires](/instruments/metadata) | iOS 17+, basset 0.1.1+ |

Real output from `basset request get`, captured against a running app:

```
CAPTURED                  ELAPSED  INSTRUMENT

launch 7944225966318874854
2026-08-23T14:12:54.780Z  +0.0s    environment.locale(deviceSetting)
├─ languageCode        en
├─ calendarIdentifier  gregorian
├─ layoutDirection     leftToRight
├─ regionCode          US
├─ usesMetricSystem    false
└─ uses24HourTime      false
```


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