time_with_zone 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fd91409d0be8be98807e79978b9f780b66378169
-  data.tar.gz: 5eff3854aff0288ed5c53468284015e1ade975c4
+  metadata.gz: b7a1d893be0b23feef4936ea5dee2de6fa40a376
+  data.tar.gz: 72a694c5dc1538f73a7a16509860858dbfd028cc
 SHA512:
-  metadata.gz: 66304bd2be5721f7698854f4682de8b94aa54277562dd3f1a94494ca79deccf8e9888291ad7b5b708ca9ffe8c8592e6b5c720709b2bb2b592d91d1b8cb3e1ab7
-  data.tar.gz: 72a63b6d9fa9986f66d37787f6916b573a02d8d211ab2f6de41519d3a2441746cc1f6aeebe3fb6e9da4803ae1b8e71caa4ef5165492235e5e244780564bf969b
+  metadata.gz: 42d2430505f2c2433b0d82430def19df46da362df2daff2771f5e1abd2db536e52551dab5f5187471d9427776ff3a4e87656292f0fe27d87f80dead6bd1c7e54
+  data.tar.gz: eaea6e110b6b65dfc60fb90a51d71cca987d0768f653c2b791b98ccb1d7627cfeb298d040a4a4252d20176d3680b732208b5c50e938ce2d87014a7e516d7db77

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+# 0.3.0 (2016-10-31)
+
+Changes:
+
+* Make set_zone! and set_zone_offset! be private
+
 # 0.2.1 (2016-10-31)
 
 Enhancements:
@@ -6,7 +12,7 @@ Enhancements:
 
 # 0.2.0 (2016-10-31)
 
-Incompatibility changes:
+Changes:
 
 * Rename TimeWithZone.overwrite_zone to TimeWithZone.set_zone
 

data/docs/TimeWithZone.html

@@ -115,7 +115,7 @@
 <span class='comment'># =&gt; &#39;2016-10-10 00:00:00 +0800&#39;
 </span>
 <span class='id identifier rubyid_time'>time</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_parse'>parse</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>2016-10-10 00:00:00 +00:00</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
