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

facets 2.5.2 → 2.6.0

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>