title: Difference between Java DateUtils.ceiling and DateUtils.truncate
body: <p>It's not clear in the java doc what the difference between <a href="http://commons.apache.org/lang/api-2.5/org/apache/commons/lang/time/DateUtils.html#ceiling%28java.util.Calendar,%20int%29">DateUtils.ceiling</a> and <a href="http://commons.apache.org/lang/api-2.5/org/apache/commons/lang/time/DateUtils.html#truncate%28java.util.Calendar,%20int%29">DateUtils.truncate</a> is. Is the java doc wrong? Can someone clarify this?</p>
  
  <blockquote>
    <p>ceiling</p>
    
    <p>public static Date ceiling(Date date,
                               int field)</p>
    
    <p>Ceil this date, leaving the field specified as the most significant field.</p>
    
    <p>For example, if you had the datetime of 28 Mar 2002 13:45:01.231, if you
    passed with HOUR, <strong>it would return 28 Mar 2002 13:00:00.000</strong>. If this was
    passed with MONTH, it would return 1 Mar 2002 0:00:00.000.</p>
  </blockquote>
  
  <p>vs</p>
  
  <blockquote>
    <p>truncate</p>
    
    <p>public static Date truncate(Date date,
                                int field)</p>
    
    <p>Truncate this date, leaving the field specified as the most 
    significant field.</p>
    
    <p>For example, if you had the datetime of 28 Mar 2002 13:45:01.231, 
    if you passed with HOUR, <strong>it would return 28 Mar 2002 13:00:00.000</strong>. 
    If this was passed with MONTH, it would return 1 Mar 2002 0:00:00.000.</p>
  </blockquote>