-<span class='const'>TimeWithZone</span><span class='period'>.</span><span class='id identifier rubyid_set_zone!'>set_zone!</span><span class='lparen'>(</span><span class='id identifier rubyid_time'>time</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Asia/Taipei</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+<span class='const'>TimeWithZone</span><span class='period'>.</span><span class='id identifier rubyid_set_zone'>set_zone</span><span class='lparen'>(</span><span class='id identifier rubyid_time'>time</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Asia/Taipei</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
 <span class='comment'># =&gt; &#39;2016-10-10 00:00:00 +0800&#39;
 </span>
 <span class='id identifier rubyid_time'>time</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_parse'>parse</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>2016-10-10 00:00:00 +00:00</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
@@ -192,7 +192,7 @@
         <dt id="VERSION-constant" class="">VERSION =
           
         </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>0.2.0</span><span class='tstring_end'>&quot;</span></span></pre></dd>
+        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>0.2.1</span><span class='tstring_end'>&quot;</span></span></pre></dd>
       
     </dl>
   
@@ -214,7 +214,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#localtime_with_zone-class_method" title="localtime_with_zone (class method)">+ (Object) <strong>localtime_with_zone</strong>(time, timezone) </a>
+      <a href="#localtime_with_zone-class_method" title="localtime_with_zone (class method)">+ (Time) <strong>localtime_with_zone</strong>(time, timezone) </a>
     
 
     
@@ -238,7 +238,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#localtime_with_zone%21-class_method" title="localtime_with_zone! (class method)">+ (Object) <strong>localtime_with_zone!</strong>(time, timezone) </a>
+      <a href="#localtime_with_zone%21-class_method" title="localtime_with_zone! (class method)">+ (Time) <strong>localtime_with_zone!</strong>(time, timezone) </a>
     
 
     
@@ -262,7 +262,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#parse_with_zone-class_method" title="parse_with_zone (class method)">+ (Object) <strong>parse_with_zone</strong>(date, timezone) </a>
+      <a href="#parse_with_zone-class_method" title="parse_with_zone (class method)">+ (Time) <strong>parse_with_zone</strong>(date, timezone) </a>
     
 
     
@@ -301,7 +301,7 @@
 
   
     <span class="summary_desc"><div class='inline'>
-<p>This method simply sets the zone field of Time object (non-destructive).</p>
+<p>This method changes only the zone field of Time object.</p>
 </div></span>
   
 </li>
@@ -310,7 +310,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#set_zone%21-class_method" title="set_zone! (class method)">+ (Object) <strong>set_zone!</strong>(time, timezone) </a>
+      <a href="#set_zone_offset-class_method" title="set_zone_offset (class method)">+ (Time) <strong>set_zone_offset</strong>(time, zone_offset) </a>
     
 
     
@@ -325,7 +325,7 @@
 
   
     <span class="summary_desc"><div class='inline'>
-<p>This method simply sets the zone field of Time object (destructive).</p>
+<p>This method changes only the zone offset field of Time object.</p>
 </div></span>
   
 </li>
@@ -334,7 +334,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#strptime_with_zone-class_method" title="strptime_with_zone (class method)">+ (Object) <strong>strptime_with_zone</strong>(date, format, timezone) </a>
+      <a href="#strptime_with_zone-class_method" title="strptime_with_zone (class method)">+ (Time) <strong>strptime_with_zone</strong>(date, format, timezone) </a>
     
 
     
@@ -391,7 +391,7 @@
       <div class="method_details first">
   <h3 class="signature first" id="localtime_with_zone-class_method">
   
-    + (<tt>Object</tt>) <strong>localtime_with_zone</strong>(time, timezone) 
+    + (<tt>Time</tt>) <strong>localtime_with_zone</strong>(time, timezone) 
   
 
   
@@ -473,10 +473,13 @@
       
     </li>
   
+</ul>
+
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
     <li>
       
-        <span class='name'></span>
-      
       
         <span class='type'>(<tt>Time</tt>)</span>
       
@@ -486,7 +489,6 @@
   
 </ul>
 
-
 </div><table class="source_code">
   <tr>
     <td>
@@ -511,7 +513,7 @@
       <div class="method_details ">
   <h3 class="signature " id="localtime_with_zone!-class_method">
   
-    + (<tt>Object</tt>) <strong>localtime_with_zone!</strong>(time, timezone) 
+    + (<tt>Time</tt>) <strong>localtime_with_zone!</strong>(time, timezone) 
   
 
   
@@ -563,6 +565,19 @@
   
 </ul>
 
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Time</tt>)</span>
+      
+      
+      
+    </li>
+  
+</ul>
 
   <p class="tag_title">See Also:</p>
   <ul class="see">
@@ -577,13 +592,13 @@
       <pre class="lines">
 
 
-78
 79
 80
-81</pre>
+81
+82</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 78</span>
+      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 79</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_localtime_with_zone!'>localtime_with_zone!</span><span class='lparen'>(</span><span class='id identifier rubyid_time'>time</span><span class='comma'>,</span> <span class='id identifier rubyid_timezone'>timezone</span><span class='rparen'>)</span>
   <span class='id identifier rubyid__zone_offset'>_zone_offset</span> <span class='op'>=</span> <span class='id identifier rubyid_zone_offset'>zone_offset</span><span class='lparen'>(</span><span class='id identifier rubyid_timezone'>timezone</span><span class='comma'>,</span> <span class='id identifier rubyid_time'>time</span><span class='rparen'>)</span>
@@ -597,7 +612,7 @@
       <div class="method_details ">
   <h3 class="signature " id="parse_with_zone-class_method">
   
-    + (<tt>Object</tt>) <strong>parse_with_zone</strong>(date, timezone) 
+    + (<tt>Time</tt>) <strong>parse_with_zone</strong>(date, timezone) 
   
 
   
@@ -672,6 +687,19 @@
   
 </ul>
 
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Time</tt>)</span>
+      
+      
+      
+    </li>
+  
+</ul>
 
 </div><table class="source_code">
   <tr>
@@ -679,13 +707,13 @@
       <pre class="lines">
 
 
-109
-110
 111
-112</pre>
+112
+113
+114</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 109</span>
+      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 111</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_parse_with_zone'>parse_with_zone</span><span class='lparen'>(</span><span class='id identifier rubyid_date'>date</span><span class='comma'>,</span> <span class='id identifier rubyid_timezone'>timezone</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_time'>time</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_parse'>parse</span><span class='lparen'>(</span><span class='id identifier rubyid_date'>date</span><span class='rparen'>)</span>
@@ -708,7 +736,7 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>This method simply sets the zone field of Time object (non-destructive)</p>
+<p>This method changes only the zone field of Time object</p>
 
 <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>time_with_zone</span><span class='tstring_end'>&#39;</span></span>
 
@@ -769,12 +797,12 @@
       <pre class="lines">
 
 
