Persian.Plus

A set of utilities for Persian/Farsi text processing, validation, number conversion, and date handling in .NET.

Packages

Package	NuGet
Persian.Plus	https://www.nuget.org/packages/Persian.Plus
Persian.Plus.FluentValidation	https://www.nuget.org/packages/Persian.Plus.FluentValidation

Install

dotnet add package Persian.Plus
dotnet add package Persian.Plus.FluentValidation

Persian.Plus

Persian.Plus provides:

• Persian calendar/date-time helpers (PersianDateTime, events/holidays)
• Persian text and phrase validation helpers
• Iranian national identifiers validation (National Code, National Legal Code, Postal Code)
• Iranian bank validations (IBAN, Shetab card)
• Iranian mobile number validation, coercion, and masking
• Persian/English number conversion and number-to-text (Textify)
• DataAnnotations attributes for ASP.NET Core and model validation
• Persian text normalization utilities

PersianDateTime samples

using System;
using System.Linq;
using Persian.Plus.DateTime;

// 1) Create from Jalali date parts
var a = new PersianDateTime(1403, 12, 29, 14, 30, 45);
Console.WriteLine($"{a:yyyy/MM/dd HH:mm:ss}");
// Output: 1403/12/29 14:30:45

// 2) Convert from System.DateTime (Gregorian -> PersianDateTime)
var g = new DateTime(2025, 3, 20, 10, 0, 0);
var b = new PersianDateTime(g);
Console.WriteLine($"{b:yyyy/MM/dd HH:mm:ss}");
// Output: 1403/12/30 10:00:00

// 3) Parse supported string formats
var p1 = PersianDateTime.Parse("1404/01/01");
Console.WriteLine($"{p1:yyyy/MM/dd}");
// Output: 1404/01/01

var p1b = PersianDateTime.Parse("14040101");
Console.WriteLine($"{p1b:yyyy/MM/dd}");
// Output: 1404/01/01

var p2 = PersianDateTime.Parse("14040101112233");
Console.WriteLine($"{p2:yyyy/MM/dd HH:mm:ss}");
// Output: 1404/01/01 11:22:33

var unixSeconds = PersianDateTime.Parse("1711900800");
Console.WriteLine($"{unixSeconds:yyyy/MM/dd HH:mm:ss}");
// Output: (depends on local timezone conversion)

var unixMilliseconds = PersianDateTime.Parse("1711900800000");
Console.WriteLine($"{unixMilliseconds:yyyy/MM/dd HH:mm:ss}");
// Output: (depends on local timezone conversion)

// 4) TryParse
var ok = PersianDateTime.TryParse("1404-01-15", out var p3);
Console.WriteLine(ok);
// Output: True
Console.WriteLine($"{p3:yyyy/MM/dd}");
// Output: 1404/01/15

var bad = PersianDateTime.TryParse("not-a-date", out var _);
Console.WriteLine(bad);
// Output: False

// 5) Date arithmetic
var d = new PersianDateTime(1404, 1, 1);
Console.WriteLine($"{d.AddDays(10):yyyy/MM/dd}");
// Output: 1404/01/11
Console.WriteLine($"{d.AddMonths(1):yyyy/MM/dd}");
// Output: 1404/02/01
Console.WriteLine($"{d.AddYears(1):yyyy/MM/dd}");
// Output: 1405/01/01

// 6) Operators and comparisons
var x = new PersianDateTime(1404, 1, 1);
var y = new PersianDateTime(1404, 1, 2);
Console.WriteLine(x < y);
// Output: True
Console.WriteLine(y > x);
// Output: True
Console.WriteLine(x == new PersianDateTime(1404, 1, 1));
// Output: True

// 7) TimeSpan operators
var plus = x + TimeSpan.FromDays(5);
Console.WriteLine($"{plus:yyyy/MM/dd}");
// Output: 1404/01/06

var diff = y - x;
Console.WriteLine(diff.TotalDays);
// Output: 1

// 8) Implicit conversion with System.DateTime
DateTime systemDate = x;
PersianDateTime backToPersian = systemDate;
Console.WriteLine($"{backToPersian:yyyy/MM/dd}");
// Output: 1404/01/01

