puredate v1.0.0

puredate.js

Now is very easy manipulate date without time in javascript.

puredate.js serves to manipulate simple dates in javascript. This is very useful when you don't need worry about time and timezone. The PureDate object is ideal to manipulate birthdays and other dates that are recorded in documents.

Oficial webpage and examples: http://sergio.figueiredo.nom.br/puredate

Contributing

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -m 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request :D

CHANGELOG

Check Releases

Instalation

There are 2 ways for instalation:

For bower users:

  bower install puredate

Downloading the script:

Download 'puredate.js' file and enjoy.

Syntax

var puredate = PureDate.ymd(in int year, in int month, in int day);
   or
var puredate = PureDate.gdate(in int gDate);
   or
var puredate = PureDate.today();

Property list:

var today = PureDate.today();
document.write('Today is: '+today.year+'-'+today.month+'-'+today.day);
document.write('gDate : '+today.gdate);

/* note: gdate is a integer number of days since March, 1  /0000
  you can use gdate number to store puredate in a database or send to network.
*/

Method list:

var today = PureDate.today();
var tomorrow = today.addDays(1); // add 1 day 
var nextMonth = today.addMonths(1); // add 1 month. 
var dow = today.dayOfWeek() // return 0 for Sunday , 1 for Monday, ... 6 for Saturday
var isLeapYear = today.isLeapYear() // true if this date is in a leap year.
var firstDayOfMonth = today.getFirstDayOfMonth() // returns day 1 of same month and year 
var firstDayofYear= today.getFirstDayOfYear() // returns day 1 and month 1(january) of same year
var lastDayOfMonth = today.getLastDayOfMonth() // returns the last day of month.
var lastDayOfYear = today.getLastDayOfYear() // returns the 31 of december of today's year.
// note: today variable value remains immutable after all methods execution.

Constant list:

// months
PureDate.JANUARY:1,
PureDate.FEBRUARY:2,
PureDate.MARCH:3,
PureDate.APRIL:4,
PureDate.MAY:5,
PureDate.JUNE:6,
PureDate.JULY:7,
PureDate.AUGUST:8,
PureDate.SEPTEMBER:9,
PureDate.OCTOBER:10,
PureDate.NOVEMBER:11,
PureDate.DECEMBER:12,
// weekdays
PureDate.SUNDAY:0,
PureDate.MONDAY:1,
PureDate.TUESDAY:2,
PureDate.WEDNESDAY:3,
PureDate.THURSDAY:4,
PureDate.FRIDAY:5,
PureDate.SATURDAY:6

Examples

Today date

var today = PureDate.today();

Specific Date

var specDate = PureDate.ymd(2012,PureDate.JANUARY, 1);

Reading properties

var today = PureDate.today();
var year = today.year;
var month = today.month;
var day = today.day;

adding a month

var today = PureDate.today();
var nextMonth = today.addMonth(1);

Note: today instance is not modified. The PureDate object are immutable.

day of week

var today = PureDate.today();
if (today.dayOfWeek() === PureDate.SUNDAY){
   alert("good sunday");
}

Note: today instance is not modified. The PureDate object are immutable.

require.js

This javascript can be used with require.js. Their use is optional.

Description

This code uses gdate algorithm to convert day, month and year in a integer number thats is de day number since March, 1, year 0. You can read the gDate value and store it in a database. To restore this integer in a date is easy:

var gdate = 735935;   // Feb, 1, 2015
var date = PureDate(gdate);

Index of Months

• January is month 1;
• December is month 12;

Limitations

The simplicity of this code costs some limitations for their use.

This object only refers to a Gregorian Calendar, so this will work fine for any date since the adoption of Gregoria Calendar. Warning: each country has a diferent date of adotion of this calendar. The older countries adopt this calendar at Oct, 15, 1582 (Spain, Portugal, Italy, Polish).

That said, if you need to know precisaly how many days have passed of first arrival of the Portuguese fleet in Brazil (April, 22, 1500 year), you can not use this date, because the portugueses didn't use Gregorian Calendar at that time.