Skip to content

Persian (Iran) (fa-IR)

Complete reference for the fa-IR locale — live Intl API output, CLDR plural rules, and framework config snippets.

Locale reference

Persian (Iran)

Locale metadata

BCP 47 codefa-IR
Native nameفارسی (ایران)
English namePersian (Iran)
Languagefa
RegionIR
ScriptArab
Text directionRight-to-left (RTL)
CLDR plural categoriesone, other
Estimated speakers~70,000,000

Intl API Live Output

DateTimeFormat

Short۱۴۰۵/۶/۲۳
Medium۲۳ شهریور ۱۴۰۵
Long۲۳ شهریور ۱۴۰۵
Full۱۴۰۵ شهریور ۲۳, دوشنبه

NumberFormat

Decimal۱٬۲۳۴٬۵۶۷٫۸۹
Currency (USD)‎$۹٫۹۹
Percent۷۵٪
Compact۱٫۲ میلیون

RelativeTimeFormat

۳ روز پیش

Output for: -3 days ago

ListFormat

apples،‏ oranges، و bananas

Conjunction list: apples, oranges, bananas

CLDR Plural Rules

Categories supported by fa-IR: one, other

oneExample number: 1
one
otherExample number: 100
other

Framework Config Snippets

next-intl
// next-intl configuration
// next.config.ts
import createNextIntlPlugin from 'next-intl/plugin';
const withNextIntl = createNextIntlPlugin();
export default withNextIntl({});

// i18n/routing.ts
import { defineRouting } from 'next-intl/routing';
export const routing = defineRouting({
  locales: ['fa-IR', 'en'],
  defaultLocale: 'en',
});
react-intl
// react-intl configuration
import { IntlProvider } from 'react-intl';
import messages from './messages/fa-IR.json';

function App() {
  return (
    <IntlProvider locale="fa-IR" messages={messages}>
      {/* your app */}
    </IntlProvider>
  );
}
i18next
// i18next configuration
import i18n from 'i18next';
import { initReactI18next } from 'react-i18next';

i18n
  .use(initReactI18next)
  .init({
    lng: 'fa-IR',
    fallbackLng: 'en',
    resources: {
      'fa-IR': {
        translation: require('./locales/fa-IR/translation.json'),
      },
    },
  });

export default i18n;

Related Locales

Persian (Iran) is supported by Better I18N

Add fa-IR to your project in seconds — no manual config required.

Start free trial

More tools

Free tools for the rest of your i18n workflow: locale data, ICU messages, file formats and hreflang.

Ready to ship globally?

Join hundreds of teams using Better I18N to deliver faster, context-aware translations.

Already shipping with Better I18N