https://github.com/naeemaei/persiantools.core

Persian Tools for .NET Framework and .NET Core: Shamsi date convertor, All Iranian calendar holidays. Iranian City and provinces, Iranian national ID verification.
https://github.com/naeemaei/persiantools.core

datetime dotnetcore iran iranian-calendar iranian-national-id persian persian-calendar persian-datetime persian-jalali persiandatetime persiantools shamsi-calendar shamsi-date shamsi-holiday

Last synced: 14 days ago
JSON representation

Persian Tools for .NET Framework and .NET Core: Shamsi date convertor, All Iranian calendar holidays. Iranian City and provinces, Iranian national ID verification.

• Host: GitHub
• URL: https://github.com/naeemaei/persiantools.core
• Owner: naeemaei
• License: mit
• Created: 2018-10-06T14:04:02.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2024-02-08T10:40:27.000Z (9 months ago)
• Last Synced: 2024-10-12T19:50:39.567Z (about 1 month ago)
• Topics: datetime, dotnetcore, iran, iranian-calendar, iranian-national-id, persian, persian-calendar, persian-datetime, persian-jalali, persiandatetime, persiantools, shamsi-calendar, shamsi-date, shamsi-holiday
• Language: C#
• Homepage:
• Size: 14.5 MB
• Stars: 31
• Watchers: 2
• Forks: 5
• Open Issues: 3
• Metadata Files:
  • Readme: README.MD
  • License: LICENSE

Awesome Lists containing this project

README

        


    
ابزار Persian Tools

    
ابزاری برای برنامه نویسان

    دات نت که که فیچرهای زیادی را برای شما فراهم می کند که در ادامه آنها را شرح خواهیم داد. 

    
 نکته مهم: با توجه به اینکه برخی تعطیلات بر اساس ماه های قمری می باشند و ممکن است دچار تغییرات شوند که این تغییرات قبل از وقوع حتی در time.ir هم قابل پیش بینی نبوده اند مانند عید فطر سال 1401

    بنابراین توجه داشته باشید که درصد خطایی در این حد در کتابخانه وجود دارد 






