facets 2.4.3 → 2.4.4

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

@@ -59,20 +59,13 @@
         <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>
-<a href="../files/lib/core/facets/time/to_date_rb.html">lib/core/facets/time/to_date.rb</a>
-<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/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/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>
-<a href="../files/lib/core/facets/time/to_date_rb.html">lib/core/facets/time/to_date.rb</a>
         </td>
       </tr>
     <tr>
@@ -97,28 +90,18 @@ Object
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000082">ago</a></li>
-  <li><a href="#M000071">ago</a></li>
-  <li><a href="#M000086">change</a></li>
-  <li><a href="#M000075">change</a></li>
-  <li><a href="#M000068">elapse</a></li>
-  <li><a href="#M000079">elapse</a></li>
-  <li><a href="#M000072">hence</a></li>
-  <li><a href="#M000083">hence</a></li>
-  <li><a href="#M000073">in</a></li>
-  <li><a href="#M000084">in</a></li>
-  <li><a href="#M000070">round</a></li>
-  <li><a href="#M000081">round</a></li>
-  <li><a href="#M000087">set</a></li>
-  <li><a href="#M000076">set</a></li>
-  <li><a href="#M000088">stamp</a></li>
-  <li><a href="#M000077">stamp</a></li>
-  <li><a href="#M000078">stamp</a></li>
-  <li><a href="#M000089">stamp</a></li>
-  <li><a href="#M000074">to_time</a></li>
-  <li><a href="#M000085">to_time</a></li>
-  <li><a href="#M000080">trunc</a></li>
-  <li><a href="#M000069">trunc</a></li>
+  <li><a href="#M000040">advance</a></li>
+  <li><a href="#M000042">ago</a></li>
+  <li><a href="#M000047">change</a></li>
+  <li><a href="#M000044">dst_adjustment</a></li>
+  <li><a href="#M000038">elapse</a></li>
+  <li><a href="#M000043">hence</a></li>
+  <li><a href="#M000041">round</a></li>
+  <li><a href="#M000045">set</a></li>
+  <li><a href="#M000048">stamp</a></li>
+  <li><a href="#M000049">stamp</a></li>
+  <li><a href="#M000046">to_time</a></li>
+  <li><a href="#M000039">trunc</a></li>
   </ul>
 
 
@@ -129,12 +112,7 @@ Object
   <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;,       :short   =&gt; &quot;%d %b %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>
-  <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;,       :short   =&gt; &quot;%d %b %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>
+    <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>
 
@@ -142,40 +120,11 @@ Object
 <div class="sectiontitle">Public Class methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000068"></a><b>elapse</b>() {|| ...}
-  </div>
-  <div class="description">
-  <p>
-Tracks the <a href="Time.html#M000068">elapse</a> time of a code block.
-</p>
-<pre>
-  Time.elapse { sleep 1 }  #=&gt; 0.999188899993896
-
-  CREDIT: Hal Fulton
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000068_source')" id="l_M000068_source">show source</a> ]</p>
-  <div id="M000068_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-constant">Time</span>.<span class="ruby-identifier">now</span>.<span class="ruby-identifier">to_f</span>
-    <span class="ruby-keyword kw">yield</span>
-    <span class="ruby-constant">Time</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="M000079"></a><b>elapse</b>() {|| ...}
+    <a name="M000038"></a><b>elapse</b>() {|| ...}
   </div>
   <div class="description">
   <p>
-Tracks the <a href="Time.html#M000068">elapse</a> time of a code block.
+Tracks the <a href="Time.html#M000038">elapse</a> time of a code block.
 </p>
 <pre>
   Time.elapse { sleep 1 }  #=&gt; 0.999188899993896