-158
-159
-160</pre>
+161
+162
+163</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 158</span>
+      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 161</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_set_zone'>set_zone</span><span class='lparen'>(</span><span class='id identifier rubyid_time'>time</span><span class='comma'>,</span> <span class='id identifier rubyid_timezone'>timezone</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_set_zone!'>set_zone!</span><span class='lparen'>(</span><span class='id identifier rubyid_time'>time</span><span class='period'>.</span><span class='id identifier rubyid_dup'>dup</span><span class='comma'>,</span> <span class='id identifier rubyid_timezone'>timezone</span><span class='rparen'>)</span>
@@ -785,9 +813,9 @@
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="set_zone!-class_method">
+  <h3 class="signature " id="set_zone_offset-class_method">
   
-    + (<tt>Object</tt>) <strong>set_zone!</strong>(time, timezone) 
+    + (<tt>Time</tt>) <strong>set_zone_offset</strong>(time, zone_offset) 
   
 
   
@@ -796,7 +824,15 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>This method simply sets the zone field of Time object (destructive)</p>
+<p>This method changes only the zone offset field of Time object</p>
+
+<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>time_with_zone</span><span class='tstring_end'>&#39;</span></span>
+<span class='id identifier rubyid_time'>time</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_parse'>parse</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>2016-02-02 00:00:00 +00:00</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
+
+<span class='const'>TimeWithZone</span><span class='period'>.</span><span class='id identifier rubyid_set_zone_offset'>set_zone_offset</span><span class='lparen'>(</span><span class='id identifier rubyid_time'>time</span><span class='comma'>,</span> <span class='int'>28800</span><span class='rparen'>)</span>
+<span class='comment'>#=&gt; &quot;2016-02-02 00:00:00 +0800&quot;
+</span><span class='comment'># Note that it is not &quot;2016-02-02 08:00:00 +0800&quot; like Time#localtime(zone_offset)
+</span></code></pre>
 
 
   </div>
@@ -818,10 +854,10 @@
   
     <li>
       
-        <span class='name'>timezone</span>
+        <span class='name'>zone_offset</span>
       
       
-        <span class='type'>(<tt>String</tt>)</span>
+        <span class='type'>(<tt>Integer</tt>)</span>
       
       
       
@@ -829,13 +865,19 @@
   
 </ul>
 
-
-  <p class="tag_title">See Also:</p>
-  <ul class="see">
-    
-      <li><span class='object_link'><a href="#set_zone-class_method" title="TimeWithZone.set_zone (method)">set_zone</a></span></li>
-    
-  </ul>
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Time</tt>)</span>
+      
+      
+      
+    </li>
+  
+</ul>
 
 </div><table class="source_code">
   <tr>
@@ -843,19 +885,15 @@
       <pre class="lines">
 
 
-167
-168
-169
-170
-171</pre>
+177
+178
+179</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 167</span>
+      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 177</span>
 