// 9) Properties
Console.WriteLine(x.Year);        // Output: 1404
Console.WriteLine(x.Month);       // Output: 1
Console.WriteLine(x.Day);         // Output: 1
Console.WriteLine(x.IsLeapYear);  // Output: False (for 1404)
Console.WriteLine(x.DaysInMonth); // Output: 31 (Farvardin)

// 10) Now
var now = PersianDateTime.Now;
Console.WriteLine($"{now:yyyy/MM/dd HH:mm:ss}");
// Output: (current Persian date/time)

// 11) Events and holidays in range
var start = new PersianDateTime(1404, 1, 1);
var end = new PersianDateTime(1404, 1, 31);
var events = start.GetEventsTill(end);
var holidays = events.Where(e => e.EventType.HasFlag(EventType.Holiday));
Console.WriteLine(holidays.Any());
// Output: True

Other examples

NormalizePersianText cleans and standardizes Persian text. Based on selected flags it can fix Arabic/Persian character variants (like ي -> ی, ك -> ک), apply half-space/ZWNJ rules, normalize spacing/line-breaks, remove diacritics, and run punctuation cleanup.

using Persian.Plus.DateTime;
using Persian.Plus.Extensions;
using Persian.Plus.Extensions.Number;
using Persian.Plus.Extensions.Normalizer;

// Mobile number
var normalized = "+989121234567".CoerceIranianMobileNumber();
// Output: 09121234567
var masked = "09121234567".MaskIranianMobileNumber();
// Output: 091212xxx67
var isValidMobile = "9121234567".IsValidIranianMobileNumber();
// Output: true

// Persian/English phrase checks
var isPersian = "علیرضا وفی".ContainsOnlyPersianLetters();
// Output: true
var isMixed = "علیرضا Vafi".ContainsOnlyPersianOrEnglishLetters();
// Output: true

// Number helpers
var persianDigits = "123456".ToPersianNumbers();
// Output: ۱۲۳۴۵۶
var englishDigits = "۱۲۳۴۵۶".ToEnglishNumbers();
// Output: 123456
var words = 1250.Textify(Language.Persian);
// Output: یکهزار و دویست و پنجاه

// Normalizer
var normalizedText = "سلام  دنيا".NormalizePersianText(
    PersianNormalizerFlags.ApplyPersianCharacters |
    PersianNormalizerFlags.ApplyHalfSpaceRule |
    PersianNormalizerFlags.CleanupSpacingAndLineBreaks);
// Output: سلام دنیا

var today = PersianDateTime.Now;
var nowFormatted = $"{today:yyyy/MM/dd HH:mm:ss}";
// Output: (current Persian date/time)

DataAnnotations example

using Persian.Plus.DataAnnotations;

public class PersonDto
{
    [PersianLetters]
    public string Name { get; set; }

    [IranianNationalCode]
    public string NationalCode { get; set; }

    [IranianMobileNumber]
    public string MobileNumber { get; set; }
}

Persian.Plus.FluentValidation

Adds Persian/Iranian validators as FluentValidation rule extensions.

Available rule extensions include:

• PersianPhrase()
• PersianOrEnglishPhrase()
• PersianLetters()
• PersianDateTime()
• IranianNationalCode()
• IranianNationalLegalCode()
• IranianPostalCode()
• IranianMobileNumber()
• IranianIbanNumber(params string[] bankCodes)
• IranianShetabCardNumber(params string[] cardBins)

FluentValidation example

using FluentValidation;
using Persian.Plus;
using Persian.Plus.FluentValidation.Extensions;

public class BankAccountInfo
{
    public string IbanNumber { get; set; }
    public string ShetabCardNumber { get; set; }
}

public class BankAccountInfoValidator : AbstractValidator<BankAccountInfo>
{
    public BankAccountInfoValidator()
    {
        RuleFor(x => x.IbanNumber)
            .IranianIbanNumber(IranBankConstants.BankCodes.Melli);

        RuleFor(x => x.ShetabCardNumber)
            .IranianShetabCardNumber(IranBankConstants.BankCardBins.Melli);
    }
}

License

This project is licensed under MIT. See LICENSE.md.