@@ -184,15 +133,15 @@ Tracks the <a href="Time.html#M000068">elapse</a> time of a code block.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000079_source')" id="l_M000079_source">show source</a> ]</p>
-  <div id="M000079_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000038_source')" id="l_M000038_source">show source</a> ]</p>
+  <div id="M000038_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-constant">Time</span>.<span class="ruby-identifier">now</span>.<span class="ruby-identifier">to_f</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-constant">Time</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-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>
@@ -200,22 +149,22 @@ Tracks the <a href="Time.html#M000068">elapse</a> time of a code block.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000088"></a><b>stamp</b>(*args)
+    <a name="M000048"></a><b>stamp</b>(*args)
   </div>
   <div class="description">
   <p>
-Produce time <a href="Time.html#M000077">stamp</a> for Time.now. See <a
-href="Time.html#M000077">stamp</a>.
+Produce time <a href="Time.html#M000048">stamp</a> for Time.now. See <a
+href="Time.html#M000048">stamp</a>.
 </p>
 <pre>
   CREDIT: Trans
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000088_source')" id="l_M000088_source">show source</a> ]</p>
-  <div id="M000088_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000048_source')" id="l_M000048_source">show source</a> ]</p>
+  <div id="M000048_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/stamp.rb, line 22</span>
+<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>
@@ -223,69 +172,32 @@ href="Time.html#M000077">stamp</a>.
   </div>
 </div>
 </div>
+<div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000077"></a><b>stamp</b>(*args)
+    <a name="M000040"></a><b>advance</b>(options)
   </div>
   <div class="description">
   <p>
-Produce time <a href="Time.html#M000077">stamp</a> for Time.now. See <a
-href="Time.html#M000077">stamp</a>.
+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>
 <pre>
-  CREDIT: Trans
+  CREDIT: ActiveSupport
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000077_source')" id="l_M000077_source">show source</a> ]</p>
-  <div id="M000077_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/stamp.rb, line 22</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="M000082"></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#M000071">ago</a>.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000082_source')" id="l_M000082_source">show source</a> ]</p>
-  <div id="M000082_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/hence.rb, line 8</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">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">years</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">12</span>).<span class="ruby-identifier">to_i</span>
-      <span class="ruby-identifier">y</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">12</span>).<span class="ruby-identifier">to_i</span>
-      <span class="ruby-identifier">m</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">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">m</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>
+  <p class="source-link">[ <a href="javascript:toggleSource('M000040_source')" id="l_M000040_source">show source</a> ]</p>
+  <div id="M000040_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/core/facets/time/advance.rb, line 9</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>
@@ -293,49 +205,52 @@ of time-units <a href="Time.html#M000071">ago</a>.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000071"></a><b>ago</b>(number, units=:seconds)
+    <a name="M000042"></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#M000071">ago</a>.
+of time-units <a href="Time.html#M000042">ago</a>.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000071_source')" id="l_M000071_source">show source</a> ]</p>
-  <div id="M000071_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/hence.rb, line 8</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">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">years</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">12</span>).<span class="ruby-identifier">to_i</span>
-      <span class="ruby-identifier">y</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">12</span>).<span class="ruby-identifier">to_i</span>
-      <span class="ruby-identifier">m</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">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">m</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>
+  <p class="source-link">[ <a href="javascript:toggleSource('M000042_source')" id="l_M000042_source">show source</a> ]</p>
+  <div id="M000042_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-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-comment cmt">#years = ((month - number) / 12).to_i</span>
+          <span class="ruby-identifier">y</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">12</span>).<span class="ruby-identifier">to_i</span>
+          <span class="ruby-identifier">m</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">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">m</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>
-  <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000086"></a><b>change</b>(options)
+    <a name="M000047"></a><b>change</b>(options)
   </div>
   <div class="description">
   <p>