-<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_set_zone!'>set_zone!</span><span class='lparen'>(</span><span class='id identifier rubyid_time'>time</span><span class='comma'>,</span> <span class='id identifier rubyid_timezone'>timezone</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid__utc_offset'>_utc_offset</span> <span class='op'>=</span> <span class='id identifier rubyid_time'>time</span><span class='period'>.</span><span class='id identifier rubyid_utc_offset'>utc_offset</span>
-  <span class='id identifier rubyid__zone_offset'>_zone_offset</span> <span class='op'>=</span> <span class='id identifier rubyid_zone_offset'>zone_offset</span><span class='lparen'>(</span><span class='id identifier rubyid_timezone'>timezone</span><span class='comma'>,</span> <span class='id identifier rubyid_time'>time</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_time'>time</span><span class='period'>.</span><span class='id identifier rubyid_localtime'>localtime</span><span class='lparen'>(</span><span class='id identifier rubyid__zone_offset'>_zone_offset</span><span class='rparen'>)</span> <span class='op'>+</span> <span class='id identifier rubyid__utc_offset'>_utc_offset</span> <span class='op'>-</span> <span class='id identifier rubyid__zone_offset'>_zone_offset</span>
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_set_zone_offset'>set_zone_offset</span><span class='lparen'>(</span><span class='id identifier rubyid_time'>time</span><span class='comma'>,</span> <span class='id identifier rubyid_zone_offset'>zone_offset</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_set_zone_offset!'>set_zone_offset!</span><span class='lparen'>(</span><span class='id identifier rubyid_time'>time</span><span class='period'>.</span><span class='id identifier rubyid_dup'>dup</span><span class='comma'>,</span> <span class='id identifier rubyid_zone_offset'>zone_offset</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -865,7 +903,7 @@
       <div class="method_details ">
   <h3 class="signature " id="strptime_with_zone-class_method">
   
-    + (<tt>Object</tt>) <strong>strptime_with_zone</strong>(date, format, timezone) 
+    + (<tt>Time</tt>) <strong>strptime_with_zone</strong>(date, format, timezone) 
   
 
   
@@ -951,6 +989,19 @@
   
 </ul>
 
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Time</tt>)</span>
+      
+      
+      
+    </li>
+  
+</ul>
 
 </div><table class="source_code">
   <tr>
@@ -958,13 +1009,13 @@
       <pre class="lines">
 
 
-141
-142
-143
-144</pre>
+144
+145
+146
+147</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 141</span>
+      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 144</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_strptime_with_zone'>strptime_with_zone</span><span class='lparen'>(</span><span class='id identifier rubyid_date'>date</span><span class='comma'>,</span> <span class='id identifier rubyid_format'>format</span><span class='comma'>,</span> <span class='id identifier rubyid_timezone'>timezone</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_time'>time</span> <span class='op'>=</span> <span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_strptime'>strptime</span><span class='lparen'>(</span><span class='id identifier rubyid_date'>date</span><span class='comma'>,</span> <span class='id identifier rubyid_format'>format</span><span class='rparen'>)</span>
@@ -1073,14 +1124,6 @@
       <pre class="lines">
 
 
-193
-194
-195
-196
-197
-198
-199
-200
 201
 202
 203
@@ -1088,10 +1131,18 @@
 205
 206
 207
-208</pre>
+208
+209
+210
+211
+212
+213
+214
+215
+216</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 193</span>
+      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 201</span>
 
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_zone_offset'>zone_offset</span><span class='lparen'>(</span><span class='id identifier rubyid_timezone'>timezone</span><span class='comma'>,</span> <span class='id identifier rubyid_time'>time</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span>
   <span class='kw'>if</span> <span class='const'>NUMERIC_PATTERN</span> <span class='op'>===</span> <span class='id identifier rubyid_timezone'>timezone</span>
@@ -1119,7 +1170,7 @@
 </div>
 
     <div id="footer">
-  Generated on Mon Oct 31 12:59:31 2016 by
+  Generated on Mon Oct 31 19:57:03 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.3.0).
 </div>

data/docs/_index.html

@@ -104,7 +104,7 @@
 </div>
 
     <div id="footer">
-  Generated on Mon Oct 31 12:59:30 2016 by
+  Generated on Mon Oct 31 19:57:03 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.3.0).
 </div>

data/docs/file.LICENSE.html

@@ -64,7 +64,7 @@
     <div id="content"><div id='filecontents'>The MIT License (MIT)<br/><br/>Copyright (c) 2016 Naotoshi Seo<br/><br/>Permission is hereby granted, free of charge, to any person obtaining a copy<br/>of this software and associated documentation files (the &quot;Software&quot;), to deal<br/>in the Software without restriction, including without limitation the rights<br/>to use, copy, modify, merge, publish, distribute, sublicense, and/or sell<br/>copies of the Software, and to permit persons to whom the Software is<br/>furnished to do so, subject to the following conditions:<br/><br/>The above copyright notice and this permission notice shall be included in<br/>all copies or substantial portions of the Software.<br/><br/>THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR<br/>IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,<br/>FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE<br/>AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER<br/>LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,<br/>OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN<br/>THE SOFTWARE.</div></div>
 
     <div id="footer">
-  Generated on Mon Oct 31 12:59:31 2016 by
+  Generated on Mon Oct 31 19:57:03 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.3.0).
 </div>

data/docs/file.README.html

@@ -124,7 +124,7 @@ href="http://opensource.org/licenses/MIT">MIT License</a>.</p>
 </div></div>
 
     <div id="footer">
-  Generated on Mon Oct 31 12:59:31 2016 by
+  Generated on Mon Oct 31 19:57:03 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.3.0).
 </div>

data/docs/index.html

@@ -124,7 +124,7 @@ href="http://opensource.org/licenses/MIT">MIT License</a>.</p>
 </div></div>
 
     <div id="footer">
-  Generated on Mon Oct 31 12:59:31 2016 by
+  Generated on Mon Oct 31 19:57:03 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.3.0).
 </div>

data/docs/method_list.html

@@ -76,7 +76,7 @@
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="TimeWithZone.html#set_zone%21-class_method" title="TimeWithZone.set_zone! (method)">set_zone!</a></span>
+    <span class='object_link'><a href="TimeWithZone.html#set_zone_offset-class_method" title="TimeWithZone.set_zone_offset (method)">set_zone_offset</a></span>
     <small>TimeWithZone</small>
   </li>
   

data/docs/top-level-namespace.html

@@ -103,7 +103,7 @@
 </div>
 
     <div id="footer">
