Persian Number Utility — Flutter Skill

Purpose

This skill provides authoritative, production-grade engineering instructions for integrating, formatting, normalizing, validating, and testing Persian numbers, words, dates, currency, and Iranian identifiers in Flutter applications using the persian_number_utility package (v1.1.6).

When to Use This Skill

• Formatting numbers, dates, currency amounts, or card numbers into Persian digits (۱۲۳) and separated groups (۱۰۰,۰۰۰).
• Converting numbers to Persian words (e.g., 1000 -> یک هزار) or words back to integers (toNumber()).
• Validating Iranian syntactic formats: National Code (کد ملی), Bank Card (شماره کارت), Mobile Number (شماره موبایل), Postal Code (کد پستی), and Sheba (شبا).
• Normalizing user input containing mixed Persian (۰-۹), Arabic (٠-٩), and Latin (0-9) digits into canonical ASCII for backend storage or parsing.
• Converting Gregorian DateTime to Jalali/Shamsi (هجری شمسی) representation and relative time strings.