RubyGems - facets - Versions diffs - 2.5.2 → 2.6.0 - Mend

facets 2.5.2 → 2.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (677) hide show

data/doc/rdoc/core/classes/Time.html DELETED

@@ -1,521 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html>
-  <head>
-    <title>Class: Time</title>
-    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-    <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
-    <script language="JavaScript" type="text/javascript">
-    // <![CDATA[
-        function toggleSource( id )
-        {
-          var elem
-          var link
-          if( document.getElementById )
-          {
-            elem = document.getElementById( id )
-            link = document.getElementById( "l_" + id )
-          }
-          else if ( document.all )
-          {
-            elem = eval( "document.all." + id )
-            link = eval( "document.all.l_" + id )
-          }
-          else
-            return false;
-          if( elem.style.display == "block" )
-          {
-            elem.style.display = "none"
-            link.innerHTML = "+"
-          }
-          else
-          {
-            elem.style.display = "block"
-            link.innerHTML = "-"
-          }
-        }
-        function openCode( url )
-        {
-          window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
-        }
-      // ]]>
-    </script>
-  </head>
-  <body>
-  <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
-  <td class="file-title"><span class="file-title-prefix">Class</span><br />Time</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../files/lib/core/facets/time/elapse_rb.html">lib/core/facets/time/elapse.rb</a>
-<a href="../files/lib/core/facets/time/trunc_rb.html">lib/core/facets/time/trunc.rb</a>
-<a href="../files/lib/core/facets/time/advance_rb.html">lib/core/facets/time/advance.rb</a>
-<a href="../files/lib/core/facets/time/round_rb.html">lib/core/facets/time/round.rb</a>
-<a href="../files/lib/core/facets/time/hence_rb.html">lib/core/facets/time/hence.rb</a>
-<a href="../files/lib/core/facets/time/set_rb.html">lib/core/facets/time/set.rb</a>
-<a href="../files/lib/core/facets/time/to_time_rb.html">lib/core/facets/time/to_time.rb</a>
-<a href="../files/lib/core/facets/time/change_rb.html">lib/core/facets/time/change.rb</a>
-<a href="../files/lib/core/facets/time/stamp_rb.html">lib/core/facets/time/stamp.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-        <a href="Object.html">
-Object
-         </a>
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000039">advance</a></span>
-  <span style="padding-right: 5px;"><a href="#M000041">ago</a></span>
-  <span style="padding-right: 5px;"><a href="#M000046">change</a></span>
-  <span style="padding-right: 5px;"><a href="#M000043">dst_adjustment</a></span>
-  <span style="padding-right: 5px;"><a href="#M000037">elapse</a></span>
-  <span style="padding-right: 5px;"><a href="#M000042">hence</a></span>
-  <span style="padding-right: 5px;"><a href="#M000040">round</a></span>
-  <span style="padding-right: 5px;"><a href="#M000044">set</a></span>
-  <span style="padding-right: 5px;"><a href="#M000047">stamp</a></span>
-  <span style="padding-right: 5px;"><a href="#M000048">stamp</a></span>
-  <span style="padding-right: 5px;"><a href="#M000045">to_time</a></span>
-  <span style="padding-right: 5px;"><a href="#M000038">trunc</a></span>
-  <div class="sectiontitle">Constants</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class="attr-name">FORMAT</td>
-    <td>=</td>
-    <td class="attr-value">{       :db      =&gt; &quot;%Y-%m-%d %H:%M:%S&quot;,       :dbase   =&gt; &quot;%Y-%m-%d %H:%M:%S&quot;,       :datbase =&gt; &quot;%Y-%m-%d %H:%M:%S&quot;,       :utc     =&gt; &quot;%Y-%m-%d %H:%M:%S&quot;,       :number  =&gt; &quot;%Y%m%d%H%M%S&quot;,       :short   =&gt; &quot;%d %b %H:%M&quot;,       :time    =&gt; &quot;%H:%M&quot;,       :long    =&gt; &quot;%B %d, %Y %H:%M&quot;,       :day1st  =&gt; &quot;%d-%m-%Y %H:%M&quot;,       :dmYHM   =&gt; &quot;%d-%m-%Y %H:%M&quot;,       :rfc822  =&gt; &quot;%a, %d %b %Y %H:%M:%S %z&quot;,       nil      =&gt; &quot;%a %b %d %H:%M:%S %Z %Y&quot;</td>
-  </tr>
-  </table>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000037"></a><b>elapse</b>() {|| ...}
-  </div>
-  <div class="description">
-  <p>
-Tracks the <a href="Time.html#M000037">elapse</a> time of a code block.
-</p>
-<pre>
-  Time.elapse { sleep 1 }  #=&gt; 0.999188899993896
-</pre>
-<p>
-CREDIT: Hal Fulton
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000037_source')" id="l_M000037_source">+</a> ]</p>
-  <div id="M000037_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/elapse.rb, line 9</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">elapse</span>
-    <span class="ruby-identifier">raise</span> <span class="ruby-value str">&quot;Need block&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block_given?</span>
-    <span class="ruby-identifier">t0</span> = <span class="ruby-identifier">now</span>.<span class="ruby-identifier">to_f</span>
-    <span class="ruby-keyword kw">yield</span>
-    <span class="ruby-identifier">now</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">t0</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000047"></a><b>stamp</b>(*args)
-  </div>
-  <div class="description">
-  <p>
-Produce time <a href="Time.html#M000047">stamp</a> for Time.now. See <a
-href="Time.html#M000047">stamp</a>.
-</p>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000047_source')" id="l_M000047_source">+</a> ]</p>
-  <div id="M000047_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/stamp.rb, line 24</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">stamp</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-    <span class="ruby-identifier">now</span>.<span class="ruby-identifier">stamp</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="sectiontitle">Public Instance methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000039"></a><b>advance</b>(options)
-  </div>
-  <div class="description">
-  <p>
-Uses Date to provide precise <a href="Time.html">Time</a> calculations for
-years, months, and days. The <tt>options</tt> parameter takes a hash with
-any of these keys: <tt>:years</tt>, <tt>:months</tt>, <tt>:weeks</tt>,
-<tt>:days</tt>, <tt>:hours</tt>, <tt>:minutes</tt>, <tt>:seconds</tt>.
-</p>
-<p>
-CREDIT: ActiveSupport Team
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000039_source')" id="l_M000039_source">+</a> ]</p>
-  <div id="M000039_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/advance.rb, line 10</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">advance</span>(<span class="ruby-identifier">options</span>)
-    <span class="ruby-identifier">d</span> = <span class="ruby-identifier">to_date</span>.<span class="ruby-identifier">advance</span>(<span class="ruby-identifier">options</span>)
-    <span class="ruby-identifier">time_advanced_by_date</span> = <span class="ruby-identifier">change</span>(<span class="ruby-identifier">:year</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">d</span>.<span class="ruby-identifier">year</span>, <span class="ruby-identifier">:month</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">d</span>.<span class="ruby-identifier">month</span>, <span class="ruby-identifier">:day</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">d</span>.<span class="ruby-identifier">day</span>)
-    <span class="ruby-identifier">seconds_to_advance</span> = (<span class="ruby-identifier">options</span>[<span class="ruby-identifier">:seconds</span>] <span class="ruby-operator">||</span> <span class="ruby-value">0</span>) <span class="ruby-operator">+</span> (<span class="ruby-identifier">options</span>[<span class="ruby-identifier">:minutes</span>] <span class="ruby-operator">||</span> <span class="ruby-value">0</span>) <span class="ruby-operator">*</span> <span class="ruby-value">60</span> <span class="ruby-operator">+</span> (<span class="ruby-identifier">options</span>[<span class="ruby-identifier">:hours</span>] <span class="ruby-operator">||</span> <span class="ruby-value">0</span>) <span class="ruby-operator">*</span> <span class="ruby-value">3600</span>
-    <span class="ruby-identifier">seconds_to_advance</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">time_advanced_by_date</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">time_advanced_by_date</span>.<span class="ruby-identifier">since</span>(<span class="ruby-identifier">seconds_to_advance</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000041"></a><b>ago</b>(number, units=:seconds)
-  </div>
-  <div class="description">
-  <p>
-Returns a new <a href="Time.html">Time</a> representing the time a number
-of time-units <a href="Time.html#M000041">ago</a>.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000041_source')" id="l_M000041_source">+</a> ]</p>
-  <div id="M000041_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/hence.rb, line 15</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ago</span>(<span class="ruby-identifier">number</span>, <span class="ruby-identifier">units</span>=<span class="ruby-identifier">:seconds</span>)
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">hence</span>(<span class="ruby-operator">-</span><span class="ruby-identifier">number</span>, <span class="ruby-identifier">units</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">number</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
-      <span class="ruby-identifier">time</span> = (
-        <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">units</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">downcase</span>.<span class="ruby-identifier">to_sym</span>
-        <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:years</span>
-          <span class="ruby-identifier">set</span>(<span class="ruby-identifier">:year</span> =<span class="ruby-operator">&gt;</span> (<span class="ruby-identifier">year</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">number</span>))
-        <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:months</span>
-          <span class="ruby-identifier">new_month</span> = ((<span class="ruby-identifier">month</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">number</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>) <span class="ruby-operator">%</span> <span class="ruby-value">12</span>) <span class="ruby-operator">+</span> <span class="ruby-value">1</span>
-          <span class="ruby-identifier">y</span> = (<span class="ruby-identifier">number</span> <span class="ruby-operator">/</span> <span class="ruby-value">12</span>) <span class="ruby-operator">+</span> (<span class="ruby-identifier">new_month</span> <span class="ruby-operator">&gt;</span> <span class="ruby-identifier">month</span> <span class="ruby-value">? </span><span class="ruby-value">1</span> <span class="ruby-operator">:</span> <span class="ruby-value">0</span>)
-          <span class="ruby-identifier">set</span>(<span class="ruby-identifier">:year</span> =<span class="ruby-operator">&gt;</span> (<span class="ruby-identifier">year</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">y</span>), <span class="ruby-identifier">:month</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">new_month</span>)
-        <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:weeks</span>
-          <span class="ruby-keyword kw">self</span> <span class="ruby-operator">-</span> (<span class="ruby-identifier">number</span> <span class="ruby-operator">*</span> <span class="ruby-value">604800</span>)
-        <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:days</span>
-          <span class="ruby-keyword kw">self</span> <span class="ruby-operator">-</span> (<span class="ruby-identifier">number</span> <span class="ruby-operator">*</span> <span class="ruby-value">86400</span>)
-        <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:hours</span>
-          <span class="ruby-keyword kw">self</span> <span class="ruby-operator">-</span> (<span class="ruby-identifier">number</span> <span class="ruby-operator">*</span> <span class="ruby-value">3600</span>)
-        <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:minutes</span>
-          <span class="ruby-keyword kw">self</span> <span class="ruby-operator">-</span> (<span class="ruby-identifier">number</span> <span class="ruby-operator">*</span> <span class="ruby-value">60</span>)
-        <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:seconds</span>, <span class="ruby-keyword kw">nil</span>
-          <span class="ruby-keyword kw">self</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">number</span>
-        <span class="ruby-keyword kw">else</span>
-          <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;unrecognized time units -- #{units}&quot;</span>
-        <span class="ruby-keyword kw">end</span>
-      )
-      <span class="ruby-identifier">dst_adjustment</span>(<span class="ruby-identifier">time</span>)
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000046"></a><b>change</b>(options)
-  </div>
-  <div class="description">
-  <p>
-Returns a new <a href="Time.html">Time</a> where one or more of the
-elements have been changed according to the <tt>options</tt> parameter. The
-time options (hour, minute, sec, usec) reset cascadingly, so if only the
-hour is passed, then minute, sec, and usec is <a
-href="Time.html#M000044">set</a> to 0. If the hour and minute is passed,
-then sec and usec is <a href="Time.html#M000044">set</a> to 0.
-</p>
-<pre>
- t = Time.now            #=&gt; Sat Dec 01 14:10:15 -0500 2007
- t.change(:hour =&gt; 11)   #=&gt; Sat Dec 01 11:00:00 -0500 2007
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000046_source')" id="l_M000046_source">+</a> ]</p>
-  <div id="M000046_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/change.rb, line 13</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">change</span>(<span class="ruby-identifier">options</span>)
-    <span class="ruby-identifier">opts</span>=<span class="ruby-identifier">options</span>; <span class="ruby-comment cmt">#{}; options.each_pair{ |k,v| opts[k] = v.to_i }</span>
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">send</span>(
-      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">utc?</span> <span class="ruby-value">? </span><span class="ruby-operator">:</span><span class="ruby-identifier">utc</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">:local</span>,
-      <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:year</span>]  <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">year</span>,
-      <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:month</span>] <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span>,
-      <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:day</span>]   <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">day</span>,
-      <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:hour</span>]  <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">hour</span>,
-      <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:min</span>]   <span class="ruby-operator">||</span> (<span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:hour</span>] <span class="ruby-operator">?</span> <span class="ruby-value">0</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">min</span>),
-      <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:sec</span>]   <span class="ruby-operator">||</span> ((<span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:hour</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:min</span>]) <span class="ruby-operator">?</span> <span class="ruby-value">0</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">sec</span>),
-      <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:usec</span>]  <span class="ruby-operator">||</span> ((<span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:hour</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:min</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:sec</span>]) <span class="ruby-operator">?</span> <span class="ruby-value">0</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">usec</span>)
-    )
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000043"></a><b>dst_adjustment</b>(time)
-  </div>
-  <div class="description">
-  <p>
-Adjust DST
-</p>
-<p>
-TODO: Can&#8216;t seem to get this to pass ActiveSupport tests. Even though
-it is essentially identical to the ActiveSupport code (see Time#since in
-time/calculations.rb). It handles all but 4 tests.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000043_source')" id="l_M000043_source">+</a> ]</p>
-  <div id="M000043_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/hence.rb, line 83</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">dst_adjustment</span>(<span class="ruby-identifier">time</span>)
-      <span class="ruby-identifier">self_dst</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dst?</span> <span class="ruby-value">? </span><span class="ruby-value">1</span> <span class="ruby-operator">:</span> <span class="ruby-value">0</span>
-      <span class="ruby-identifier">time_dst</span> = <span class="ruby-identifier">time</span>.<span class="ruby-identifier">dst?</span> <span class="ruby-value">? </span><span class="ruby-value">1</span> <span class="ruby-operator">:</span> <span class="ruby-value">0</span>
-      <span class="ruby-identifier">seconds</span>  = (<span class="ruby-keyword kw">self</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">time</span>).<span class="ruby-identifier">abs</span>
-      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">seconds</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-value">86400</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">self_dst</span> <span class="ruby-operator">!=</span> <span class="ruby-identifier">time_dst</span>)
-        <span class="ruby-identifier">time</span> <span class="ruby-operator">+</span> ((<span class="ruby-identifier">self_dst</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">time_dst</span>) <span class="ruby-operator">*</span> <span class="ruby-value">60</span> <span class="ruby-operator">*</span> <span class="ruby-value">60</span>)
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">time</span>
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000042"></a><b>hence</b>(number, units=:seconds)
-  </div>
-  <div class="description">
-  <p>
-Returns a new <a href="Time.html">Time</a> representing the time a number
-of time-units <a href="Time.html#M000042">hence</a>.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000042_source')" id="l_M000042_source">+</a> ]</p>
-  <div id="M000042_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/hence.rb, line 46</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">hence</span>(<span class="ruby-identifier">number</span>, <span class="ruby-identifier">units</span>=<span class="ruby-identifier">:seconds</span>)
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">ago</span>(<span class="ruby-operator">-</span><span class="ruby-identifier">number</span>, <span class="ruby-identifier">units</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">number</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
-      <span class="ruby-identifier">time</span> = (
-        <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">units</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">downcase</span>.<span class="ruby-identifier">to_sym</span>
-        <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:years</span>
-          <span class="ruby-identifier">set</span>( <span class="ruby-identifier">:year=</span><span class="ruby-operator">&gt;</span>(<span class="ruby-identifier">year</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">number</span>) )
-        <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:months</span>
-          <span class="ruby-identifier">new_month</span> = ((<span class="ruby-identifier">month</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">number</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>) <span class="ruby-operator">%</span> <span class="ruby-value">12</span>) <span class="ruby-operator">+</span> <span class="ruby-value">1</span>
-          <span class="ruby-identifier">y</span> = (<span class="ruby-identifier">number</span> <span class="ruby-operator">/</span> <span class="ruby-value">12</span>) <span class="ruby-operator">+</span> (<span class="ruby-identifier">new_month</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">month</span> <span class="ruby-value">? </span><span class="ruby-value">1</span> <span class="ruby-operator">:</span> <span class="ruby-value">0</span>)
-          <span class="ruby-identifier">set</span>(<span class="ruby-identifier">:year</span> =<span class="ruby-operator">&gt;</span> (<span class="ruby-identifier">year</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">y</span>), <span class="ruby-identifier">:month</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">new_month</span>)
-        <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:weeks</span>
-          <span class="ruby-keyword kw">self</span> <span class="ruby-operator">+</span> (<span class="ruby-identifier">number</span> <span class="ruby-operator">*</span> <span class="ruby-value">604800</span>)
-        <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:days</span>
-          <span class="ruby-keyword kw">self</span> <span class="ruby-operator">+</span> (<span class="ruby-identifier">number</span> <span class="ruby-operator">*</span> <span class="ruby-value">86400</span>)
-        <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:hours</span>
-          <span class="ruby-keyword kw">self</span> <span class="ruby-operator">+</span> (<span class="ruby-identifier">number</span> <span class="ruby-operator">*</span> <span class="ruby-value">3600</span>)
-        <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:minutes</span>
-          <span class="ruby-keyword kw">self</span> <span class="ruby-operator">+</span> (<span class="ruby-identifier">number</span> <span class="ruby-operator">*</span> <span class="ruby-value">60</span>)
-        <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:seconds</span>
-          <span class="ruby-keyword kw">self</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">number</span>
-        <span class="ruby-keyword kw">else</span>
-          <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;unrecognized time units -- #{units}&quot;</span>
-        <span class="ruby-keyword kw">end</span>
-      )
-      <span class="ruby-identifier">dst_adjustment</span>(<span class="ruby-identifier">time</span>)
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000040"></a><b>round</b>(amount)
-  </div>
-  <div class="description">
-  <p>
-Round time at the nearest range (in seconds).
-</p>
-<pre>
-  t = Time.now
-  =&gt;
-  t.round(60*60) # 1 hour
-  =&gt;
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000040_source')" id="l_M000040_source">+</a> ]</p>
-  <div id="M000040_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/round.rb, line 12</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">round</span>(<span class="ruby-identifier">amount</span>)
-    (<span class="ruby-keyword kw">self</span><span class="ruby-operator">+</span><span class="ruby-identifier">amount</span><span class="ruby-operator">/</span><span class="ruby-value">2.0</span>).<span class="ruby-identifier">trunc</span>(<span class="ruby-identifier">amount</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000044"></a><b>set</b>(options)
-  </div>
-  <div class="description">
-  <p>
-Like <a href="Time.html#M000046">change</a> but does not reset earlier
-times.
-</p>
-<p>
-NOTE: It would be better, probably if this were called &quot;<a
-href="Time.html#M000046">change</a>&quot;.
-</p>
-<pre>
-      and that #change were called &quot;reset&quot;.
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000044_source')" id="l_M000044_source">+</a> ]</p>
-  <div id="M000044_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/set.rb, line 8</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set</span>(<span class="ruby-identifier">options</span>)
-    <span class="ruby-identifier">opts</span>={}; <span class="ruby-identifier">options</span>.<span class="ruby-identifier">each_pair</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">k</span>] = <span class="ruby-identifier">v</span>.<span class="ruby-identifier">to_i</span> }
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">send</span>( <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">utc?</span> <span class="ruby-value">? </span><span class="ruby-operator">:</span><span class="ruby-identifier">utc</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">:local</span>,
-      <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:year</span>]  <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">year</span>,
-      <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:month</span>] <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span>,
-      <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:day</span>]   <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">day</span>,
-      <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:hour</span>]  <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">hour</span>,
-      <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:min</span>]   <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">min</span>,
-      <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:sec</span>]   <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">sec</span>,
-      <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:usec</span>]  <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">usec</span>
-    )
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000048"></a><b>stamp</b>(fmt = nil)
-  </div>
-  <div class="description">
-  <p>
-Create a time <a href="Time.html#M000047">stamp</a>.
-</p>
-<pre>
-  Time.now.stamp(:short)    #=&gt; &quot;01 Dec 15:15&quot;
-</pre>
-<p>
-Supported formats come from the Time::FORMAT constant.
-</p>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000048_source')" id="l_M000048_source">+</a> ]</p>
-  <div id="M000048_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/stamp.rb, line 36</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stamp</span>(<span class="ruby-identifier">fmt</span> = <span class="ruby-keyword kw">nil</span>)
-    <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">String</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">fmt</span>
-      <span class="ruby-identifier">fmt</span> = <span class="ruby-constant">FORMAT</span>[<span class="ruby-identifier">fmt</span>]
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">strftime</span>(<span class="ruby-identifier">fmt</span>).<span class="ruby-identifier">strip</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000045"></a><b>to_time</b>()
-  </div>
-  <div class="description">
-  <p>
-To be able to keep Dates and Times interchangeable on conversions.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000045_source')" id="l_M000045_source">+</a> ]</p>
-  <div id="M000045_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/to_time.rb, line 8</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_time</span>
-      <span class="ruby-identifier">getlocal</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000038"></a><b>trunc</b>(amount)
-  </div>
-  <div class="description">
-  <p>
-Truncate time at give range (in seconds).
-</p>
-<pre>
-  t = Time.now
-  =&gt;
-  t.trunc(60*60) # 1 hour
-  =&gt;
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000038_source')" id="l_M000038_source">+</a> ]</p>
-  <div id="M000038_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/trunc.rb, line 10</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">trunc</span>(<span class="ruby-identifier">amount</span>)
-    <span class="ruby-keyword kw">self</span> <span class="ruby-operator">-</span> (<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">to_i</span> <span class="ruby-operator">%</span> <span class="ruby-identifier">amount</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>