API تقویم پارسی برای برنامه نویسان

[Momeks.]

درود ، شاید یکی از نیاز های برنامه نویسان ایرانی استفاده از تقویم شمسی در برنامه هایشان باشد برای همین تصمیم گرفتم API مخصوص برای تقویم پارسی درست کنم که علاوه نشان دادن تاریخ شمسی ، قابلیت زمان و ساخت رویداد های تاریخی هم داشته باشه . این API با نام MKPersianCal این امکان رو برای شما فراهم کرده .

نصب API :

• ابتدا دو فایل MKPersianCal.h/m رو به درون پروژه خود درگ کنید .
• سپس کلاس ها را در ViewController.h خود import کنید :

کد: انتخاب همه

#import "MKPersianCal.h"

طریقه استفاده

ابتدا پروتکل API پیداه سازی میکنید :

کد: انتخاب همه

MKPersianCal *parsCal = [[MKPersianCal alloc] init];
        ....
    [parsCal release];

سپس نوبت به استفاده از متد هاست ، پارامتر متد های MKPersianCal از کلاس NSString استفاده شده اند پس شما می توانید، از UILabel , UItextField , UITextView و... استفاده کنید .

متد ها

تاریخ کامل شمسی :

کد: انتخاب همه

myLabel.text = [parsCal showPersianFullDate];

نشان دادن روز :

کد: انتخاب همه

myLabel.text = [parsCal showPersianDay];

نشان دادن ماه :
* اگر مقدار این متد را به YES تغییر دهید، نام ماه شمسی نشان داده می شود در غیر این صورت به صورت عدد نشان داده خواهد شد .

کد: انتخاب همه

myLabel.text = [parsCal showPersianMonthAsName:YES];

NO



نشان دادن سال :

کد: انتخاب همه

myLabel.text = [parsCal showPersianYear];

نمایش روز های هفته :

کد: انتخاب همه

myLabel.text = [parsCal showPersianWeekName];

زمان به وقت ایران :
*در صورتی که مقدار این متد YES باشد زمان به صورت 24 ساعت نمایش داده خواهد شد

کد: انتخاب همه

myLabel.text = [parsCal iranLocaleTime24h:YES];

NO



در صورت اینکه بخواهید زمان را به صورت زنده آپدیت و از ثانیه شمار استفاده کنید :

کد: انتخاب همه

- (void)viewDidLoad {

    parsCal = [[MKPersianCal alloc]init];
    [parsCal updateLocaleTime];
    [NSTimer scheduledTimerWithTimeInterval:60.0/60.0 target:self selector:@selector(myMethod) userInfo:nil repeats:YES];
   
    [super viewDidLoad];
}


- (void)myMethod {
    
    label.text = [parsCal iranLocaleTime24h:YES];
}

رویداد ها :

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

کد: انتخاب همه

[parsCal date:[NSDate date] persianDay:15 persianMonth:12];

دانلود :
http://momeks.com/MKPersianCal.zip

دوستان اگه نظر و یا سوالی درباره این API دارن لطفا در این تاپیک بیان کنن .
ممنون امیدوارم مفید بوده باشه .

[Pooria Azimi]

بسیار عالی

چند وقت پیش برای یک کاری خواستم از تقویم فارسی استفاده بکنم، و با این که می‌دونستم تقویم جلالی ایرماگ یک مبدیل شمسی/میلادی داره که احتمالاً به‌درد می‌خوره، اما بی‌خیالش شدم و کار رو با همون میلادی انجام دادم.


به‌نظرم سورسش رو روی Github بذارید تا راحت‌تر بشه pull request و ... فرستاد.

[Momeks.]

github هم به زودی آپلود میشه ممنون

[Ahmad]

ممنون آقای کمیلی، دستتان درد نکند.
احمد

[delsanik91]

ممنون واقعا .