farsidate.js | تاریخ فارسی

Javascript Farsi Date Extension
WebSite: http://farsidate.ir
version: 1.0.2

Farsi Date

size: 10 KB

Browser

<script src="./dist/farsidate-1.0.2.min.js" type="text/javascript"></script>

<p id="demo"></p>

<script type="text/javascript">
   var date = new Date().fa().toString('yyyy'); // 1397 
  	document.getElementById("demo").innerHTML = date;
</script>

Chaining

console.log(new Date().fa(1397,1,15).norm().toISODate());  // 2018-5-5
console.log(new Date().fa(1397,1,15).addDays(3).addMonths(1).addYears(-1).norm().toISODate());  // 2017-6-8

Example Usage

fa() main method

var fD1 = new Date('2018-11-13').fa(); 
console.log('year: '+ fD1.getFullYear()); // year: 1397
console.log('month: '+ fD1.getMonth()); // month: 7 (0-11)
console.log('date: '+ fD1.getDate()); // date: 22

fD2 = new Date().fa(1396, 8, 21);
console.log('year: '+ fD2.getFullYear()); // year: 1396
console.log('month: '+ fD2.getMonth()); // month: 8
console.log('date: '+ fD2.getDate()); // date: 21

var fD3 = new Date().fa(fD2);
console.log('year: '+ fD3.getFullYear()); // year: 1396
console.log('month: '+ fD3.getMonth()); // month: 8
console.log('date: '+ fD3.getDate()); // date: 21

norm() method

var fD = new Date('2018-11-13').fa(); 
console.log('year: '+ fD.getFullYear()); // year: 1397
console.log('month: '+ fD.getMonth()); // month: 7
console.log('date: '+ fD.getDate()); // date: 22
console.log('year: '+ fD.norm().getFullYear());  // year: 2018

getCacheDate() method

var fD = new Date('2018-11-13').fa(); 
console.log('year: '+ fD.getFullYear()); // year: 1397
console.log('month: '+ fD.getMonth()); // month: 7 (0-11)
console.log('date: '+ fD.getDate()); // date: 22
console.log('year: '+ fD.getCacheDate().getFullYear());  // year: 2018

toString() method

var date = new Date();
console.log('s: '+ date.fa().toString('s')); // s: 0
console.log('ss: '+date.fa().toString('ss')); // ss: 00
console.log('m: '+date.fa().toString('m')); // m: 4
console.log('mm: '+date.fa().toString('mm')); // mm: 04
console.log('h: '+date.fa().toString('h')); // h: 2
console.log('hh: '+date.fa().toString('hh')); // h: 02
console.log('H: '+date.fa().toString('H')); // H: 2
console.log('HH: '+date.fa().toString('HH')); // HH: 02
console.log('d: '+date.fa().toString('d')); // d: 19
console.log('dd: '+date.fa().toString('dd')); // dd: 19
console.log('ddd: '+date.fa().toString('ddd')); // ddd: چ
console.log('dddd: '+date.fa().toString('dddd')); // dddd: چهار شنبه
console.log('M: '+date.fa().toString('M')); // M: 10 (1-12)
console.log('MM: '+date.fa().toString('MM')); // MM: 10 (1-12)
console.log('MMM: '+date.fa().toString('MMM')); // MMM: دی
console.log('MMMM: '+date.fa().toString('MMMM')); // MMMM: دی
console.log('yy: '+date.fa().toString('yy')); // yy: 97
console.log('yyyy: '+date.fa().toString('yyyy')); // yyyy: 1397
console.log('t: '+date.fa().toString('t')); // t: A
console.log('tt: '+date.fa().toString('tt')); // tt: AM
console.log(date.fa().toString()); // چ دی 19 1397 04:30:57 GMT+0330 (Iran Standard Time)

Converting to String

Note The format parameter is optional with the .toString() function.

Standard Date and Time Format Specifiers

