1/12/2012

Better PHP Calendar Class

I've dealt with creating monthly calendars in PHP and it has always been a bit of pain. How exactly to show the days in the month in a table without creating ugly and hard to maintain code? I believe this time I was able to find a good solution.

A PHP Class

It's a PHP class that will output the dates of the given month in array. But in order to make the dates fit their place in the week, the class outputs zeros in the place of "empty" days. So the first week of a month starting in Wednesday would be this array:

[0, 0, 1, 2, 3, 4, 5]

This allows you to loop through the returned arrays without worrying where to start the week. If you use a table, you could simply output " " when the date is 0 and output the number (and colored background) when the date is a number. Here is an example in HTML:

Using the output in HTML:


<table>
    <tr><th>Mon</th><th>Tue</th><th>Wed</th><th>Thu</th><th>Fri</th><th>Sat</th><th>Sun</th></tr>
    <?php for($i=1;$i<=$num_weeks;$i++):?>
        <tr>
            <?php $days=$_calendar->days($m[0], $m[1], $i, $num_weeks);
            foreach($days as $day):?>
                <td><?=$day?$day:"&nbsp;"?></td>
            <?php endforeach;?>
        </tr>
    <?php endfor;?>
    </table>


Easy, eh? We just output a table row for every week in the month ($num_weeks is also a method in the class as you'll see below) and for the days with date we output the date (otherwise just blank space).

You can see how it works live in this period calendar.

The PHP Code

Now, here is how it all works. I created a class to hold 3 functions:

num_weeks($month, $year) - to calculate the number of weeks in the given month and year

first_day($month, $year) - to find out which day of the week is the first day of a given month.year

days($month, $year, $week, $num_weeks=0) - this is the main method that returns the array of 7 days. The week starts in Monday.

Here is the full code below and some comments to it:

function num_weeks($month, $year)
    {
        // every month has at least 4 weeks
        $num_weeks=4;
    
        // finding where it starts
        $first_day = $this->first_day($month, $year);  
        
        // if the first week doesn't start on monday 
        // we are sure that the month has at minimum 5 weeks
        if($first_day!=1) $num_weeks++;
        
        // find the "widow" days (i.e. empty cells in the 1st week)
        $widows=$first_day-1;  
        $fw_days=7-$widows;
        if($fw_days==7) $fw_days=0;       
        
        // number of days in the month
        $numdays=date("t",mktime(2, 0, 0, $month, 1, $year));
        
        if( ($numdays - $fw_days) > 28 ) $num_weeks++;
         // that's it!
        return $num_weeks;                  
    }


Then the first_day function:

function first_day($month, $year)
    {
        $first_day= date("w", mktime(2, 0, 0, $month, 1, $year));
        if($first_day==0) $first_day=7; # convert Sunday
        
        return $first_day;
    }


And here is the most important one:
// here $week is the week number when we go in a loop
// (see the html code that I posted earlier to get better idea)
function days($month, $year, $week, $num_weeks=0)
{
        $days=array();

        // this is just to avoid calling num_weeks every time 
        // when you loop through the weeks        
        if($num_weeks==0) $num_weeks=$this->num_weeks($month, $year);
        
        // find which day of the week is 1st of the given month        
        $first_day = $this->first_day($month, $year);
                
        // find widow days (first week)
        $widows=$first_day-1;
        
        // first week days
        $fw_days=7-$widows;
        
        // if $week==1 don't do further calculations
        if($week==1)
        {
            for($i=0;$i<$widows;$i++) $days[]=0;            
            for($i=1;$i<=$fw_days;$i++) $days[]=$i;            
            return $days;
        }
        
        // any other week
        if($week!=$num_weeks)
        {
            $first=$fw_days+(($week-2)*7);
            for($i=$first+1;$i<=$first+7;$i++) $days[]=$i;            
            return $days;
        }
        
        
        # only last week calculations below
        
        // number of days in the month
        $numdays=date("t",mktime(2, 0, 0, $month, 1, $year));
                
        // find orphan days (last week)  
        $orphans=$numdays-$fw_days-(($num_weeks-2)*7);                     
        $empty=7-$orphans;
        for($i=($numdays-$orphans)+1;$i<=$numdays;$i++) $days[]=$i;
        for($i=0;$i<$empty;$i++) $days[]=0;
        return $days;
    }


That's it! Any questions?

31 comments:

  1. PHP is a very fast programming language for business. Thanks for sharing this information which is useful for all.

    php web development

    ReplyDelete
  2. PHP is the best server side scripting language! I was is search of this php calender code ,thanks for sharing. I hope to see some more interesting php codes in this blog in near future.

    Ecommerce Design

    ReplyDelete
  3. I was looking for the same calendar info for a long time thanks for sharing.

    ReplyDelete
  4. It is great for beginner PHP learners.Thanks for all these information i hope to see more interesting and knowledgeable blog in near future.

    ReplyDelete
  5. Find a php calendar here: http://bohemiawebsites.com/component/option,com_jdownloads/Itemid,382/cid,68/task,view.download/

    You can find more than 300 pages worth of php tutorials at http://bohemiawebsites.com/Our-Blog.html

    ReplyDelete
  6. PHP contain the many class.but calender class provide the long time information.it also show the day and hours.actually its is great.

    ReplyDelete
  7. Great Post for PHP learners..This is wonderful post. I do hope you intend to post more of these types of information. Thank you for this interesting information...
    Web Designing Company in Chandigarh

    ReplyDelete
    Replies
    1. EMC SAN Online Training is a best course all top company requires this,W3 D technology provides EMC SAN Online Training course with Certification and E-books , Videos
      EMC SAN Online Training | Storage Area Network Course

      Delete
  8. I don't know how to use it to print calendar in HTML

    ReplyDelete
  9. After make index.php file with HTML code from above, and then file calndar.class.php and put to the index.php code only calendar header with days show up... where are days?

    ReplyDelete
  10. Excellent post, for php developers, this class will allow you to add calendars in a variety of display types with only a few lines of code. Read more…

    Check this site Mindmajix for indepth PHP Tutorials

    Go here if you’re looking for information on PHP Blogs

    ReplyDelete
  11. Nice blog...Very useful information is providing by ur blog. Great beginning php tutorials Very clear and helpful for beginners.

    ReplyDelete
  12. Thank you for the informative post. Must appreciated.
    Shashaa
    HTML5 Course in Velachery

    ReplyDelete
  13. Thanks for sharing this wonderful information.Its very nice blog PHP

    ReplyDelete
  14. Thanks for sharing great information in your blog. Got to learn new things from your Blog . It was very nice blog to learn about php

    ReplyDelete
  15. thanks for giving this type of informative blog,we learn more things about tips for seo which is involves the detailed information about optimization of blogger.
    SAP Training in Chennai

    ReplyDelete
  16. EMC SAN Online Training is a best course all top company requires this,W3 D technology provides EMC SAN Online Training course with Certification and E-books , Videos
    EMC SAN Online Training | Storage Area Network Course

    ReplyDelete
  17. Nice blog on php development. The information you are providing through this blog is very helpful to beginner Php Developers .

    Thanks

    ReplyDelete
  18. My friend Suggest me this blog and I can say this is the best blog to get the basic knowledge.Thank you so much for this Selenium Training in Chennai

    ReplyDelete
  19. Have you been thinking about the power sources and the tiles whom use blocks I wanted to thank you for this great read!! I definitely enjoyed every little bit of it and I have you bookmarked to check out the new stuff you post. java training jalandhar

    ReplyDelete
  20. This is my first visit to your blog, your post made productive reading, thank you. dot net training in chennai

    ReplyDelete

  21. This is best PHP tutorial in youtube. you can learn full coding and also the best expamles in here. This the best of learning and earning ways of youtube.
    You can the full boston php tutorial.

    click here PHP tutorial
    for more youtube tutorials
    website php tutorial for beginners

    ReplyDelete
  22. Well explained. Got to learn new things from your Blog on Appium.Appium training in chennai

    ReplyDelete