Files
time_ext/doc/Time.html
2010-07-29 04:27:37 +03:00

2951 lines
84 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta name="Content-Type" content="text/html; charset=utf-8" />
<title>Class: Time</title>
<link rel="stylesheet" href="css/style.css" type="text/css" media="screen" charset="utf-8" />
<link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
<script type="text/javascript" charset="utf-8">
relpath = '';
if (relpath != '') relpath += '/';
</script>
<script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
<script type="text/javascript" charset="utf-8" src="js/app.js"></script>
</head>
<body>
<script type="text/javascript" charset="utf-8">
if (window.top.frames.main) document.body.className = 'frames';
</script>
<div id="header">
<div id="menu">
<a href="_index.html">Index (T)</a> &raquo;
<span class="title">Time</span>
<div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
</div>
<div id="search">
<a id="class_list_link" href="#">Class List</a>
<a id="method_list_link" href="#">Method List</a>
<a id ="file_list_link" href="#">File List</a>
</div>
<div class="clear"></div>
</div>
<iframe id="search_frame"></iframe>
<div id="content"><h1>Class: Time
</h1>
<dl class="box">
<dt class="r1">Inherits:</dt>
<dd class="r1">
<span class="inheritName">Object</span>
<ul class="fullTree">
<li>Object</li>
<li class="next">Time</li>
</ul>
<a href="#" class="inheritanceTree">show all</a>
</dd>
<dt class="r2">Includes:</dt>
<dd class="r2"><a href="TimeExt/MethodChain.html" title="TimeExt::MethodChain (module)">TimeExt::MethodChain</a></dd>
<dt class="r1 last">Defined in:</dt>
<dd class="r1 last">lib/time_ext/core_ext/time/iterations.rb<span class="defines">,<br />
lib/time_ext/core_ext/time/calculations.rb</span>
</dd>
</dl>
<div class="clear"></div>
<h2>
Instance Method Summary
<small>(<a href="#" class="summary_toggle">collapse</a>)</small>
</h2>
<ul class="summary">
<li class="public ">
<span class="summary_signature">
<a href="#beginning_of_each-instance_method" title="#beginning_of_each (instance method)">- (Object) <strong>beginning_of_each</strong>(unit, options = {}, &amp;block) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Executes passed block for each &#8220;unit&#8221; of time specified, with a
new time object set to the beginning of &#8220;unit&#8221; for each
interval passed to the block.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#beginning_of_hour-instance_method" title="#beginning_of_hour (instance method)">- (Object) <strong>beginning_of_hour</strong> </a>
(also: #at_beginning_of_hour)
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the start of the hour (XX:00:00).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#beginning_of_minute-instance_method" title="#beginning_of_minute (instance method)">- (Object) <strong>beginning_of_minute</strong> </a>
(also: #at_beginning_of_min, #beginning_of_min, #at_beginning_of_minute)
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the start of the minute (XX:XX:00).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#beginning_of_second-instance_method" title="#beginning_of_second (instance method)">- (Object) <strong>beginning_of_second</strong> </a>
(also: #at_beginning_of_sec, #beginning_of_sec, #at_beginning_of_second)
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the start of the second, XX:XX:XX.000000
(.000000000 in ruby1.9).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#ceil-instance_method" title="#ceil (instance method)">- (Object) <strong>ceil</strong>(unit = :sec) </a>
(also: #beginning_of_next, #at_beginning_of_next)
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the start of the next unit specified
(second by default).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#common_year_days_in_month-instance_method" title="#common_year_days_in_month (instance method)">- (Object) <strong>common_year_days_in_month</strong> </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Helper method for backwards compatibility with ActiveSupport.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#days_ago-instance_method" title="#days_ago (instance method)">- (Object) <strong>days_ago</strong>(days) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the time a number of specified days ago.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#days_into_week-instance_method" title="#days_into_week (instance method)">- (Object) <strong>days_into_week</strong> </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Helper method for backwards compatibility with ActiveSupport.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#days_since-instance_method" title="#days_since (instance method)">- (Object) <strong>days_since</strong>(days) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the time a number of specified days in the
future.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#each-instance_method" title="#each (instance method)">- (Object) <strong>each</strong>(unit, options = {}, &amp;block) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Executes passed block for each &#8220;unit&#8221; of time specified, with a
new time object for each interval passed to the block.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#end_of-instance_method" title="#end_of (instance method)">- (Object) <strong>end_of</strong>(unit = :sec) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the end of the unit specified (defaults to
second).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#end_of_hour-instance_method" title="#end_of_hour (instance method)">- (Object) <strong>end_of_hour</strong> </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the end of the hour, XX:59:59.999999
(.999999999 in ruby1.9).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#end_of_minute-instance_method" title="#end_of_minute (instance method)">- (Object) <strong>end_of_minute</strong> </a>
(also: #end_of_min)
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the end of the hour, XX:XX:59.999999
(.999999999 in ruby1.9).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#end_of_second-instance_method" title="#end_of_second (instance method)">- (Object) <strong>end_of_second</strong> </a>
(also: #end_of_sec)
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the end of the hour, XX:XX:XX.999999
(.999999999 in ruby1.9).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#floor-instance_method" title="#floor (instance method)">- (Object) <strong>floor</strong>(unit = :sec) </a>
(also: #at_beginning_of, #beginning_of)
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the start of the unit specified (second by
default).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#hours_ago-instance_method" title="#hours_ago (instance method)">- (Object) <strong>hours_ago</strong>(hours) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the time a number of specified hours ago.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#hours_since-instance_method" title="#hours_since (instance method)">- (Object) <strong>hours_since</strong>(hours) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the time a number of specified hours in the
future.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#iterate-instance_method" title="#iterate (instance method)">- (Object) <strong>iterate</strong>(unit, options = {}, &amp;block) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Used by #each, #map_each and similar methods to iterate over ranges of
time.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#map_beginning_of_each-instance_method" title="#map_beginning_of_each (instance method)">- (Object) <strong>map_beginning_of_each</strong>(unit, options = {}, &amp;block) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Executes passed block for each &#8220;unit&#8221; of time specified,
returning an array with the return values from passed block.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#map_each-instance_method" title="#map_each (instance method)">- (Object) <strong>map_each</strong>(unit, options = {}, &amp;block) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Executes passed block for each &#8220;unit&#8221; of time specified,
returning an array with the return values from the passed block.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#minutes_ago-instance_method" title="#minutes_ago (instance method)">- (Object) <strong>minutes_ago</strong>(minutes) </a>
(also: #mins_ago)
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the time a number of specified minutes ago.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#minutes_since-instance_method" title="#minutes_since (instance method)">- (Object) <strong>minutes_since</strong>(minutes) </a>
(also: #mins_since)
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the time a number of specified minutes in
the future.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#next-instance_method" title="#next (instance method)">- (Object) <strong>next</strong>(unit = :sec) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the next unit specified (defaults to
second).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#next_day-instance_method" title="#next_day (instance method)">- (Object) <strong>next_day</strong> </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Short-hand for days_since(1).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#next_hour-instance_method" title="#next_hour (instance method)">- (Object) <strong>next_hour</strong> </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Short-hand for hours_since(1).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#next_minute-instance_method" title="#next_minute (instance method)">- (Object) <strong>next_minute</strong> </a>
(also: #next_min)
</span>
<span class="summary_desc"><div class='inline'><p>
Short-hand for minutes_since(1).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#next_quarter-instance_method" title="#next_quarter (instance method)">- (Object) <strong>next_quarter</strong> </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Short-hand for quarters_since(1).beginning_of_quarter.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#next_second-instance_method" title="#next_second (instance method)">- (Object) <strong>next_second</strong> </a>
(also: #next_sec)
</span>
<span class="summary_desc"><div class='inline'><p>
Short-hand for seconds_since(1).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#prev-instance_method" title="#prev (instance method)">- (Object) <strong>prev</strong>(unit = :sec) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the previoius unit specified (defaults to
second).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#prev_day-instance_method" title="#prev_day (instance method)">- (Object) <strong>prev_day</strong> </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Short-hand for days_ago(1).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#prev_hour-instance_method" title="#prev_hour (instance method)">- (Object) <strong>prev_hour</strong> </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Short-hand for hours_ago(1).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#prev_minute-instance_method" title="#prev_minute (instance method)">- (Object) <strong>prev_minute</strong> </a>
(also: #prev_min)
</span>
<span class="summary_desc"><div class='inline'><p>
Short-hand for minutes_ago(1).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#prev_quarter-instance_method" title="#prev_quarter (instance method)">- (Object) <strong>prev_quarter</strong> </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Short-hand for quarters_ago(1).beginning_of_quarter.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#prev_second-instance_method" title="#prev_second (instance method)">- (Object) <strong>prev_second</strong> </a>
(also: #prev_sec)
</span>
<span class="summary_desc"><div class='inline'><p>
Short-hand for seconds_ago(1).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#prev_week-instance_method" title="#prev_week (instance method)">- (Object) <strong>prev_week</strong>(day = :monday) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the start of the given day in the previous
week (default is Monday).
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#quarters_ago-instance_method" title="#quarters_ago (instance method)">- (Object) <strong>quarters_ago</strong>(quarters) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the time a number of specified quarters (3
months) ago.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#quarters_since-instance_method" title="#quarters_since (instance method)">- (Object) <strong>quarters_since</strong>(quarters) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the time a number of specified quarters (3
months) in the future.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#round-instance_method" title="#round (instance method)">- (Object) <strong>round</strong>(unit = :sec) </a>
(also: #beginning_of_closest)
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the start of the current or next unit
specified (second by default) depending which is closest.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#until-instance_method" title="#until (instance method)">- (Object) <strong>until</strong>(time, &amp;block) </a>
(also: #till)
</span>
<span class="summary_desc"><div class='inline'><p>
Used togeter with #each to specify end of interation.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#weeks_ago-instance_method" title="#weeks_ago (instance method)">- (Object) <strong>weeks_ago</strong>(weeks) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the time a number of specified weeks ago.
</p>
</div></span>
</li>
<li class="public ">
<span class="summary_signature">
<a href="#weeks_since-instance_method" title="#weeks_since (instance method)">- (Object) <strong>weeks_since</strong>(weeks) </a>
</span>
<span class="summary_desc"><div class='inline'><p>
Returns a new Time representing the time a number of specified weeks in the
future.
</p>
</div></span>
</li>
</ul>
<h3 class="inherited">Methods included from <a href="TimeExt/MethodChain.html" title="TimeExt::MethodChain (module)">TimeExt::MethodChain</a></h3>
<p class="inherited"><a href="TimeExt/MethodChain.html#add_to_chain-instance_method" title="TimeExt::MethodChain#add_to_chain (method)">#add_to_chain</a>, <a href="TimeExt/MethodChain.html#call_chain-instance_method" title="TimeExt::MethodChain#call_chain (method)">#call_chain</a></p>
<div id="instance_method_details" class="method_details_list">
<h2>Instance Method Details</h2>
<div class="method_details first">
<p class="signature first" id="beginning_of_each-instance_method">
- (<tt>Object</tt>) <strong>beginning_of_each</strong>(unit, options = {}, &amp;block)
</p><div class="docstring">
<div class="discussion">
<p>
Executes passed block for each &#8220;unit&#8221; of time specified, with a
new time object set to the beginning of &#8220;unit&#8221; for each
interval passed to the block.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
34
35
36</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/iterations.rb', line 34</span>
<span class='def def kw'>def</span> <span class='beginning_of_each identifier id'>beginning_of_each</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span><span class='comma token'>,</span> <span class='options identifier id'>options</span> <span class='assign token'>=</span> <span class='lbrace token'>{</span><span class='rbrace token'>}</span><span class='comma token'>,</span> <span class='bitand op'>&amp;</span><span class='block identifier id'>block</span><span class='rparen token'>)</span>
<span class='iterate identifier id'>iterate</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span><span class='comma token'>,</span> <span class='options identifier id'>options</span><span class='dot token'>.</span><span class='merge identifier id'>merge</span><span class='lparen token'>(</span><span class='symbol val'>:map_result</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='false false kw'>false</span><span class='comma token'>,</span> <span class='symbol val'>:beginning_of</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='true true kw'>true</span><span class='rparen token'>)</span><span class='comma token'>,</span> <span class='bitand op'>&amp;</span><span class='block identifier id'>block</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="beginning_of_hour-instance_method">
- (<tt>Object</tt>) <strong>beginning_of_hour</strong>
<span class="aliases">Also known as:
<span class="names"><span id='at_beginning_of_hour-instance_method'>at_beginning_of_hour</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the start of the hour (XX:00:00).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
201
202
203</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 201</span>
<span class='def def kw'>def</span> <span class='beginning_of_hour identifier id'>beginning_of_hour</span>
<span class='change identifier id'>change</span><span class='lparen token'>(</span><span class='symbol val'>:min</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>0</span><span class='comma token'>,</span> <span class='symbol val'>:sec</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>0</span><span class='comma token'>,</span> <span class='symbol val'>:usec</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>0</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="beginning_of_minute-instance_method">
- (<tt>Object</tt>) <strong>beginning_of_minute</strong>
<span class="aliases">Also known as:
<span class="names"><span id='at_beginning_of_min-instance_method'>at_beginning_of_min</span>, <span id='beginning_of_min-instance_method'>beginning_of_min</span>, <span id='at_beginning_of_minute-instance_method'>at_beginning_of_minute</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the start of the minute (XX:XX:00).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
187
188
189</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 187</span>
<span class='def def kw'>def</span> <span class='beginning_of_minute identifier id'>beginning_of_minute</span>
<span class='change identifier id'>change</span><span class='lparen token'>(</span><span class='symbol val'>:sec</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>0</span><span class='comma token'>,</span> <span class='symbol val'>:usec</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>0</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="beginning_of_second-instance_method">
- (<tt>Object</tt>) <strong>beginning_of_second</strong>
<span class="aliases">Also known as:
<span class="names"><span id='at_beginning_of_sec-instance_method'>at_beginning_of_sec</span>, <span id='beginning_of_sec-instance_method'>beginning_of_sec</span>, <span id='at_beginning_of_second-instance_method'>at_beginning_of_second</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the start of the second, XX:XX:XX.000000
(.000000000 in ruby1.9).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
173
174
175</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 173</span>
<span class='def def kw'>def</span> <span class='beginning_of_second identifier id'>beginning_of_second</span>
<span class='change identifier id'>change</span><span class='lparen token'>(</span><span class='symbol val'>:usec</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>0</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="ceil-instance_method">
- (<tt>Object</tt>) <strong>ceil</strong>(unit = :sec)
<span class="aliases">Also known as:
<span class="names"><span id='beginning_of_next-instance_method'>beginning_of_next</span>, <span id='at_beginning_of_next-instance_method'>at_beginning_of_next</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the start of the next unit specified
(second by default).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
21
22
23</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 21</span>
<span class='def def kw'>def</span> <span class='ceil identifier id'>ceil</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span> <span class='assign token'>=</span> <span class='symbol val'>:sec</span><span class='rparen token'>)</span>
<span class='self self kw'>self</span><span class='dot token'>.</span><span class='send identifier id'>send</span><span class='lparen token'>(</span><span class='dstring node'>&quot;next_#{unit}&quot;</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='send identifier id'>send</span><span class='lparen token'>(</span><span class='dstring node'>&quot;beginning_of_#{unit}&quot;</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="common_year_days_in_month-instance_method">
- (<tt>Object</tt>) <strong>common_year_days_in_month</strong>
</p><div class="docstring">
<div class="discussion">
<p>
Helper method for backwards compatibility with ActiveSupport.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
9
10
11</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 9</span>
<span class='def def kw'>def</span> <span class='common_year_days_in_month identifier id'>common_year_days_in_month</span>
<span class='defined? defined kw'>defined?</span><span class='lparen token'>(</span><span class='COMMON_YEAR_DAYS_IN_MONTH constant id'>COMMON_YEAR_DAYS_IN_MONTH</span><span class='rparen token'>)</span> <span class='question op'>?</span> <span class='COMMON_YEAR_DAYS_IN_MONTH constant id'>COMMON_YEAR_DAYS_IN_MONTH</span> <span class='colon op'>:</span> <span class='lbrack token'>[</span><span class='nil nil kw'>nil</span><span class='comma token'>,</span> <span class='integer val'>31</span><span class='comma token'>,</span> <span class='integer val'>28</span><span class='comma token'>,</span> <span class='integer val'>31</span><span class='comma token'>,</span> <span class='integer val'>30</span><span class='comma token'>,</span> <span class='integer val'>31</span><span class='comma token'>,</span> <span class='integer val'>30</span><span class='comma token'>,</span> <span class='integer val'>31</span><span class='comma token'>,</span> <span class='integer val'>31</span><span class='comma token'>,</span> <span class='integer val'>30</span><span class='comma token'>,</span> <span class='integer val'>31</span><span class='comma token'>,</span> <span class='integer val'>30</span><span class='comma token'>,</span> <span class='integer val'>31</span><span class='rbrack token'>]</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="days_ago-instance_method">
- (<tt>Object</tt>) <strong>days_ago</strong>(days)
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the time a number of specified days ago.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
133
134
135</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 133</span>
<span class='def def kw'>def</span> <span class='days_ago identifier id'>days_ago</span><span class='lparen token'>(</span><span class='days identifier id'>days</span><span class='rparen token'>)</span>
<span class='ago identifier id'>ago</span><span class='lparen token'>(</span><span class='days identifier id'>days</span><span class='dot token'>.</span><span class='days identifier id'>days</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="days_into_week-instance_method">
- (<tt>Object</tt>) <strong>days_into_week</strong>
</p><div class="docstring">
<div class="discussion">
<p>
Helper method for backwards compatibility with ActiveSupport.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
4
5
6</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 4</span>
<span class='def def kw'>def</span> <span class='days_into_week identifier id'>days_into_week</span>
<span class='defined? defined kw'>defined?</span><span class='lparen token'>(</span><span class='DAYS_INTO_WEEK constant id'>DAYS_INTO_WEEK</span><span class='rparen token'>)</span> <span class='question op'>?</span> <span class='DAYS_INTO_WEEK constant id'>DAYS_INTO_WEEK</span> <span class='colon op'>:</span> <span class='lbrace token'>{</span> <span class='symbol val'>:monday</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>0</span><span class='comma token'>,</span> <span class='symbol val'>:tuesday</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>1</span><span class='comma token'>,</span> <span class='symbol val'>:wednesday</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>2</span><span class='comma token'>,</span> <span class='symbol val'>:thursday</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>3</span><span class='comma token'>,</span> <span class='symbol val'>:friday</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>4</span><span class='comma token'>,</span> <span class='symbol val'>:saturday</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>5</span><span class='comma token'>,</span> <span class='symbol val'>:sunday</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>6</span> <span class='rbrace token'>}</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="days_since-instance_method">
- (<tt>Object</tt>) <strong>days_since</strong>(days)
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the time a number of specified days in the
future.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
138
139
140</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 138</span>
<span class='def def kw'>def</span> <span class='days_since identifier id'>days_since</span><span class='lparen token'>(</span><span class='days identifier id'>days</span><span class='rparen token'>)</span>
<span class='since identifier id'>since</span><span class='lparen token'>(</span><span class='days identifier id'>days</span><span class='dot token'>.</span><span class='days identifier id'>days</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="each-instance_method">
- (<tt>Object</tt>) <strong>each</strong>(unit, options = {}, &amp;block)
</p><div class="docstring">
<div class="discussion">
<p>
Executes passed block for each &#8220;unit&#8221; of time specified, with a
new time object for each interval passed to the block.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
29
30
31</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/iterations.rb', line 29</span>
<span class='def def kw'>def</span> <span class='each identifier id'>each</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span><span class='comma token'>,</span> <span class='options identifier id'>options</span> <span class='assign token'>=</span> <span class='lbrace token'>{</span><span class='rbrace token'>}</span><span class='comma token'>,</span> <span class='bitand op'>&amp;</span><span class='block identifier id'>block</span><span class='rparen token'>)</span>
<span class='iterate identifier id'>iterate</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span><span class='comma token'>,</span> <span class='options identifier id'>options</span><span class='dot token'>.</span><span class='merge identifier id'>merge</span><span class='lparen token'>(</span><span class='symbol val'>:map_result</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='false false kw'>false</span><span class='rparen token'>)</span><span class='comma token'>,</span> <span class='bitand op'>&amp;</span><span class='block identifier id'>block</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="end_of-instance_method">
- (<tt>Object</tt>) <strong>end_of</strong>(unit = :sec)
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the end of the unit specified (defaults to
second).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
168
169
170</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 168</span>
<span class='def def kw'>def</span> <span class='end_of identifier id'>end_of</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span> <span class='assign token'>=</span> <span class='symbol val'>:sec</span><span class='rparen token'>)</span>
<span class='send identifier id'>send</span><span class='lparen token'>(</span><span class='dstring node'>&quot;end_of_#{unit}&quot;</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="end_of_hour-instance_method">
- (<tt>Object</tt>) <strong>end_of_hour</strong>
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the end of the hour, XX:59:59.999999
(.999999999 in ruby1.9).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
207
208
209</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 207</span>
<span class='def def kw'>def</span> <span class='end_of_hour identifier id'>end_of_hour</span>
<span class='change identifier id'>change</span><span class='lparen token'>(</span><span class='symbol val'>:min</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>59</span><span class='comma token'>,</span> <span class='symbol val'>:sec</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>59</span><span class='comma token'>,</span> <span class='symbol val'>:usec</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='float val'>999999.999</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="end_of_minute-instance_method">
- (<tt>Object</tt>) <strong>end_of_minute</strong>
<span class="aliases">Also known as:
<span class="names"><span id='end_of_min-instance_method'>end_of_min</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the end of the hour, XX:XX:59.999999
(.999999999 in ruby1.9).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
195
196
197</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 195</span>
<span class='def def kw'>def</span> <span class='end_of_minute identifier id'>end_of_minute</span>
<span class='change identifier id'>change</span><span class='lparen token'>(</span><span class='symbol val'>:sec</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>59</span><span class='comma token'>,</span> <span class='symbol val'>:usec</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='float val'>999999.999</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="end_of_second-instance_method">
- (<tt>Object</tt>) <strong>end_of_second</strong>
<span class="aliases">Also known as:
<span class="names"><span id='end_of_sec-instance_method'>end_of_sec</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the end of the hour, XX:XX:XX.999999
(.999999999 in ruby1.9).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
181
182
183</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 181</span>
<span class='def def kw'>def</span> <span class='end_of_second identifier id'>end_of_second</span>
<span class='change identifier id'>change</span><span class='lparen token'>(</span><span class='symbol val'>:usec</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='float val'>999999.999</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="floor-instance_method">
- (<tt>Object</tt>) <strong>floor</strong>(unit = :sec)
<span class="aliases">Also known as:
<span class="names"><span id='at_beginning_of-instance_method'>at_beginning_of</span>, <span id='beginning_of-instance_method'>beginning_of</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the start of the unit specified (second by
default).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
14
15
16</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 14</span>
<span class='def def kw'>def</span> <span class='floor identifier id'>floor</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span> <span class='assign token'>=</span> <span class='symbol val'>:sec</span><span class='rparen token'>)</span>
<span class='self self kw'>self</span><span class='dot token'>.</span><span class='send identifier id'>send</span><span class='lparen token'>(</span><span class='dstring node'>&quot;beginning_of_#{unit}&quot;</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="hours_ago-instance_method">
- (<tt>Object</tt>) <strong>hours_ago</strong>(hours)
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the time a number of specified hours ago.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
123
124
125</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 123</span>
<span class='def def kw'>def</span> <span class='hours_ago identifier id'>hours_ago</span><span class='lparen token'>(</span><span class='hours identifier id'>hours</span><span class='rparen token'>)</span>
<span class='ago identifier id'>ago</span><span class='lparen token'>(</span><span class='hours identifier id'>hours</span><span class='dot token'>.</span><span class='hours identifier id'>hours</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="hours_since-instance_method">
- (<tt>Object</tt>) <strong>hours_since</strong>(hours)
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the time a number of specified hours in the
future.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
128
129
130</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 128</span>
<span class='def def kw'>def</span> <span class='hours_since identifier id'>hours_since</span><span class='lparen token'>(</span><span class='hours identifier id'>hours</span><span class='rparen token'>)</span>
<span class='since identifier id'>since</span><span class='lparen token'>(</span><span class='hours identifier id'>hours</span><span class='dot token'>.</span><span class='hours identifier id'>hours</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="iterate-instance_method">
- (<tt>Object</tt>) <strong>iterate</strong>(unit, options = {}, &amp;block)
</p><div class="docstring">
<div class="discussion">
<p>
Used by #each, #map_each and similar methods to iterate over ranges of
time.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/iterations.rb', line 5</span>
<span class='def def kw'>def</span> <span class='iterate identifier id'>iterate</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span><span class='comma token'>,</span> <span class='options identifier id'>options</span> <span class='assign token'>=</span> <span class='lbrace token'>{</span><span class='rbrace token'>}</span><span class='comma token'>,</span> <span class='bitand op'>&amp;</span><span class='block identifier id'>block</span><span class='rparen token'>)</span>
<span class='options identifier id'>options</span><span class='dot token'>.</span><span class='reverse_merge! fid id'>reverse_merge!</span><span class='lparen token'>(</span><span class='symbol val'>:map_result</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='false false kw'>false</span><span class='comma token'>,</span> <span class='symbol val'>:beginning_of</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='false false kw'>false</span><span class='comma token'>,</span> <span class='symbol val'>:include_start</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='false false kw'>false</span><span class='rparen token'>)</span>
<span class='if if kw'>if</span> <span class='block_given? fid id'>block_given?</span>
<span class='units identifier id'>units</span> <span class='assign token'>=</span> <span class='lbrack token'>[</span><span class='symbol val'>:year</span><span class='comma token'>,</span> <span class='symbol val'>:month</span><span class='comma token'>,</span> <span class='symbol val'>:day</span><span class='comma token'>,</span> <span class='symbol val'>:hour</span><span class='comma token'>,</span> <span class='symbol val'>:min</span><span class='comma token'>,</span> <span class='symbol val'>:sec</span><span class='comma token'>,</span> <span class='symbol val'>:usec</span><span class='rbrack token'>]</span>
<span class='parent_unit identifier id'>parent_unit</span> <span class='assign token'>=</span> <span class='units identifier id'>units</span><span class='lbrack token'>[</span><span class='units identifier id'>units</span><span class='dot token'>.</span><span class='index identifier id'>index</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span><span class='rparen token'>)</span><span class='minus op'>-</span><span class='integer val'>1</span><span class='rbrack token'>]</span>
<span class='@until ivar id'>@until</span> <span class='opasgn op'>||=</span> <span class='lparen token'>(</span><span class='notop op'>!</span><span class='parent_unit identifier id'>parent_unit</span><span class='dot token'>.</span><span class='nil? fid id'>nil?</span><span class='rparen token'>)</span> <span class='question op'>?</span> <span class='self self kw'>self</span><span class='dot token'>.</span><span class='send identifier id'>send</span><span class='lparen token'>(</span><span class='dstring node'>&quot;#{parent_unit}s_since&quot;</span><span class='comma token'>,</span> <span class='integer val'>1</span><span class='rparen token'>)</span> <span class='colon op'>:</span> <span class='self self kw'>self</span><span class='dot token'>.</span><span class='send identifier id'>send</span><span class='lparen token'>(</span><span class='dstring node'>&quot;#{unit}s_since&quot;</span><span class='comma token'>,</span> <span class='integer val'>1</span><span class='rparen token'>)</span>
<span class='time identifier id'>time</span> <span class='assign token'>=</span> <span class='self self kw'>self</span><span class='dot token'>.</span><span class='clone identifier id'>clone</span>
<span class='direction identifier id'>direction</span> <span class='assign token'>=</span> <span class='lparen token'>(</span><span class='self self kw'>self</span> <span class='lt op'>&lt;</span> <span class='@until ivar id'>@until</span><span class='rparen token'>)</span> <span class='question op'>?</span> <span class='symbol val'>:f</span> <span class='colon op'>:</span> <span class='symbol val'>:b</span>
<span class='succ_method identifier id'>succ_method</span> <span class='assign token'>=</span> <span class='lparen token'>(</span><span class='direction identifier id'>direction</span> <span class='eq op'>==</span> <span class='symbol val'>:f</span><span class='rparen token'>)</span> <span class='question op'>?</span> <span class='dstring node'>&quot;next_#{unit}&quot;</span> <span class='colon op'>:</span> <span class='dstring node'>&quot;prev_#{unit}&quot;</span>
<span class='time identifier id'>time</span> <span class='assign token'>=</span> <span class='time identifier id'>time</span><span class='dot token'>.</span><span class='beginning_of identifier id'>beginning_of</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span><span class='rparen token'>)</span> <span class='if if_mod kw'>if</span> <span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:beginning_of</span><span class='rbrack token'>]</span>
<span class='time identifier id'>time</span> <span class='assign token'>=</span> <span class='time identifier id'>time</span><span class='dot token'>.</span><span class='send identifier id'>send</span><span class='lparen token'>(</span><span class='succ_method identifier id'>succ_method</span><span class='rparen token'>)</span> <span class='if if_mod kw'>if</span> <span class='notop op'>!</span><span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:include_start</span><span class='rbrack token'>]</span>
<span class='results identifier id'>results</span> <span class='assign token'>=</span> <span class='lbrack token'>[</span><span class='rbrack token'>]</span>
<span class='while while kw'>while</span> <span class='lparen token'>(</span><span class='direction identifier id'>direction</span> <span class='eq op'>==</span> <span class='symbol val'>:f</span> <span class='andop op'>&amp;&amp;</span> <span class='time identifier id'>time</span> <span class='leq op'>&lt;=</span> <span class='@until ivar id'>@until</span><span class='rparen token'>)</span> <span class='orop op'>||</span> <span class='lparen token'>(</span><span class='direction identifier id'>direction</span> <span class='eq op'>==</span> <span class='symbol val'>:b</span> <span class='andop op'>&amp;&amp;</span> <span class='time identifier id'>time</span> <span class='geq op'>&gt;=</span> <span class='@until ivar id'>@until</span><span class='rparen token'>)</span>
<span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:map_result</span><span class='rbrack token'>]</span> <span class='question op'>?</span> <span class='results identifier id'>results</span> <span class='lshft op'>&lt;&lt;</span> <span class='yield yield kw'>yield</span><span class='lparen token'>(</span><span class='time identifier id'>time</span><span class='rparen token'>)</span> <span class='colon op'>:</span> <span class='yield yield kw'>yield</span><span class='lparen token'>(</span><span class='time identifier id'>time</span><span class='rparen token'>)</span>
<span class='time identifier id'>time</span> <span class='assign token'>=</span> <span class='time identifier id'>time</span><span class='dot token'>.</span><span class='send identifier id'>send</span><span class='lparen token'>(</span><span class='succ_method identifier id'>succ_method</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
<span class='options identifier id'>options</span><span class='lbrack token'>[</span><span class='symbol val'>:map_result</span><span class='rbrack token'>]</span> <span class='question op'>?</span> <span class='results identifier id'>results</span> <span class='colon op'>:</span> <span class='self self kw'>self</span>
<span class='else else kw'>else</span>
<span class='add_to_chain identifier id'>add_to_chain</span><span class='lparen token'>(</span><span class='symbol val'>:iterate</span><span class='comma token'>,</span> <span class='unit identifier id'>unit</span><span class='comma token'>,</span> <span class='options identifier id'>options</span><span class='rparen token'>)</span>
<span class='self self kw'>self</span>
<span class='end end kw'>end</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="map_beginning_of_each-instance_method">
- (<tt>Object</tt>) <strong>map_beginning_of_each</strong>(unit, options = {}, &amp;block)
</p><div class="docstring">
<div class="discussion">
<p>
Executes passed block for each &#8220;unit&#8221; of time specified,
returning an array with the return values from passed block. Additionally
the time object passed into the block is set to the beginning of specified
&#8220;unit&#8221;.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
44
45
46</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/iterations.rb', line 44</span>
<span class='def def kw'>def</span> <span class='map_beginning_of_each identifier id'>map_beginning_of_each</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span><span class='comma token'>,</span> <span class='options identifier id'>options</span> <span class='assign token'>=</span> <span class='lbrace token'>{</span><span class='rbrace token'>}</span><span class='comma token'>,</span> <span class='bitand op'>&amp;</span><span class='block identifier id'>block</span><span class='rparen token'>)</span>
<span class='iterate identifier id'>iterate</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span><span class='comma token'>,</span> <span class='options identifier id'>options</span><span class='dot token'>.</span><span class='merge identifier id'>merge</span><span class='lparen token'>(</span><span class='symbol val'>:map_result</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='true true kw'>true</span><span class='comma token'>,</span> <span class='symbol val'>:beginning_of</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='true true kw'>true</span><span class='rparen token'>)</span><span class='comma token'>,</span> <span class='bitand op'>&amp;</span><span class='block identifier id'>block</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="map_each-instance_method">
- (<tt>Object</tt>) <strong>map_each</strong>(unit, options = {}, &amp;block)
</p><div class="docstring">
<div class="discussion">
<p>
Executes passed block for each &#8220;unit&#8221; of time specified,
returning an array with the return values from the passed block.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
39
40
41</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/iterations.rb', line 39</span>
<span class='def def kw'>def</span> <span class='map_each identifier id'>map_each</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span><span class='comma token'>,</span> <span class='options identifier id'>options</span> <span class='assign token'>=</span> <span class='lbrace token'>{</span><span class='rbrace token'>}</span><span class='comma token'>,</span> <span class='bitand op'>&amp;</span><span class='block identifier id'>block</span><span class='rparen token'>)</span>
<span class='iterate identifier id'>iterate</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span><span class='comma token'>,</span> <span class='options identifier id'>options</span><span class='dot token'>.</span><span class='merge identifier id'>merge</span><span class='lparen token'>(</span><span class='symbol val'>:map_result</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='true true kw'>true</span><span class='rparen token'>)</span><span class='comma token'>,</span> <span class='bitand op'>&amp;</span><span class='block identifier id'>block</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="minutes_ago-instance_method">
- (<tt>Object</tt>) <strong>minutes_ago</strong>(minutes)
<span class="aliases">Also known as:
<span class="names"><span id='mins_ago-instance_method'>mins_ago</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the time a number of specified minutes ago.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
111
112
113</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 111</span>
<span class='def def kw'>def</span> <span class='minutes_ago identifier id'>minutes_ago</span><span class='lparen token'>(</span><span class='minutes identifier id'>minutes</span><span class='rparen token'>)</span>
<span class='ago identifier id'>ago</span><span class='lparen token'>(</span><span class='minutes identifier id'>minutes</span><span class='dot token'>.</span><span class='minutes identifier id'>minutes</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="minutes_since-instance_method">
- (<tt>Object</tt>) <strong>minutes_since</strong>(minutes)
<span class="aliases">Also known as:
<span class="names"><span id='mins_since-instance_method'>mins_since</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the time a number of specified minutes in
the future.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
117
118
119</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 117</span>
<span class='def def kw'>def</span> <span class='minutes_since identifier id'>minutes_since</span><span class='lparen token'>(</span><span class='minutes identifier id'>minutes</span><span class='rparen token'>)</span>
<span class='since identifier id'>since</span><span class='lparen token'>(</span><span class='minutes identifier id'>minutes</span><span class='dot token'>.</span><span class='minutes identifier id'>minutes</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="next-instance_method">
- (<tt>Object</tt>) <strong>next</strong>(unit = :sec)
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the next unit specified (defaults to
second).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
41
42
43</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 41</span>
<span class='def def kw'>def</span> <span class='next next kw'>next</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span> <span class='assign token'>=</span> <span class='symbol val'>:sec</span><span class='rparen token'>)</span>
<span class='send identifier id'>send</span><span class='lparen token'>(</span><span class='dstring node'>&quot;next_#{unit}&quot;</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="next_day-instance_method">
- (<tt>Object</tt>) <strong>next_day</strong>
</p><div class="docstring">
<div class="discussion">
<p>
Short-hand for days_since(1).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
85
86
87</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 85</span>
<span class='def def kw'>def</span> <span class='next_day identifier id'>next_day</span>
<span class='days_since identifier id'>days_since</span><span class='lparen token'>(</span><span class='integer val'>1</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="next_hour-instance_method">
- (<tt>Object</tt>) <strong>next_hour</strong>
</p><div class="docstring">
<div class="discussion">
<p>
Short-hand for hours_since(1).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
75
76
77</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 75</span>
<span class='def def kw'>def</span> <span class='next_hour identifier id'>next_hour</span>
<span class='hours_since identifier id'>hours_since</span><span class='lparen token'>(</span><span class='integer val'>1</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="next_minute-instance_method">
- (<tt>Object</tt>) <strong>next_minute</strong>
<span class="aliases">Also known as:
<span class="names"><span id='next_min-instance_method'>next_min</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Short-hand for minutes_since(1).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
64
65
66</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 64</span>
<span class='def def kw'>def</span> <span class='next_minute identifier id'>next_minute</span>
<span class='minutes_since identifier id'>minutes_since</span><span class='lparen token'>(</span><span class='integer val'>1</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="next_quarter-instance_method">
- (<tt>Object</tt>) <strong>next_quarter</strong>
</p><div class="docstring">
<div class="discussion">
<p>
Short-hand for quarters_since(1).beginning_of_quarter.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
95
96
97</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 95</span>
<span class='def def kw'>def</span> <span class='next_quarter identifier id'>next_quarter</span>
<span class='quarters_since identifier id'>quarters_since</span><span class='lparen token'>(</span><span class='integer val'>1</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='beginning_of_quarter identifier id'>beginning_of_quarter</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="next_second-instance_method">
- (<tt>Object</tt>) <strong>next_second</strong>
<span class="aliases">Also known as:
<span class="names"><span id='next_sec-instance_method'>next_sec</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Short-hand for seconds_since(1).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
52
53
54</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 52</span>
<span class='def def kw'>def</span> <span class='next_second identifier id'>next_second</span>
<span class='since identifier id'>since</span><span class='lparen token'>(</span><span class='integer val'>1</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="prev-instance_method">
- (<tt>Object</tt>) <strong>prev</strong>(unit = :sec)
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the previoius unit specified (defaults to
second).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
36
37
38</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 36</span>
<span class='def def kw'>def</span> <span class='prev identifier id'>prev</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span> <span class='assign token'>=</span> <span class='symbol val'>:sec</span><span class='rparen token'>)</span>
<span class='send identifier id'>send</span><span class='lparen token'>(</span><span class='dstring node'>&quot;prev_#{unit}&quot;</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="prev_day-instance_method">
- (<tt>Object</tt>) <strong>prev_day</strong>
</p><div class="docstring">
<div class="discussion">
<p>
Short-hand for days_ago(1).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
80
81
82</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 80</span>
<span class='def def kw'>def</span> <span class='prev_day identifier id'>prev_day</span>
<span class='days_ago identifier id'>days_ago</span><span class='lparen token'>(</span><span class='integer val'>1</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="prev_hour-instance_method">
- (<tt>Object</tt>) <strong>prev_hour</strong>
</p><div class="docstring">
<div class="discussion">
<p>
Short-hand for hours_ago(1).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
70
71
72</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 70</span>
<span class='def def kw'>def</span> <span class='prev_hour identifier id'>prev_hour</span>
<span class='hours_ago identifier id'>hours_ago</span><span class='lparen token'>(</span><span class='integer val'>1</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="prev_minute-instance_method">
- (<tt>Object</tt>) <strong>prev_minute</strong>
<span class="aliases">Also known as:
<span class="names"><span id='prev_min-instance_method'>prev_min</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Short-hand for minutes_ago(1).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
58
59
60</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 58</span>
<span class='def def kw'>def</span> <span class='prev_minute identifier id'>prev_minute</span>
<span class='minutes_ago identifier id'>minutes_ago</span><span class='lparen token'>(</span><span class='integer val'>1</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="prev_quarter-instance_method">
- (<tt>Object</tt>) <strong>prev_quarter</strong>
</p><div class="docstring">
<div class="discussion">
<p>
Short-hand for quarters_ago(1).beginning_of_quarter.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
100
101
102</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 100</span>
<span class='def def kw'>def</span> <span class='prev_quarter identifier id'>prev_quarter</span>
<span class='quarters_ago identifier id'>quarters_ago</span><span class='lparen token'>(</span><span class='integer val'>1</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='beginning_of_quarter identifier id'>beginning_of_quarter</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="prev_second-instance_method">
- (<tt>Object</tt>) <strong>prev_second</strong>
<span class="aliases">Also known as:
<span class="names"><span id='prev_sec-instance_method'>prev_sec</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Short-hand for seconds_ago(1).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
46
47
48</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 46</span>
<span class='def def kw'>def</span> <span class='prev_second identifier id'>prev_second</span>
<span class='ago identifier id'>ago</span><span class='lparen token'>(</span><span class='integer val'>1</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="prev_week-instance_method">
- (<tt>Object</tt>) <strong>prev_week</strong>(day = :monday)
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the start of the given day in the previous
week (default is Monday).
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
90
91
92</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 90</span>
<span class='def def kw'>def</span> <span class='prev_week identifier id'>prev_week</span><span class='lparen token'>(</span><span class='day identifier id'>day</span> <span class='assign token'>=</span> <span class='symbol val'>:monday</span><span class='rparen token'>)</span>
<span class='weeks_ago identifier id'>weeks_ago</span><span class='lparen token'>(</span><span class='integer val'>1</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='beginning_of_week identifier id'>beginning_of_week</span><span class='dot token'>.</span><span class='since identifier id'>since</span><span class='lparen token'>(</span><span class='days_into_week identifier id'>days_into_week</span><span class='lbrack token'>[</span><span class='day identifier id'>day</span><span class='rbrack token'>]</span><span class='dot token'>.</span><span class='day identifier id'>day</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='change identifier id'>change</span><span class='lparen token'>(</span><span class='symbol val'>:hour</span> <span class='assign token'>=</span><span class='gt op'>&gt;</span> <span class='integer val'>0</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="quarters_ago-instance_method">
- (<tt>Object</tt>) <strong>quarters_ago</strong>(quarters)
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the time a number of specified quarters (3
months) ago.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
153
154
155</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 153</span>
<span class='def def kw'>def</span> <span class='quarters_ago identifier id'>quarters_ago</span><span class='lparen token'>(</span><span class='quarters identifier id'>quarters</span><span class='rparen token'>)</span>
<span class='ago identifier id'>ago</span><span class='lparen token'>(</span><span class='lparen token'>(</span><span class='quarters identifier id'>quarters</span> <span class='mult op'>*</span> <span class='integer val'>3</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='months identifier id'>months</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="quarters_since-instance_method">
- (<tt>Object</tt>) <strong>quarters_since</strong>(quarters)
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the time a number of specified quarters (3
months) in the future.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
158
159
160</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 158</span>
<span class='def def kw'>def</span> <span class='quarters_since identifier id'>quarters_since</span><span class='lparen token'>(</span><span class='quarters identifier id'>quarters</span><span class='rparen token'>)</span>
<span class='since identifier id'>since</span><span class='lparen token'>(</span><span class='lparen token'>(</span><span class='quarters identifier id'>quarters</span> <span class='mult op'>*</span> <span class='integer val'>3</span><span class='rparen token'>)</span><span class='dot token'>.</span><span class='months identifier id'>months</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="round-instance_method">
- (<tt>Object</tt>) <strong>round</strong>(unit = :sec)
<span class="aliases">Also known as:
<span class="names"><span id='beginning_of_closest-instance_method'>beginning_of_closest</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the start of the current or next unit
specified (second by default) depending which is closest
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
28
29
30
31
32</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 28</span>
<span class='def def kw'>def</span> <span class='round identifier id'>round</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span> <span class='assign token'>=</span> <span class='symbol val'>:sec</span><span class='rparen token'>)</span>
<span class='next_unit identifier id'>next_unit</span> <span class='assign token'>=</span> <span class='self self kw'>self</span><span class='dot token'>.</span><span class='ceil identifier id'>ceil</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span><span class='rparen token'>)</span>
<span class='this_unit identifier id'>this_unit</span> <span class='assign token'>=</span> <span class='self self kw'>self</span><span class='dot token'>.</span><span class='floor identifier id'>floor</span><span class='lparen token'>(</span><span class='unit identifier id'>unit</span><span class='rparen token'>)</span>
<span class='lparen token'>(</span><span class='self self kw'>self</span> <span class='minus op'>-</span> <span class='this_unit identifier id'>this_unit</span><span class='rparen token'>)</span> <span class='lt op'>&lt;</span> <span class='lparen token'>(</span><span class='next_unit identifier id'>next_unit</span> <span class='minus op'>-</span> <span class='self self kw'>self</span><span class='rparen token'>)</span> <span class='question op'>?</span> <span class='this_unit identifier id'>this_unit</span> <span class='colon op'>:</span> <span class='next_unit identifier id'>next_unit</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="until-instance_method">
- (<tt>Object</tt>) <strong>until</strong>(time, &amp;block)
<span class="aliases">Also known as:
<span class="names"><span id='till-instance_method'>till</span></span>
</span>
</p><div class="docstring">
<div class="discussion">
<p>
Used togeter with #each to specify end of interation.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
49
50
51
52
53
54
55
56
57
58</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/iterations.rb', line 49</span>
<span class='def def kw'>def</span> <span class='until until kw'>until</span><span class='lparen token'>(</span><span class='time identifier id'>time</span><span class='comma token'>,</span> <span class='bitand op'>&amp;</span><span class='block identifier id'>block</span><span class='rparen token'>)</span>
<span class='time identifier id'>time</span> <span class='assign token'>=</span> <span class='time identifier id'>time</span><span class='dot token'>.</span><span class='to_time identifier id'>to_time</span> <span class='if if_mod kw'>if</span> <span class='time identifier id'>time</span><span class='dot token'>.</span><span class='is_a? fid id'>is_a?</span><span class='lparen token'>(</span><span class='colon3 op'>::</span><span class='Date constant id'>Date</span><span class='rparen token'>)</span>
<span class='@until ivar id'>@until</span> <span class='assign token'>=</span> <span class='time identifier id'>time</span>
<span class='if if kw'>if</span> <span class='block_given? fid id'>block_given?</span>
<span class='call_chain identifier id'>call_chain</span><span class='lparen token'>(</span><span class='block identifier id'>block</span><span class='rparen token'>)</span>
<span class='else else kw'>else</span>
<span class='add_to_chain identifier id'>add_to_chain</span><span class='lparen token'>(</span><span class='symbol val'>:until</span><span class='comma token'>,</span> <span class='time identifier id'>time</span><span class='rparen token'>)</span>
<span class='self self kw'>self</span>
<span class='end end kw'>end</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="weeks_ago-instance_method">
- (<tt>Object</tt>) <strong>weeks_ago</strong>(weeks)
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the time a number of specified weeks ago.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
143
144
145</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 143</span>
<span class='def def kw'>def</span> <span class='weeks_ago identifier id'>weeks_ago</span><span class='lparen token'>(</span><span class='weeks identifier id'>weeks</span><span class='rparen token'>)</span>
<span class='ago identifier id'>ago</span><span class='lparen token'>(</span><span class='weeks identifier id'>weeks</span><span class='dot token'>.</span><span class='weeks identifier id'>weeks</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
<div class="method_details ">
<p class="signature " id="weeks_since-instance_method">
- (<tt>Object</tt>) <strong>weeks_since</strong>(weeks)
</p><div class="docstring">
<div class="discussion">
<p>
Returns a new Time representing the time a number of specified weeks in the
future.
</p>
</div>
</div>
<div class="tags">
</div><table class="source_code">
<tr>
<td>
<pre class="lines">
148
149
150</pre>
</td>
<td>
<pre class="code"><span class="info file"># File 'lib/time_ext/core_ext/time/calculations.rb', line 148</span>
<span class='def def kw'>def</span> <span class='weeks_since identifier id'>weeks_since</span><span class='lparen token'>(</span><span class='weeks identifier id'>weeks</span><span class='rparen token'>)</span>
<span class='since identifier id'>since</span><span class='lparen token'>(</span><span class='weeks identifier id'>weeks</span><span class='dot token'>.</span><span class='weeks identifier id'>weeks</span><span class='rparen token'>)</span>
<span class='end end kw'>end</span>
</pre>
</td>
</tr>
</table>
</div>
</div>
</div>
<div id="footer">
Generated on Thu Jul 29 04:27:16 2010 by
<a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool">yard</a>
0.5.8 (ruby-1.8.7).
</div>
</body>
</html>