@@ -343,31 +258,30 @@ 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#M000076">set</a> to 0. If the hour and minute is passed,
-then sec and usec is <a href="Time.html#M000076">set</a> to 0.
+href="Time.html#M000045">set</a> to 0. If the hour and minute is passed,
+then sec and usec is <a href="Time.html#M000045">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
-
- CREDIT: David Hansson (?)
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000086_source')" id="l_M000086_source">show source</a> ]</p>
-  <div id="M000086_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000047_source')" id="l_M000047_source">show source</a> ]</p>
+  <div id="M000047_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/change.rb, line 15</span>
+<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-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">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">:usec</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-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>
@@ -376,188 +290,91 @@ then sec and usec is <a href="Time.html#M000076">set</a> to 0.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000075"></a><b>change</b>(options)
+    <a name="M000044"></a><b>dst_adjustment</b>(time)
   </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#M000076">set</a> to 0. If the hour and minute is passed,
-then sec and usec is <a href="Time.html#M000076">set</a> to 0.
+Adjust DST
+</p>
+<p>
+TODO: Can&#8216;t seem to get this to pass ActiveSupport tests.
 </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
-
- CREDIT: David Hansson (?)
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000075_source')" id="l_M000075_source">show source</a> ]</p>
-  <div id="M000075_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/change.rb, line 15</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-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-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">:usec</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>
+      Even though it is essentially identical to the
+      ActiveSupport code (see Time#since in time/calculations.rb).
+      It handels all but 4 tests.
 </pre>
   </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000072"></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#M000072">hence</a>.
-</p>
-  </div>
-<div class="aka">
-  This method is also aliased as
-  <a href="Time.html#M000073">in</a>
-  <a href="Time.html#M000084">in</a>
-</div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000072_source')" id="l_M000072_source">show source</a> ]</p>
-  <div id="M000072_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/hence.rb, line 35</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">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">y</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">12</span>).<span class="ruby-identifier">to_i</span>
-      <span class="ruby-identifier">m</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">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">m</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>
+  <p class="source-link">[ <a href="javascript:toggleSource('M000044_source')" id="l_M000044_source">show source</a> ]</p>
+  <div id="M000044_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/core/facets/time/hence.rb, line 80</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>
-  <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
 </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000083"></a><b>hence</b>(number, units=:seconds)
+    <a name="M000043"></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#M000072">hence</a>.
+of time-units <a href="Time.html#M000043">hence</a>.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000083_source')" id="l_M000083_source">show source</a> ]</p>
-  <div id="M000083_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/hence.rb, line 35</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">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">y</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">12</span>).<span class="ruby-identifier">to_i</span>
-      <span class="ruby-identifier">m</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">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">m</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>
+  <p class="source-link">[ <a href="javascript:toggleSource('M000043_source')" id="l_M000043_source">show source</a> ]</p>
+  <div id="M000043_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/core/facets/time/hence.rb, line 45</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-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">y</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">12</span>).<span class="ruby-identifier">to_i</span>
+          <span class="ruby-identifier">m</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">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">m</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>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000073"></a><b>in</b>(number, units=:seconds)
-  </div>
-  <div class="description">
-  <p>
-Alias for <a href="Time.html#M000072">hence</a>
-</p>
-  </div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000084"></a><b>in</b>(number, units=:seconds)
-  </div>
-  <div class="description">
-  <p>
-Alias for <a href="Time.html#M000072">hence</a>
-</p>
-  </div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000070"></a><b>round</b>(amount)
-  </div>
-  <div class="description">
-  <p>
-Round time at the nearest range (<a href="Time.html#M000073">in</a>
-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('M000070_source')" id="l_M000070_source">show source</a> ]</p>
-  <div id="M000070_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="M000081"></a><b>round</b>(amount)
+    <a name="M000041"></a><b>round</b>(amount)
   </div>
   <div class="description">
   <p>
-Round time at the nearest range (<a href="Time.html#M000073">in</a>
-seconds).
+Round time at the nearest range (in seconds).
 </p>
 <pre>
   t = Time.now
@@ -567,8 +384,8 @@ seconds).
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000081_source')" id="l_M000081_source">show source</a> ]</p>
-  <div id="M000081_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000041_source')" id="l_M000041_source">show source</a> ]</p>
+  <div id="M000041_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>)
@@ -580,64 +397,26 @@ seconds).
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000087"></a><b>set</b>(options)
-  </div>
-  <div class="description">
-  <p>
-Like <a href="Time.html#M000075">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#M000075">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('M000087_source')" id="l_M000087_source">show source</a> ]</p>
-  <div id="M000087_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/change.rb, line 33</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="M000076"></a><b>set</b>(options)
+    <a name="M000045"></a><b>set</b>(options)
   </div>
   <div class="description">
   <p>
