doc/api/classes/ActiveSupport/CoreExtensions/Time/Calculations.html
<?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 xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>Module: ActiveSupport::CoreExtensions::Time::Calculations</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta http-equiv="Content-Script-Type" content="text/javascript" />
<link rel="stylesheet" href="../../../.././rdoc-style.css" type="text/css" media="screen" />
<script type="text/javascript">
// <![CDATA[
function popupCode( url ) {
window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
}
function toggleCode( id ) {
if ( document.getElementById )
elem = document.getElementById( id );
else if ( document.all )
elem = eval( "document.all." + id );
else
return false;
elemStyle = elem.style;
if ( elemStyle.display != "block" ) {
elemStyle.display = "block"
} else {
elemStyle.display = "none"
}
return true;
}
// Make codeblocks hidden by default
document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
// ]]>
</script>
</head>
<body>
<div id="classHeader">
<table class="header-table">
<tr class="top-aligned-row">
<td><strong>Module</strong></td>
<td class="class-name-in-header">ActiveSupport::CoreExtensions::Time::Calculations</td>
</tr>
<tr class="top-aligned-row">
<td><strong>In:</strong></td>
<td>
<a href="../../../../files/vendor/rails/activesupport/lib/active_support/core_ext/time/calculations_rb.html">
vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb
</a>
<br />
</td>
</tr>
</table>
</div>
<!-- banner header -->
<div id="bodyContent">
<div id="contextContent">
<div id="description">
<p>
Enables the use of time calculations within Time itself
</p>
</div>
</div>
<div id="method-list">
<h3 class="section-bar">Methods</h3>
<div class="name-list">
<a href="#M000331">advance</a>
<a href="#M000332">ago</a>
<a href="#M000350">at_beginning_of_day</a>
<a href="#M000352">at_beginning_of_month</a>
<a href="#M000356">at_beginning_of_quarter</a>
<a href="#M000345">at_beginning_of_week</a>
<a href="#M000358">at_beginning_of_year</a>
<a href="#M000354">at_end_of_month</a>
<a href="#M000349">at_midnight</a>
<a href="#M000347">beginning_of_day</a>
<a href="#M000351">beginning_of_month</a>
<a href="#M000355">beginning_of_quarter</a>
<a href="#M000343">beginning_of_week</a>
<a href="#M000357">beginning_of_year</a>
<a href="#M000330">change</a>
<a href="#M000353">end_of_month</a>
<a href="#M000334">in</a>
<a href="#M000341">last_month</a>
<a href="#M000339">last_year</a>
<a href="#M000348">midnight</a>
<a href="#M000344">monday</a>
<a href="#M000335">months_ago</a>
<a href="#M000336">months_since</a>
<a href="#M000342">next_month</a>
<a href="#M000346">next_week</a>
<a href="#M000340">next_year</a>
<a href="#M000329">seconds_since_midnight</a>
<a href="#M000333">since</a>
<a href="#M000360">tomorrow</a>
<a href="#M000337">years_ago</a>
<a href="#M000338">years_since</a>
<a href="#M000359">yesterday</a>
</div>
</div>
</div>
<!-- if includes -->
<div id="section">
<div id="class-list">
<h3 class="section-bar">Classes and Modules</h3>
Module <a href="Calculations/ClassMethods.html" class="link">ActiveSupport::CoreExtensions::Time::Calculations::ClassMethods</a><br />
</div>
<!-- if method_list -->
<div id="methods">
<h3 class="section-bar">Public Instance methods</h3>
<div id="method-M000331" class="method-detail">
<a name="M000331"></a>
<div class="method-heading">
<a href="#M000331" class="method-signature">
<span class="method-name">advance</span><span class="method-args">(options)</span>
</a>
</div>
<div class="method-description">
<p>
Uses Date to provide precise Time calculations for years, months, and days.
The <tt>options</tt> parameter takes a hash with any of these keys:
:months, :days, :years.
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000331-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000331-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 49</span>
49: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">advance</span>(<span class="ruby-identifier">options</span>)
50: <span class="ruby-identifier">d</span> = <span class="ruby-operator">::</span><span class="ruby-constant">Date</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">year</span> <span class="ruby-operator">+</span> (<span class="ruby-identifier">options</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">:years</span>) <span class="ruby-operator">||</span> <span class="ruby-value">0</span>), <span class="ruby-identifier">month</span>, <span class="ruby-identifier">day</span>)
51: <span class="ruby-identifier">d</span> = <span class="ruby-identifier">d</span> <span class="ruby-operator">>></span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">:months</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:months</span>]
52: <span class="ruby-identifier">d</span> = <span class="ruby-identifier">d</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">:days</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:days</span>]
53: <span class="ruby-identifier">change</span>(<span class="ruby-identifier">options</span>.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">:year</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">d</span>.<span class="ruby-identifier">year</span>, <span class="ruby-identifier">:month</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">d</span>.<span class="ruby-identifier">month</span>, <span class="ruby-identifier">:mday</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">d</span>.<span class="ruby-identifier">day</span>))
54: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000332" class="method-detail">
<a name="M000332"></a>
<div class="method-heading">
<a href="#M000332" class="method-signature">
<span class="method-name">ago</span><span class="method-args">(seconds)</span>
</a>
</div>
<div class="method-description">
<p>
Returns a new Time representing the time a number of seconds <a
href="Calculations.html#M000332">ago</a>, this is basically a wrapper
around the Numeric extension Do not use this method <a
href="Calculations.html#M000334">in</a> combination with x.months, use <a
href="Calculations.html#M000335">months_ago</a> instead!
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000332-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000332-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 58</span>
58: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ago</span>(<span class="ruby-identifier">seconds</span>)
59: <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">since</span>(<span class="ruby-operator">-</span><span class="ruby-identifier">seconds</span>)
60: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000350" class="method-detail">
<a name="M000350"></a>
<div class="method-heading">
<span class="method-name">at_beginning_of_day</span><span class="method-args">()</span>
</div>
<div class="method-description">
<p>
Alias for <a href="Calculations.html#M000347">beginning_of_day</a>
</p>
</div>
</div>
<div id="method-M000352" class="method-detail">
<a name="M000352"></a>
<div class="method-heading">
<span class="method-name">at_beginning_of_month</span><span class="method-args">()</span>
</div>
<div class="method-description">
<p>
Alias for <a href="Calculations.html#M000351">beginning_of_month</a>
</p>
</div>
</div>
<div id="method-M000356" class="method-detail">
<a name="M000356"></a>
<div class="method-heading">
<span class="method-name">at_beginning_of_quarter</span><span class="method-args">()</span>
</div>
<div class="method-description">
<p>
Alias for <a href="Calculations.html#M000355">beginning_of_quarter</a>
</p>
</div>
</div>
<div id="method-M000345" class="method-detail">
<a name="M000345"></a>
<div class="method-heading">
<span class="method-name">at_beginning_of_week</span><span class="method-args">()</span>
</div>
<div class="method-description">
<p>
Alias for <a href="Calculations.html#M000343">beginning_of_week</a>
</p>
</div>
</div>
<div id="method-M000358" class="method-detail">
<a name="M000358"></a>
<div class="method-heading">
<span class="method-name">at_beginning_of_year</span><span class="method-args">()</span>
</div>
<div class="method-description">
<p>
Alias for <a href="Calculations.html#M000357">beginning_of_year</a>
</p>
</div>
</div>
<div id="method-M000354" class="method-detail">
<a name="M000354"></a>
<div class="method-heading">
<span class="method-name">at_end_of_month</span><span class="method-args">()</span>
</div>
<div class="method-description">
<p>
Alias for <a href="Calculations.html#M000353">end_of_month</a>
</p>
</div>
</div>
<div id="method-M000349" class="method-detail">
<a name="M000349"></a>
<div class="method-heading">
<span class="method-name">at_midnight</span><span class="method-args">()</span>
</div>
<div class="method-description">
<p>
Alias for <a href="Calculations.html#M000347">beginning_of_day</a>
</p>
</div>
</div>
<div id="method-M000347" class="method-detail">
<a name="M000347"></a>
<div class="method-heading">
<a href="#M000347" class="method-signature">
<span class="method-name">beginning_of_day</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
Returns a new Time representing the start of the day (0:00)
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000347-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000347-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 145</span>
145: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">beginning_of_day</span>
146: (<span class="ruby-keyword kw">self</span> <span class="ruby-operator">-</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">seconds_since_midnight</span>).<span class="ruby-identifier">change</span>(<span class="ruby-identifier">:usec</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>)
147: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000351" class="method-detail">
<a name="M000351"></a>
<div class="method-heading">
<a href="#M000351" class="method-signature">
<span class="method-name">beginning_of_month</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
Returns a new Time representing the start of the month (1st of the month,
0:00)
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000351-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000351-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 153</span>
153: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">beginning_of_month</span>
154: <span class="ruby-comment cmt">#self - ((self.mday-1).days + self.seconds_since_midnight)</span>
155: <span class="ruby-identifier">change</span>(<span class="ruby-identifier">:mday</span> =<span class="ruby-operator">></span> <span class="ruby-value">1</span>,<span class="ruby-identifier">:hour</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>, <span class="ruby-identifier">:min</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>, <span class="ruby-identifier">:sec</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>, <span class="ruby-identifier">:usec</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>)
156: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000355" class="method-detail">
<a name="M000355"></a>
<div class="method-heading">
<a href="#M000355" class="method-signature">
<span class="method-name">beginning_of_quarter</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
Returns a new Time representing the start of the quarter (1st of january,
april, july, october, 0:00)
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000355-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000355-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 168</span>
168: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">beginning_of_quarter</span>
169: <span class="ruby-identifier">beginning_of_month</span>.<span class="ruby-identifier">change</span>(<span class="ruby-identifier">:month</span> =<span class="ruby-operator">></span> [<span class="ruby-value">10</span>, <span class="ruby-value">7</span>, <span class="ruby-value">4</span>, <span class="ruby-value">1</span>].<span class="ruby-identifier">detect</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">m</span><span class="ruby-operator">|</span> <span class="ruby-identifier">m</span> <span class="ruby-operator"><=</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span> })
170: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000343" class="method-detail">
<a name="M000343"></a>
<div class="method-heading">
<a href="#M000343" class="method-signature">
<span class="method-name">beginning_of_week</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
Returns a new Time representing the "start" of this week (Monday,
0:00)
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000343-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000343-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 131</span>
131: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">beginning_of_week</span>
132: <span class="ruby-identifier">days_to_monday</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">wday!</span>=<span class="ruby-value">0</span> <span class="ruby-operator">?</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">wday</span><span class="ruby-operator">-</span><span class="ruby-value">1</span> <span class="ruby-operator">:</span> <span class="ruby-value">6</span>
133: (<span class="ruby-keyword kw">self</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">days_to_monday</span>.<span class="ruby-identifier">days</span>).<span class="ruby-identifier">midnight</span>
134: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000357" class="method-detail">
<a name="M000357"></a>
<div class="method-heading">
<a href="#M000357" class="method-signature">
<span class="method-name">beginning_of_year</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
Returns a new Time representing the start of the year (1st of january,
0:00)
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000357-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000357-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 174</span>
174: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">beginning_of_year</span>
175: <span class="ruby-identifier">change</span>(<span class="ruby-identifier">:month</span> =<span class="ruby-operator">></span> <span class="ruby-value">1</span>,<span class="ruby-identifier">:mday</span> =<span class="ruby-operator">></span> <span class="ruby-value">1</span>,<span class="ruby-identifier">:hour</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>, <span class="ruby-identifier">:min</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>, <span class="ruby-identifier">:sec</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>, <span class="ruby-identifier">:usec</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>)
176: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000330" class="method-detail">
<a name="M000330"></a>
<div class="method-heading">
<a href="#M000330" class="method-signature">
<span class="method-name">change</span><span class="method-args">(options)</span>
</a>
</div>
<div class="method-description">
<p>
Returns a new Time 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 set to 0. If the hour and minute is passed, then
sec and usec is set to 0.
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000330-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000330-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 34</span>
34: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">change</span>(<span class="ruby-identifier">options</span>)
35: <span class="ruby-operator">::</span><span class="ruby-constant">Time</span>.<span class="ruby-identifier">send</span>(
36: <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>,
37: <span class="ruby-identifier">options</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>,
38: <span class="ruby-identifier">options</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>,
39: <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:mday</span>] <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">mday</span>,
40: <span class="ruby-identifier">options</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>,
41: <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:min</span>] <span class="ruby-operator">||</span> (<span class="ruby-identifier">options</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>),
42: <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:sec</span>] <span class="ruby-operator">||</span> ((<span class="ruby-identifier">options</span>[<span class="ruby-identifier">:hour</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">options</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>),
43: <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:usec</span>] <span class="ruby-operator">||</span> ((<span class="ruby-identifier">options</span>[<span class="ruby-identifier">:hour</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:min</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">options</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>)
44: )
45: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000353" class="method-detail">
<a name="M000353"></a>
<div class="method-heading">
<a href="#M000353" class="method-signature">
<span class="method-name">end_of_month</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
Returns a new Time representing the end of the month (last day of the
month, 0:00)
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000353-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000353-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 160</span>
160: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">end_of_month</span>
161: <span class="ruby-comment cmt">#self - ((self.mday-1).days + self.seconds_since_midnight)</span>
162: <span class="ruby-identifier">last_day</span> = <span class="ruby-operator">::</span><span class="ruby-constant">Time</span>.<span class="ruby-identifier">days_in_month</span>( <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span>, <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">year</span> )
163: <span class="ruby-identifier">change</span>(<span class="ruby-identifier">:mday</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">last_day</span>,<span class="ruby-identifier">:hour</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>, <span class="ruby-identifier">:min</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>, <span class="ruby-identifier">:sec</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>, <span class="ruby-identifier">:usec</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>)
164: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000334" class="method-detail">
<a name="M000334"></a>
<div class="method-heading">
<span class="method-name">in</span><span class="method-args">(seconds)</span>
</div>
<div class="method-description">
<p>
Alias for <a href="Calculations.html#M000333">since</a>
</p>
</div>
</div>
<div id="method-M000341" class="method-detail">
<a name="M000341"></a>
<div class="method-heading">
<a href="#M000341" class="method-signature">
<span class="method-name">last_month</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
Short-hand for <a href="Calculations.html#M000335">months_ago</a>(1)
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000341-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000341-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 121</span>
121: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">last_month</span>
122: <span class="ruby-identifier">months_ago</span>(<span class="ruby-value">1</span>)
123: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000339" class="method-detail">
<a name="M000339"></a>
<div class="method-heading">
<a href="#M000339" class="method-signature">
<span class="method-name">last_year</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
Short-hand for <a href="Calculations.html#M000337">years_ago</a>(1)
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000339-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000339-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 110</span>
110: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">last_year</span>
111: <span class="ruby-identifier">years_ago</span>(<span class="ruby-value">1</span>)
112: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000348" class="method-detail">
<a name="M000348"></a>
<div class="method-heading">
<span class="method-name">midnight</span><span class="method-args">()</span>
</div>
<div class="method-description">
<p>
Alias for <a href="Calculations.html#M000347">beginning_of_day</a>
</p>
</div>
</div>
<div id="method-M000344" class="method-detail">
<a name="M000344"></a>
<div class="method-heading">
<span class="method-name">monday</span><span class="method-args">()</span>
</div>
<div class="method-description">
<p>
Alias for <a href="Calculations.html#M000343">beginning_of_week</a>
</p>
</div>
</div>
<div id="method-M000335" class="method-detail">
<a name="M000335"></a>
<div class="method-heading">
<a href="#M000335" class="method-signature">
<span class="method-name">months_ago</span><span class="method-args">(months)</span>
</a>
</div>
<div class="method-description">
<p>
Returns a new Time representing the time a number of specified months <a
href="Calculations.html#M000332">ago</a>
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000335-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000335-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 73</span>
73: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">months_ago</span>(<span class="ruby-identifier">months</span>)
74: <span class="ruby-identifier">months_since</span>(<span class="ruby-operator">-</span><span class="ruby-identifier">months</span>)
75: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000336" class="method-detail">
<a name="M000336"></a>
<div class="method-heading">
<a href="#M000336" class="method-signature">
<span class="method-name">months_since</span><span class="method-args">(months)</span>
</a>
</div>
<div class="method-description">
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000336-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000336-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 77</span>
77: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">months_since</span>(<span class="ruby-identifier">months</span>)
78: <span class="ruby-identifier">year</span>, <span class="ruby-identifier">month</span>, <span class="ruby-identifier">mday</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">year</span>, <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span>, <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">mday</span>
79:
80: <span class="ruby-identifier">month</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">months</span>
81:
82: <span class="ruby-comment cmt"># in case months is negative</span>
83: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">month</span> <span class="ruby-operator"><</span> <span class="ruby-value">1</span>
84: <span class="ruby-identifier">month</span> <span class="ruby-operator">+=</span> <span class="ruby-value">12</span>
85: <span class="ruby-identifier">year</span> <span class="ruby-operator">-=</span> <span class="ruby-value">1</span>
86: <span class="ruby-keyword kw">end</span>
87:
88: <span class="ruby-comment cmt"># in case months is positive</span>
89: <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">month</span> <span class="ruby-operator">></span> <span class="ruby-value">12</span>
90: <span class="ruby-identifier">month</span> <span class="ruby-operator">-=</span> <span class="ruby-value">12</span>
91: <span class="ruby-identifier">year</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
92: <span class="ruby-keyword kw">end</span>
93:
94: <span class="ruby-identifier">max</span> = <span class="ruby-operator">::</span><span class="ruby-constant">Time</span>.<span class="ruby-identifier">days_in_month</span>(<span class="ruby-identifier">month</span>, <span class="ruby-identifier">year</span>)
95: <span class="ruby-identifier">mday</span> = <span class="ruby-identifier">max</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">mday</span> <span class="ruby-operator">></span> <span class="ruby-identifier">max</span>
96:
97: <span class="ruby-identifier">change</span>(<span class="ruby-identifier">:year</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">year</span>, <span class="ruby-identifier">:month</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">month</span>, <span class="ruby-identifier">:mday</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">mday</span>)
98: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000342" class="method-detail">
<a name="M000342"></a>
<div class="method-heading">
<a href="#M000342" class="method-signature">
<span class="method-name">next_month</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
Short-hand for <a href="Calculations.html#M000336">months_since</a>(1)
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000342-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000342-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 126</span>
126: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">next_month</span>
127: <span class="ruby-identifier">months_since</span>(<span class="ruby-value">1</span>)
128: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000346" class="method-detail">
<a name="M000346"></a>
<div class="method-heading">
<a href="#M000346" class="method-signature">
<span class="method-name">next_week</span><span class="method-args">(day = :monday)</span>
</a>
</div>
<div class="method-description">
<p>
Returns a new Time representing the start of the given day <a
href="Calculations.html#M000334">in</a> next week (default is Monday).
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000346-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000346-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 139</span>
139: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">next_week</span>(<span class="ruby-identifier">day</span> = <span class="ruby-identifier">:monday</span>)
140: <span class="ruby-identifier">days_into_week</span> = { <span class="ruby-identifier">:monday</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>, <span class="ruby-identifier">:tuesday</span> =<span class="ruby-operator">></span> <span class="ruby-value">1</span>, <span class="ruby-identifier">:wednesday</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>, <span class="ruby-identifier">:thursday</span> =<span class="ruby-operator">></span> <span class="ruby-value">3</span>, <span class="ruby-identifier">:friday</span> =<span class="ruby-operator">></span> <span class="ruby-value">4</span>, <span class="ruby-identifier">:saturday</span> =<span class="ruby-operator">></span> <span class="ruby-value">5</span>, <span class="ruby-identifier">:sunday</span> =<span class="ruby-operator">></span> <span class="ruby-value">6</span>}
141: <span class="ruby-identifier">since</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">week</span>).<span class="ruby-identifier">beginning_of_week</span>.<span class="ruby-identifier">since</span>(<span class="ruby-identifier">days_into_week</span>[<span class="ruby-identifier">day</span>].<span class="ruby-identifier">day</span>).<span class="ruby-identifier">change</span>(<span class="ruby-identifier">:hour</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>)
142: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000340" class="method-detail">
<a name="M000340"></a>
<div class="method-heading">
<a href="#M000340" class="method-signature">
<span class="method-name">next_year</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
Short-hand for <a href="Calculations.html#M000338">years_since</a>(1)
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000340-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000340-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 115</span>
115: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">next_year</span>
116: <span class="ruby-identifier">years_since</span>(<span class="ruby-value">1</span>)
117: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000329" class="method-detail">
<a name="M000329"></a>
<div class="method-heading">
<a href="#M000329" class="method-signature">
<span class="method-name">seconds_since_midnight</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
Seconds <a href="Calculations.html#M000333">since</a> <a
href="Calculations.html#M000348">midnight</a>: Time.now.<a
href="Calculations.html#M000329">seconds_since_midnight</a>
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000329-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000329-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 27</span>
27: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">seconds_since_midnight</span>
28: <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">to_i</span> <span class="ruby-operator">-</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">change</span>(<span class="ruby-identifier">:hour</span> =<span class="ruby-operator">></span> <span class="ruby-value">0</span>).<span class="ruby-identifier">to_i</span> <span class="ruby-operator">+</span> (<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">usec</span><span class="ruby-operator">/</span><span class="ruby-value">1.0e+6</span>)
29: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000333" class="method-detail">
<a name="M000333"></a>
<div class="method-heading">
<a href="#M000333" class="method-signature">
<span class="method-name">since</span><span class="method-args">(seconds)</span>
</a>
</div>
<div class="method-description">
<pre>
Returns a new Time representing the time a number of seconds since the instance time, this is basically a wrapper around
</pre>
<p>
the Numeric extension. Do not use this method <a
href="Calculations.html#M000334">in</a> combination with x.months, use <a
href="Calculations.html#M000336">months_since</a> instead!
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000333-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000333-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 64</span>
64: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">since</span>(<span class="ruby-identifier">seconds</span>)
65: <span class="ruby-identifier">initial_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>
66: <span class="ruby-identifier">f</span> = <span class="ruby-identifier">seconds</span>.<span class="ruby-identifier">since</span>(<span class="ruby-keyword kw">self</span>)
67: <span class="ruby-identifier">final_dst</span> = <span class="ruby-identifier">f</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>
68: (<span class="ruby-identifier">seconds</span>.<span class="ruby-identifier">abs</span> <span class="ruby-operator">>=</span> <span class="ruby-value">86400</span> <span class="ruby-operator">&&</span> <span class="ruby-identifier">initial_dst</span> <span class="ruby-operator">!=</span> <span class="ruby-identifier">final_dst</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">f</span> <span class="ruby-operator">+</span> (<span class="ruby-identifier">initial_dst</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">final_dst</span>).<span class="ruby-identifier">hours</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">f</span>
69: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000360" class="method-detail">
<a name="M000360"></a>
<div class="method-heading">
<a href="#M000360" class="method-signature">
<span class="method-name">tomorrow</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
Convenience method which returns a new Time representing the time 1 day <a
href="Calculations.html#M000333">since</a> the instance time
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000360-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000360-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 185</span>
185: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">tomorrow</span>
186: <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">since</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">day</span>)
187: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000337" class="method-detail">
<a name="M000337"></a>
<div class="method-heading">
<a href="#M000337" class="method-signature">
<span class="method-name">years_ago</span><span class="method-args">(years)</span>
</a>
</div>
<div class="method-description">
<p>
Returns a new Time representing the time a number of specified years <a
href="Calculations.html#M000332">ago</a>
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000337-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000337-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 101</span>
101: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">years_ago</span>(<span class="ruby-identifier">years</span>)
102: <span class="ruby-identifier">change</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-operator">-</span> <span class="ruby-identifier">years</span>)
103: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000338" class="method-detail">
<a name="M000338"></a>
<div class="method-heading">
<a href="#M000338" class="method-signature">
<span class="method-name">years_since</span><span class="method-args">(years)</span>
</a>
</div>
<div class="method-description">
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000338-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000338-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 105</span>
105: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">years_since</span>(<span class="ruby-identifier">years</span>)
106: <span class="ruby-identifier">change</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-operator">+</span> <span class="ruby-identifier">years</span>)
107: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
<div id="method-M000359" class="method-detail">
<a name="M000359"></a>
<div class="method-heading">
<a href="#M000359" class="method-signature">
<span class="method-name">yesterday</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
Convenience method which returns a new Time representing the time 1 day <a
href="Calculations.html#M000332">ago</a>
</p>
<p><a class="source-toggle" href="#"
onclick="toggleCode('M000359-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000359-source">
<pre>
<span class="ruby-comment cmt"># File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 180</span>
180: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">yesterday</span>
181: <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">ago</span>(<span class="ruby-value">1</span>.<span class="ruby-identifier">day</span>)
182: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
</div>
</div>
<div id="validator-badges">
<p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
</div>
</body>
</html>