EbiRom.DTC 3.0.0

EbiRom.DTC - DateTime Culture Formatter

EbiRom.DTC - DateTime Culture Formatter

یک کتابخانه قدرتمند و کارآمد برای فرمت‌دهی تاریخ و زمان به زبان‌های فارسی، عربی و انگلیسی که از تمامی نسخه‌های .NET پشتیبانی می‌کند.

توسعه‌دهنده: EbiRom GitHub: EbiRom96 NuGet: EbiRom

نصب

از طریق NuGet:

Install-Package EbiRom.DTC

از طریق .NET CLI:

dotnet add package EbiRom.DTC

شروع سریع

using EbiRom.DTC;

فرمت‌دهی تاریخ و زمان کنونی به فارسی

string result = DateTimeFormatter.FormatNow("Year-####", "fa"); Console.WriteLine(result); // خروجی: 1403

فرمت‌دهی تاریخ و زمان خاص

DateTime date = new DateTime(2024, 1, 15, 14, 30, 45); string formatted = DateTimeFormatter.Format(date, "Day-Name", "fa"); Console.WriteLine(formatted); // خروجی: دوشنبه

فرمت‌های پشتیبانی شده

بخش‌های تاریخ:

فرمت توضیح مثال (فارسی) Day-## روز با دو رقم 15 → 15 Day-# روز با یک یا دو رقم 15 → 15، 5 → 5 Day-Name نام روز هفته دوشنبه Month-## ماه با دو رقم 1 → 01 Month-# ماه با یک یا دو رقم 1 → 1، 12 → 12 Month-Name نام ماه فروردین Year-#### سال با چهار رقم 1403 Year-## سال با دو رقم 1403 → 03

بخش‌های زمان:

فرمت توضیح مثال Hour-## ساعت با دو رقم (24 ساعته) 14 → 14 Hour-# ساعت با یک یا دو رقم (24 ساعته) 14 → 14، 5 → 5 Minute-## دقیقه با دو رقم 5 → 05 Minute-# دقیقه با یک یا دو رقم 5 → 5، 15 → 15 Second-## ثانیه با دو رقم 5 → 05 Second-# ثانیه با یک یا دو رقم 5 → 5، 15 → 15 MiliSecond-## میلی‌ثانیه با دو رقم 123 → 12 MiliSecond-# میلی‌ثانیه با یک رقم 123 → 1 AM-PM نشانگر قبل/بعد از ظهر ب.ظ یا ق.ظ

پشتیبانی از زبان‌ها

فارسی (پیش‌فرض)

DateTimeFormatter.Format(dateTime, "Month-Name", "fa"); // خروجی: فروردین

عربی

DateTimeFormatter.Format(dateTime, "Month-Name", "ar"); // خروجی: يناير

انگلیسی

DateTimeFormatter.Format(dateTime, "Month-Name", "en"); // خروجی: January

مثال‌های کامل

using EbiRom.DTC;

ایجاد یک تاریخ نمونه

DateTime sampleDate = new DateTime(2024, 3, 20, 14, 30, 45, 123);

مثال‌های فارسی

Console.WriteLine(DateTimeFormatter.Format(sampleDate, "Day-##", "fa")); // 20 Console.WriteLine(DateTimeFormatter.Format(sampleDate, "Day-Name", "fa")); // چهارشنبه Console.WriteLine(DateTimeFormatter.Format(sampleDate, "Month-##", "fa")); // 01 Console.WriteLine(DateTimeFormatter.Format(sampleDate, "Month-Name", "fa")); // فروردین Console.WriteLine(DateTimeFormatter.Format(sampleDate, "Year-####", "fa")); // 1403 Console.WriteLine(DateTimeFormatter.Format(sampleDate, "Hour-##", "fa")); // 14 Console.WriteLine(DateTimeFormatter.Format(sampleDate, "AM-PM", "fa")); // ب.ظ

مثال‌های عربی

Console.WriteLine(DateTimeFormatter.Format(sampleDate, "Month-Name", "ar")); // مارس

مثال‌های انگلیسی

Console.WriteLine(DateTimeFormatter.Format(sampleDate, "Month-Name", "en")); // March

استفاده از تاریخ و زمان کنونی

Console.WriteLine(DateTimeFormatter.FormatNow("Year-####", "fa")); // 1403 Console.WriteLine(DateTimeFormatter.FormatUtcNow("Hour-##", "en")); // 10

ویژگی‌های کلیدی

• ✅ پشتیبانی از تمام نسخه‌های .NET
• ✅ کارایی و سرعت بالا
• ✅ پایداری و ثبات کامل
• ✅ عدم وابستگی به کتابخانه‌های خارجی
• ✅ مستندات کامل و مثال‌های متعدد
• ✅ قابل استفاده در پروژه‌های تجاری

پشتیبانی از فریم‌ورک‌ها

این کتابخانه از فریم‌ورک‌های زیر پشتیبانی می‌کند:

• .NET Standard 2.0+
• .NET Core 3.1+
• .NET 5.0+
• .NET 6.0+
• .NET 7.0+
• .NET 8.0+

Install-Package EbiRom.DTC