Format	Description	Example
s	The seconds of the minute between 0-59.	"0" to "59"
ss	The seconds of the minute with leading zero if required.	"00" to "59"
m	The minute of the hour between 0-59.	"0" or "59"
mm	The minute of the hour with leading zero if required.	"00" or "59"
h	The hour of the day between 1-12.	"1" to "12"
hh	The hour of the day with leading zero if required.	"01" to "12"
H	The hour of the day between 0-23.	"0" to "23"
HH	The hour of the day with leading zero if required.	"00" to "23"
d	The day of the month between 1 and 31.	"1" to "31"
dd	The day of the month with leading zero if required.	"01" to "31"
ddd	Abbreviated day name. Date.!CultureInfo.abbreviatedDayNames.	"چ" to "پ"
dddd	The full day name. Date.!CultureInfo.dayNames.	"چهارشنبه" to "پنج شنبه"
M	The month of the year between 1-12.	"1" to "12"
MM	The month of the year with leading zero if required.	"01" to "12"
MMM	Abbreviated month name. Date.!CultureInfo.abbreviatedMonthNames.	"شهر" to "مرد"
MMMM	The full month name. Date.!CultureInfo.monthNames.	"شهریور" to "مرداد"
yy	Displays the year as a two-digit number.	"97" or "98"
yyyy	Displays the full four digit year.	"1397" or "1398"
t	Displays the first character of the A.M./P.M.	"A" or "P"
tt	Displays the A.M./P.M. designator.	"AM" or "PM"

clearTime() method

var fD = new Date().fa(); 
console.log(fD.getHours()); // 2
console.log(fD.clearTime().getHours()); // 0

setTimeToNow() method

var fD = new Date().fa().setHours(3); 
console.log(fD.getHours()); // 3
console.log(fD.setTimeToNow().getHours()); // 2

today() method

var fD = new Date().fa().setHours(3); 
console.log(fD.getHours()); // 3
console.log(fD.today().getHours()); // 0

setFullYear() method

var fD = new Date().fa(); 
console.log(fD.setFullYear(1398).isLeap()); // false
console.log(fD.setFullYear(1399).isLeap()); // true

getDaysInMonth() method

var fD = new Date().fa(1397,1,1); 
console.log(fD.setMonth(0).getDaysInMonth()); // 31
console.log(fD.setMonth(11).getDaysInMonth()); // 29

startOfMonth() method

var fD = new Date().fa(1397,1,15); // month (0-11)
console.log(fD.startOfMonth().toISODate());  // 1397-02-01 - month (1-12)

addDays() method

   var fD = new Date().fa(1397,1,15).addDays(3).addDays(-1);
	console.log(fD.toString('dd'));  // 17

addWeeks() method

var fD = new Date().fa(1397,1,15).addDays(3).addWeeks(1);
console.log(fD.toString('dd'));  // 25  

addMonths() method

var fD = new Date().fa(1397,1,15)
console.log(fD.toString('MM'));  // 02
console.log(fD.addDays(3).addMonths(1).toString('MM'));  // 03

addYears() method

var fD = new Date().fa(1397,1,15)
console.log(fD.toString('yyyy MM'));  // 1397 02
console.log(fD.addDays(3).addMonths(1).addYears(1).toString('yyyy MM'));  // 1398 03  

startOfWeek() method

var fD = new Date().fa(1397,9,19)
console.log(fD.toString('yyyy MM dd'));  // 1397 10 19
console.log(fD.startOfWeek().toString('yyyy MM dd'));  // 1397 10 15  

clone() method

var fD = new Date().fa(1397,9,19)
console.log(fD.toString('yyyy MM dd'));  // 1397 10 19
console.log(fD.clone().startOfWeek().toString('yyyy MM dd'));  // 1397 10 15
console.log(fD.toString('yyyy MM dd'));  // 1397 10 19

getDaysOfMonth() method

var w1 ,w2 ,w3 ,w4 ,w5 ,w6;
[w1 ,w2 ,w3 ,w4 ,w5 ,w6] = new Date().fa().getDaysOfMonth();

getDaysOfWeek() method

  var Sat ,Sun ,Mon ,Tue ,Wed ,Thu ,Fri;
  [Sat ,Sun ,Mon ,Tue ,Wed ,Thu ,Fri] = new Date().fa().getDaysOfWeek(); 

toFarsiDigits() method

var fD = new Date().fa(1397,9,19)
console.log(fD.toString('ddd. d MMMM yyyy').toFarsiDigits()); //چ. ۱۹ دی ۱۳۹۷ 
console.log('1234'.toFarsiDigits()); // ۱۲۳۴

isDate() method

console.log(Date.isDate("2018-10-11")); // false 
console.log(Date.isDate(new Date())); // true 
console.log(Date.isDate(new Date("2018-10-11"))); // true

console.log(Date.fa.isDate(new Date().fa())); // true
console.log(Date.fa.isDate(new Date())); // false

toISODate() method

var date= new Date('11/13/2018');
console.log('ISO Date: '+ date.toISODate()); // ISO Date: 2018-11-13
console.log('fa ISO Date: '+ date.fa().toISODate()); // fa ISO Date: 1397-08-22

Other methods

All Date methods