Locale Fa Ir
Use when working with the Persian (Iran) locale (`fa-IR`) — its endonym فارسی (ایران), Arabic script, right-to-left (RTL) direction, or spoken-population data. Reference data and translation guidance (register, grammar, idiom, typography) for this specific locale; see [[locale]] for general i18n/l10n concepts (BCP 47, plural rules, RTL) that apply across all locales.
Reference data for the Persian (Iran) locale — endonym فارسی (ایران), written in the Arabic script, right-to-left (RTL).
Identifiers
- BCP 47 tag:
fa-IR - ISO 639-1:
fa - ISO 639-3:
fas - Script: Arab (Arabic)
- Region: IR (Iran)
- Text direction: rtl — right-to-left (RTL)
Speakers (approximate)
- L1 (native): 71,000,000
- L2 (additional): 20,000,000
- L1+L2 (total): 91,000,000
Set dir="rtl" for this locale (per Locale's text-direction guidance) rather than assuming left-to-right layout.
Base locale
This is a regional variant of Locale Fa 001 (Persian), the base/macro locale for this language.
Pluralization
CLDR plural categories for this locale: one, other (2 forms).
- one —
i = 0 or n = 1(e.g. 0, 1) - other — everything else (e.g. 2~17, 100, 1000, 10000, …)
See Unicode Messageformat for writing plural messages using these categories.
Translating into this locale
Apply Locale Fa 001 with the conventions of Iran.
- Calendar and formats: Solar Hijri dates in daily life and government; Persian digits; rial or toman as the project specifies; decimal separator
٫(Arabic decimal) or.and thousands separator٬or,per CLDRfa. - Terminology: Iranian official content follows the Academy's terms and government usage.
- Tone: polite, indirect, and elaborate; honorific phrases are natural in correspondence.
- Content context: content in Iran is subject to local legal and content rules; check them for sensitive text and imagery.
Common pitfalls
- Using Dari or Tajik vocabulary for an Iranian audience.
- Using Gregorian dates only on official forms.
- The general pitfalls in Locale Fa 001 also apply.
Learn more
- Locale for BCP 47 identifiers, locale-sensitive formatting, pluralization, and text-direction concepts that apply across all locales.
- Unicode Messageformat for writing plural/selection messages correctly for this locale's grammar.
- Unicode CLDR locale data for number, calendar, and currency formats (https://cldr.unicode.org)