2017 © Pedro Peláez
 

library persian-date

Persian Date for PHP ( Object Oriented API )

image

mtm/persian-date

Persian Date for PHP ( Object Oriented API )

  • Tuesday, January 31, 2017
  • by motammem
  • Repository
  • 0 Watchers
  • 2 Stars
  • 169 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 7 Versions
  • 2 % Grown

The README.md

# Persian Date (Object Oriented API)

Stable release Total Downloads License Build Status, (*1)

This project provides an easy to use Object Oriented API to work with persian date and time., (*2)

Provided PersianDate class extends Standard PHP DateTime class and has it's all capabilities., (*3)

Installation:

Open your terminal and enter:, (*4)

composer require mtm/persian-date

Usage:

When you want build a PersianDate instance:, (*5)

$persianDateTime = new Mtm\PersianDate\PersianDate();

When you want build a PersianDate instance from exact date:, (*6)

$persianDateTime = Mtm\PersianDate\PersianDateFactory::buildFromExactDate(null, null, null, 9, 19 ,1370);

When you want to convert PHP Standard Datetime to PersianDate instance from standard PHP Standard DateTime object:, (*7)

$standardDateTime = new \DateTime();
$persianDateTime = Mtm\PersianDate\PersianDateFactory::buildFromOriginalDateTime($standardDateTime);

When you want to convert PersianDate instance to PHP Standard DateTime object:, (*8)

$standardDateTime = $persianDateTime->getOriginalDateTime();

When you want to set date on PersianDate instance, (*9)

$persian_year = 1370;
$persian_month = 9;
$persian_day = 19;

$persianDateTime->setDate($persian_year, $persian_month, $persian_day);

Formats

And finally when you want to print in various formats:, (*10)

$persianDateTime->format("Y-m-d"); // prints: 1370-9-19

