mirror of
https://github.com/jimeh/time_ext.git
synced 2026-02-19 05:16:40 +00:00
2951 lines
84 KiB
HTML
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> »
|
|
|
|
|
|
<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 = {}, &block) </a>
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<span class="summary_desc"><div class='inline'><p>
|
|
Executes passed block for each “unit” of time specified, with a
|
|
new time object set to the beginning of “unit” 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 = {}, &block) </a>
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<span class="summary_desc"><div class='inline'><p>
|
|
Executes passed block for each “unit” 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 = {}, &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 = {}, &block) </a>
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<span class="summary_desc"><div class='inline'><p>
|
|
Executes passed block for each “unit” 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 = {}, &block) </a>
|
|
|
|
|
|
|
|
</span>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<span class="summary_desc"><div class='inline'><p>
|
|
Executes passed block for each “unit” 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, &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 = {}, &block)
|
|
|
|
|
|
|
|
</p><div class="docstring">
|
|
<div class="discussion">
|
|
<p>
|
|
Executes passed block for each “unit” of time specified, with a
|
|
new time object set to the beginning of “unit” 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'>&</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'>></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'>></span> <span class='true true kw'>true</span><span class='rparen token'>)</span><span class='comma token'>,</span> <span class='bitand op'>&</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'>></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'>></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'>></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'>></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'>></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'>></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'>"next_#{unit}"</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'>"beginning_of_#{unit}"</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'>></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'>></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'>></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'>></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'>></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'>></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'>></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 = {}, &block)
|
|
|
|
|
|
|
|
</p><div class="docstring">
|
|
<div class="discussion">
|
|
<p>
|
|
Executes passed block for each “unit” 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'>&</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'>></span> <span class='false false kw'>false</span><span class='rparen token'>)</span><span class='comma token'>,</span> <span class='bitand op'>&</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'>"end_of_#{unit}"</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'>></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'>></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'>></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'>></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'>></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'>></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'>"beginning_of_#{unit}"</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 = {}, &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'>&</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'>></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'>></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'>></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'>"#{parent_unit}s_since"</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'>"#{unit}s_since"</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'><</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'>"next_#{unit}"</span> <span class='colon op'>:</span> <span class='dstring node'>"prev_#{unit}"</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'>&&</span> <span class='time identifier id'>time</span> <span class='leq op'><=</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'>&&</span> <span class='time identifier id'>time</span> <span class='geq op'>>=</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'><<</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 = {}, &block)
|
|
|
|
|
|
|
|
</p><div class="docstring">
|
|
<div class="discussion">
|
|
<p>
|
|
Executes passed block for each “unit” 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
|
|
“unit”.
|
|
</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'>&</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'>></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'>></span> <span class='true true kw'>true</span><span class='rparen token'>)</span><span class='comma token'>,</span> <span class='bitand op'>&</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 = {}, &block)
|
|
|
|
|
|
|
|
</p><div class="docstring">
|
|
<div class="discussion">
|
|
<p>
|
|
Executes passed block for each “unit” 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'>&</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'>></span> <span class='true true kw'>true</span><span class='rparen token'>)</span><span class='comma token'>,</span> <span class='bitand op'>&</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'>"next_#{unit}"</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'>"prev_#{unit}"</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'>></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'><</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, &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'>&</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> |