-Like <a href="Time.html#M000075">change</a> but does not reset earlier
+Like <a href="Time.html#M000047">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#M000075">change</a>&quot;.
+href="Time.html#M000047">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('M000076_source')" id="l_M000076_source">show source</a> ]</p>
-  <div id="M000076_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000045_source')" id="l_M000045_source">show source</a> ]</p>
+  <div id="M000045_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/change.rb, line 33</span>
+<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>,
@@ -656,44 +435,11 @@ href="Time.html#M000075">change</a>&quot;.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000078"></a><b>stamp</b>(fmt = nil)
-  </div>
-  <div class="description">
-  <p>
-Create a time <a href="Time.html#M000077">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>
-<pre>
-  CREDIT: Trans
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000078_source')" id="l_M000078_source">show source</a> ]</p>
-  <div id="M000078_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/stamp.rb, line 34</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="M000089"></a><b>stamp</b>(fmt = nil)
+    <a name="M000049"></a><b>stamp</b>(fmt = nil)
   </div>
   <div class="description">
   <p>
-Create a time <a href="Time.html#M000077">stamp</a>.
+Create a time <a href="Time.html#M000048">stamp</a>.
 </p>
 <pre>
   Time.now.stamp(:short)    #=&gt; &quot;01 Dec 15:15&quot;
@@ -706,10 +452,10 @@ Supported formats come from the Time::FORMAT constant.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000089_source')" id="l_M000089_source">show source</a> ]</p>
-  <div id="M000089_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000049_source')" id="l_M000049_source">show source</a> ]</p>
+  <div id="M000049_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/time/stamp.rb, line 34</span>
+<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>]
@@ -722,28 +468,7 @@ Supported formats come from the Time::FORMAT constant.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000074"></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('M000074_source')" id="l_M000074_source">show source</a> ]</p>
-  <div id="M000074_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="M000085"></a><b>to_time</b>()
+    <a name="M000046"></a><b>to_time</b>()
   </div>
   <div class="description">
   <p>
@@ -751,8 +476,8 @@ To be able to keep Dates and Times interchangeable on conversions.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000085_source')" id="l_M000085_source">show source</a> ]</p>
-  <div id="M000085_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000046_source')" id="l_M000046_source">show source</a> ]</p>
+  <div id="M000046_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>
@@ -764,38 +489,11 @@ To be able to keep Dates and Times interchangeable on conversions.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000080"></a><b>trunc</b>(amount)
-  </div>
-  <div class="description">
-  <p>
-Truncate time at give range (<a href="Time.html#M000073">in</a> 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('M000080_source')" id="l_M000080_source">show source</a> ]</p>
-  <div id="M000080_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 class="method">
-  <div class="title">
-    <a name="M000069"></a><b>trunc</b>(amount)
+    <a name="M000039"></a><b>trunc</b>(amount)
   </div>
   <div class="description">
   <p>
-Truncate time at give range (<a href="Time.html#M000073">in</a> seconds).
+Truncate time at give range (in seconds).
 </p>
 <pre>
   t = Time.now
@@ -805,8 +503,8 @@ Truncate time at give range (<a href="Time.html#M000073">in</a> seconds).
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000069_source')" id="l_M000069_source">show source</a> ]</p>
-  <div id="M000069_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000039_source')" id="l_M000039_source">show source</a> ]</p>
+  <div id="M000039_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>)