$persianDateTime->format("f y"); // prints: پاییز 94
(?) مثال ۲ مثال ۱ دامنه کاربرد های متد format() کاراکتر
- - - - کاراکترها با حروف کوچک کوچک
+ ب.ظ ق.ظ ق.ظ | ب.ظ اوقات روز - به صورت خلاصه a
! ۴ ۱ ۱ - ۴ شماره ی فصل (ربع) از سال b
+ ۱۳۸۹/۱۱/۲۲ ،۰۹:۴۶:۳۱ +۰۳:۳۰ ۱۳۹۰/۴/۴ ،۱۳:۰۸:۲۶ +۰۴:۳۰ : طبق نمونه Y/n/j ,H:i:s P :(ltr) ۱ قالب مرکّب c
+ ۲۳ ۹ ۰۱ - ۳۱ شماره ی روز از ماه - ۲ رقمی d
+ Asia/Tehran Greenwich مناطق زمانی منطقه ی زمانی تنظیم شده e
! زمستان تابستان بهار تا زمستان نام فصل با حروف فارسی f
+ ۱۲ ۷ ۱ - ۱۲ ساعت در روز -۱۲ساعته -۱یا۲رقمی g
+ ۱۲ ۰۷ ۰۱ - ۱۲ ساعت در روز - ۱۲ ساعته - ۲رقمی h
+ ۲۱ ۱۷ ۰۰ - ۵۹ دقیقه در ساعت - ۲ رقمی i
+ ۲۳ ۲ ۱ - ۳۱ شماره ی روز از ماه - ۱یا۲ رقمی j
! ۱۶ ۷۶.۲ ۰ - ۱۰۰ (**.?) در صد باقیمانده از سال k
+ چهار شنبه شنبه شنبه تا جمعه نام روز در هفته - کامل l
+ ۱۰ ۰۳ ۰۱ - ۱۲ شماره ی ماه از سال - ۲رقمی m
+ ۱۰ ۳ ۱ - ۱۲ شماره ی ماه از سال - ۱یا۲رقمی n
+ ۱۳۸۹ ۱۳۹۱ شماره ی سال سال هفته ای (به عدد) چهار رقمی o
! دلو جوزا حمل تا حوت نام باستانی برج ها p
! پلنگ گاو موش تا خوک نام حیوانی سال ها q
+ ۰۹:۴۶:۳۱ +۰۳۳۰ جمعه، ۲۲ بهمن ۱۳۸۹ ۱۳:۰۸:۲۶ +۰۴۳۰ شنبه، ۴ تیر ۱۳۹۰ : طبق نمونه H:i:s O Y F j ,l :(ltr) ۲ قالب مرکّب r
+ ۱۷ ۰۹ ۰۰ - ۵۹ شماره ی ثانیه در دقیقه - ۲ رقمی s
+ ۳۰ ۳۱ ۳۱ | ۳۰ | ۲۹ تعداد روزهای (همان) ماه t
+ ۷۳۹۰۳۱ ۰۰۰۰۰۰ : طبق نمونه میکرو ثانیه - ۶ رقمی u
! هشتاد و نه نود و یک از ‍ تا نود و نه سال به حروف - خلاصه ی دو رقمی v
+ ۳ ۰ ۰ - ۶ شنبه=۰ ،عدد روز در هفته (IR) w
+ ۸۹ ۹۱ ۰۰ - ۹۹ سال (به عدد) دو رقمی y
+ ۳۰۴ ۴۱ ۰ - (۳۶۴|۳۶۵) تعداد روز (کامل) گذشته از سال z
- - - - کاراکترها با حروف بزرگ بزرگ
+ بعد از ظهر قبل از ظهر : طبق نمونه اوقات روز _ کامل A
+ ۷۱۰ ۰۹۸ ۰۰۰ - ۹۹۹ GMTزمان اینترنتی،۱.۴۴ دق‍ از۲۳:۰۰ B
! ۱۵ ۱۴ ...|۱۵|۱۴|... شماره ی قرن هجری شمسی C
+ چ ش ش تا ج حرف اوّل نام روز هفته، ش=شنبه D
+ دی خرداد فروردین تا اسفند نام ماه از سال - کامل F
+ ۱۹ ۷ ۰ - ۲۳ ساعت در روز - ۲۴ساعته -۱یا۲رقم G
+ ۱۹ ۰۷ ۰۰ - ۲۳ ساعت در روز - ۲۴ساعته -۲رقمی H
+ ۱ ۰ ۰ | ۱ نشانگر طولانی بودن روز = ۱ I
! بیست و نه دو یک تا سی و یک شماره ی روز از ماه به حروف J
! ۸۳.۳ ۱۴ ۱۰۰ - ۰ (**.?) در صد گذشته از سال K
+ ۰ ۱ ۰ | ۱ سال : کبیسه=۱ و غیر کبیسه=۰ L
+ دی خر فر تا اس‍ نام ماه از سال - خلاصه M
+ ۳ ۷ ۱ - ۷ یک شنبه=۱ ،عدد روز در هفته (IR) N
+ +۰۳۳۰ +۰۴۳۰ -۱۲۰۰ ، +۱۴۰۰ ":" اختلاف ساعت جهانی - بدون O
+ +۰۳:۳۰ +۰۴:۳۰ -۱۲:۰۰ ، +۱۴:۰۰ ":" اختلاف ساعت جهانی - با P
! ۶۱ ۳۲۴ (۳۶۵|۳۶۴) - ۰ تعداد روز (کامل) باقی مانده از سال Q
+ ام ام ام "واژه ی "ام S
+ IRST IRDT مخفف مناطق مخفّف منطقه ی زمانی تنظیم شده T
+ ۱۲۹۵۴۳۶۴۶۷ ۱۲۴۳۹۵۵۳۴۶ : طبق نمونه timestamp (Unix) برچسب زمانی U
! هزار و سیصد و هشتاد و نه هزار و سیصد و نود و یک : طبق نمونه سال به حروف - کامل V
+ ۴۳ ۱۱ ۰۰ - (۵۲|۵۳) شماره ی این هفته در سال - ۲رقم W
+ ۱۳۸۹ ۱۳۹۱ : طبق نمونه سال (به عدد) چهار رقمی Y
+ ۱۲۶۰۰ ۱۶۲۰۰ -۴۳۲۰۰ ، ۵۰۴۰۰ اختلاف ساعت جهانی به ثانیه Z

The Versions

31/01 2017

dev-master

9999999-dev

Persian Date for PHP ( Object Oriented API )

  Sources   Download

MIT

The Development Requires

by Amin Alizade

21/09 2016

1.1.2

1.1.2.0

Persian Date for PHP ( Object Oriented API )

  Sources   Download

MIT

The Development Requires

by Amin Alizade

21/09 2016

1.1.1

1.1.1.0

Persian Date for PHP ( Object Oriented API )

  Sources   Download

MIT

The Development Requires

by Amin Alizade

21/09 2016

1.1

1.1.0.0

Persian Date for PHP ( Object Oriented API )

  Sources   Download

MIT

The Development Requires

by Amin Alizade

17/09 2016

1.0.3

1.0.3.0

Persian date time to work with.

  Sources   Download

MIT

by Amin Alizade

13/09 2015

v1.0.2

1.0.2.0

Persian date time to work with.

  Sources   Download

MIT

by Amin Alizade

14/08 2015

v1.0.1

1.0.1.0

Persian date time to work with.

  Sources   Download

MIT

by Amin Alizade