[![license](https://img.shields.io/github/license/naeemaei/PersianTools.Core)](https://github.com/naeemaei/PersianTools.Core/blob/master/LICENSE) [![forks](https://img.shields.io/github/forks/naeemaei/PersianTools.Core)]() [![stars](https://img.shields.io/github/stars/naeemaei/PersianTools.Core)](https://github.com/naeemaei/PersianTools.Core)  

![example workflow](https://github.com/naeemaei/PersianTools.COre/actions/workflows/dotnet.yml/badge.svg)

![example workflow](https://github.com/naeemaei/PersianTools.COre/actions/workflows/release.yml/badge.svg)

![example workflow](https://github.com/naeemaei/PersianTools.COre/actions/workflows/releasepreview.yml/badge.svg)



# چگونه آنرا نصب کنیم؟



## Nuget Package Manager

```

Install-Package PersianTools.Core

```

## .NET CLI

```

dotnet add package PersianTools.Core

```



# امکانات و ویژگی ها

##

- [نوع جدید تاریخ شمسی](#نوع-جدید-تاریخ-شمسی)

- [تبدیل اعداد به حروف](#تبدیل-اعداد-به-حروف)

- [لیست شهرها و استان های ایران](#)

- [اعتبار سنجی کد ملی](#اعتبار-سنجی-کد-ملی)

- [اعتبار سنجش شماره کارت بانکی](#)

- [اعتبار سنجش شماره شبا](#)

- [موقعیت مکانی شماره تلفن، موبایل و کدپستی](#)





# نوع جدید تاریخ شمسی

پس از نصب این پکیج نوع جدیدی به نام `PersianDateTime` برای شما قابل استفاده خواهد بود که ویژگی های آن را در ادامه برای شما توضیح خواهیم داد.

که با استفاده از آن میتوانید انواع تبدیل تاریخ را انجام داده و کلیه تعطیلات شمسی و قمری به همراه مناسبتهای یک تاریخ مشاهده کنید







فقط نکته ای که اهمیت داره اینه که این نوع `Reference Type` هستش و باید در استفاده ازش به این نکته نوجه کنید






## تعریف تاریخ شمسی

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



```

var persianDate1 = new PersianDateTime(1399, 10, 13); // 1

var persianDate2 = new PersianDateTime("1399/10/13"); // 2

var persianDate3 = new PersianDateTime("1399/12/29 23:30"); // 3

var persianDate4 = new PersianDateTime("1399/12/29 23:30:00"); // 4

var persianDate5 = new PersianDateTime(1399, 12, 29, 23, 30, 10); // 5

var persianDate6 = new PersianDateTime(DateTime.Now); // 6

```



## مناسبت های یک تاریخ خاص



### Example 1:

```

var dt1 = new PersianDateTime("1401/02/13").GetDateInformation();

Output:

[

  {

    "id": "61-10-02",

    "description": "تعطیل به مناسبت عید سعید فطر",

    "calenderType": 2,

    "dateType": 3,

    "isHoliDay": true,

    "calenderTypeDesc": "قمری",

    "dateTypeDesc": "تعطیل رسمی"

  }

]

```

### Example2

```

var dt1 = new PersianDateTime("1401/02/15").GetDateInformation();

Output:

[

  {

    "id": "1-02-15",

    "description": "روز بزرگداشت شیخ صدوق",

    "calenderType": 1,

    "dateType": 4,

    "isHoliDay": false,

    "calenderTypeDesc": "شمسی",

    "dateTypeDesc": "مناسبت ملی"

  },

  {

    "id": "1-02-15",

    "description": "جشن میانه بهار ، جشن بهاربد",

    "calenderType": 1,

    "dateType": 4,

    "isHoliDay": false,

    "calenderTypeDesc": "شمسی",

    "dateTypeDesc": "مناسبت ملی"

  },

  {

    "id": "1-02-15",

    "description": "روز شیراز",

    "calenderType": 1,

    "dateType": 4,

    "isHoliDay": false,

    "calenderTypeDesc": "شمسی",

    "dateTypeDesc": "مناسبت ملی"

  },

  {

    "id": "1-05-05",

    "description": "روز جهانی ماما",

    "calenderType": 3,

    "dateType": 5,

    "isHoliDay": false,

    "calenderTypeDesc": "میلادی",

    "dateTypeDesc": "مناسبت بین المللی"

  }

]

```



## فاصله دو تاریخ شمسی



```

var dt1 = new PersianDateTime("1399/12/29");

var dt2 = new PersianDateTime("1399/11/29");

Convert.ToInt32(dt1.DateDifference(dt2));

Output: 30

```



## ابتدا روز و انتهای روز



```

var dt1 = new PersianDateTime("1399/12/29 23:30:20");

var start = dt1.ShamsiStartDateTimeOfDay();

Output:

1399/12/29 00:00:00

var dt1 = new PersianDateTime("1399/12/29 23:30:20");

var end = dt1.ShamsiEndDateTimeOfDay();

Output:

1399/12/29 23:59:59

```



## آخرین روز سال



```

var d1 = PersianDateTime.ShamsiEndDateTimeOfPersianYear(1397);

Output:

1397/12/29

var d2 = PersianDateTime.ShamsiEndDateTimeOfPersianYear(1399);

Output:

1399/12/30

```



## آخرین روز ماه



```

var d1 = PersianDateTime.ShamsiEndDateTimeOfMonth(1397, 12);

Output:

1397/12/29

var d2 = PersianDateTime.ShamsiEndDateTimeOfMonth(1399, 12);

Output:

1399/12/30

```



## تعداد روزهای کاری در یک بازه تاریخی



```

var d1 = new PersianDateTime(1397, 8, 1);

var d2 = new PersianDateTime(1397, 8, 30);

PersianDateExtensions.GetWorkingDays(d1,d2);

Output:

20

PersianDateExtensions.GetWorkingDays(d1,d2, true); // با احتساب روزهای پنجشنبه غیر تعطیل

Output:

23

```



## تعداد روزهای تعطیل پشت سرهم در یک سال

ورودی اول این تابع سال شمسی و ورودی دوم تعداد روز می باشد و خروجی آن یک لیست از تاریخ های پشت سر هم که تعطیل می باشد



```

var result = PersianDateExtensions.GetContinuousHolidays(year, 3);

Output:

[Item1: 1400/03/13 - 1400/03/16, Item2: ...]

```



# تبدیل اعداد به حروف



```

int price = 11200000;

string faPrice = PersianTools.Core.CharacterUtil.Convert(price).Replace(" ", "");

Output:

یازده میلیون و دویست هزار

```



# اعتبار سنجی کد ملی



```

var nationalCode = "0032546580";

var validate = nationalCode.IsValidNationalCode();

Output:

True

```



در حال تکمیل...