Locale Preferences
Locale, timezone, currency, and date/number format. Used by field mappings and parsing.
What are locale preferences
Locale preferences control how numbers and dates are parsed and formatted. They are part of TenantSetting.localePreferences and are used by:
- Field mappings — Transforms like
parseLocaleNumber,parseDateuse these settings - Number parsing — Decimal separators (
.vs,), thousands separators - Date formatting — Display and parsing of dates
Configure locale preferences when your data uses non-US formats (e.g. European 1.234,56 or dd.MM.yyyy).
When to configure
- Stripe/CSV from EU — Set
locale: de-DE,dateFormatPref: european,numberFormat: de-DE - Multi-currency — Set
currencyCodeto match your primary currency - Timezone — Set
timezonefor correct date handling (e.g.Europe/Zurich)
Attributes
| Attribute | Purpose |
|---|---|
| locale | BCP 47 (e.g. en-US, de-DE) |
| timezone | IANA (e.g. America/New_York) |
| currencyCode | ISO 4217 (USD, EUR) |
| dateFormatPref | iso, european, or us |
| numberFormat | e.g. en-US, de-DE |
Defaults
When not set: locale: en-US, timezone: UTC, currencyCode: USD, dateFormatPref: us, numberFormat: en-US.
Related
- Field Mappings — How locale affects transformations
- Tenant Settings — Parent structure