-  Generated on Mon Oct 31 12:59:31 2016 by
+  Generated on Mon Oct 31 19:57:03 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.3.0).
 </div>

data/lib/time_with_zone.rb

@@ -13,7 +13,7 @@ require 'tzinfo'
 #     # => '2016-10-10 00:00:00 +0800'
 #
 #     time = Time.parse('2016-10-10 00:00:00 +00:00')
-#     TimeWithZone.set_zone!(time, 'Asia/Taipei')
+#     TimeWithZone.set_zone(time, 'Asia/Taipei')
 #     # => '2016-10-10 00:00:00 +0800'
 #
 #     time = Time.parse('2016-10-10 00:00:00 +00:00')
@@ -65,7 +65,7 @@ class TimeWithZone
   #
   # @param [Time] time object
   # @param [String] timezone {NUMERIC_PATTERN} or {NAME_PATTERN} or {ZoneOffset}
-  # @param [Time]
+  # @return [Time]
   def self.localtime_with_zone(time, timezone)
     localtime_with_zone!(time.dup, timezone)
   end
@@ -74,6 +74,7 @@ class TimeWithZone
   #
   # @param [Time] time object
   # @param [String] timezone {NUMERIC_PATTERN} or {NAME_PATTERN} or {ZoneOffset}
+  # @return [Time]
   # @see localtime_with_zone
   def self.localtime_with_zone!(time, timezone)
     _zone_offset = zone_offset(timezone, time)
@@ -106,6 +107,7 @@ class TimeWithZone
   #
   # @param [String] date string to be parsed
   # @param [String] timezone {NUMERIC_PATTERN} or {NAME_PATTERN} or {ZoneOffset}
+  # @return [Time]
   def self.parse_with_zone(date, timezone)
     time = Time.parse(date)
     set_zone!(time, timezone)
@@ -138,12 +140,13 @@ class TimeWithZone
   # @param [String] date string to be parsed
   # @param [String] format
   # @param [String] timezone {NUMERIC_PATTERN} or {NAME_PATTERN} or {ZoneOffset}
+  # @return [Time]
   def self.strptime_with_zone(date, format, timezone)
     time = Time.strptime(date, format)
     set_zone!(time, timezone)
   end
 
-  # This method simply sets the zone field of Time object (non-destructive)
+  # This method changes only the zone field of Time object
   #
   #     require 'time_with_zone'
   #
@@ -159,16 +162,7 @@ class TimeWithZone
     set_zone!(time.dup, timezone)
   end
 
-  # This method simply sets the zone field of Time object (destructive)
-  #
-  # @param [Time] time
-  # @param [String] timezone
-  # @see set_zone
-  def self.set_zone!(time, timezone)
-    set_zone_offset!(time, zone_offset(timezone, time))
-  end
-
-  # This method simply sets the zone offset field of Time object (non-destructive)
+  # This method changes only the zone offset field of Time object
   #
   #     require 'time_with_zone'
   #     time = Time.parse("2016-02-02 00:00:00 +00:00")
@@ -184,16 +178,6 @@ class TimeWithZone
     set_zone_offset!(time.dup, zone_offset)
   end
 
-  # This method simply sets the zone offset field of Time object (destructive)
-  #
-  # @param [Time] time
-  # @param [Integer] zone_offset
-  # @see set_zone_offset
-  def self.set_zone_offset!(time, zone_offset)
-    utc_offset = time.utc_offset
-    time.localtime(zone_offset) + utc_offset - zone_offset
-  end
-
   # Returns zone offset for given timezone string
   #
   #     require 'time_with_zone'
@@ -230,4 +214,29 @@ class TimeWithZone
       raise ArgumentError, "timezone format is invalid: #{timezone}"
     end
   end
+
+  private
+
+  # This method changes only the zone field of Time object
+  #
+  # @param [Time] time
+  # @param [String] timezone
+  # @return [Time]
+  # @see set_zone
+  # @todo how to modify time object destructively?
+  def self.set_zone!(time, timezone)
+    set_zone_offset!(time, zone_offset(timezone, time))
+  end
+
+  # This method changes only the zone offset field of Time object
+  #
+  # @param [Time] time
+  # @param [Integer] zone_offset
+  # @return [Time]
+  # @see set_zone_offset
+  # @todo how to modify time object destructively?
+  def self.set_zone_offset!(time, zone_offset)
+    utc_offset = time.utc_offset
+    time.localtime(zone_offset) + utc_offset - zone_offset
+  end
 end

data/lib/time_with_zone/version.rb

@@ -1,3 +1,3 @@
 class TimeWithZone
-  VERSION = "0.2.1"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: time_with_zone
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - sonots