انجمن ویکی قلم‌های فارسی
ورود / عضویت

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

محلی برای نرم افزارهای سایت ساز و مباحث مربوط به برنامه‌نویسی چون Objective-C ،Cocoa و غیره

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

پستتوسط Momeks. » 15 ژانویه 2012, 18:23

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

[SIZE="2"]نصب API :[/SIZE]
  • ابتدا دو فایل MKPersianCal.h/m رو به درون پروژه خود درگ کنید .
  • سپس کلاس ها را در ViewController.h خود import کنید :
کد: انتخاب همهٔ
#import "MKPersianCal.h"


[SIZE="2"]طریقه استفاده [/SIZE]

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

کد: انتخاب همهٔ
MKPersianCal *parsCal = [[MKPersianCal alloc] init];
        ....
    [parsCal release];


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

[SIZE="2"]متد ها [/SIZE]

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

کد: انتخاب همهٔ
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 دارن لطفا در این تاپیک بیان کنن .
ممنون امیدوارم مفید بوده باشه .
Momeks.
 
پست‌ها : 9
تاریخ عضویت: 13 اکتبر 2011, 17:57

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

پستتوسط Pooria Azimi » 15 ژانویه 2012, 20:38

بسیار عالی :-)

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


به‌نظرم سورسش رو روی Github بذارید تا راحت‌تر بشه pull request و ... فرستاد. :-)
نماد کاربر
Pooria Azimi
Site Admin
 
پست‌ها : 3332
تاریخ عضویت: 23 اوت 2008, 14:32
محل سکونت: Santa Barbara, CA

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

پستتوسط Momeks. » 15 ژانویه 2012, 21:00

github هم به زودی آپلود میشه :-) ممنون
Momeks.
 
پست‌ها : 9
تاریخ عضویت: 13 اکتبر 2011, 17:57

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

پستتوسط Ahmad » 16 ژانویه 2012, 01:00

ممنون آقای کمیلی، دستتان درد نکند.
احمد
نماد کاربر
Ahmad
Site Admin
 
پست‌ها : 1289
تاریخ عضویت: 30 مه 2004, 17:33
محل سکونت: سوئد

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

پستتوسط delsanik91 » 22 مه 2017, 20:28

ممنون واقعا .
delsanik91
 
پست‌ها : 3
تاریخ عضویت: 22 مه 2017, 18:00



بازگشت به برنامه‌نویسی


کاربران حاضر در این انجمن: بدون کاربران آنلاین و 6 مهمان