RubyGems - time_with_zone - Versions diffs - 0.3.0 → 0.3.1 - Mend

time_with_zone 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +6 -0
data/README.md +48 -2
data/docs/TimeWithZone.html +278 -33
data/docs/_index.html +1 -1
data/docs/file.LICENSE.html +1 -1
data/docs/file.README.html +60 -3
data/docs/index.html +60 -3
data/docs/method_list.html +14 -2
data/docs/top-level-namespace.html +1 -1
data/lib/time_with_zone.rb +33 -1
data/lib/time_with_zone/version.rb +1 -1
metadata +1 -1

checksums.yaml CHANGED

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b7a1d893be0b23feef4936ea5dee2de6fa40a376
-  data.tar.gz: 72a694c5dc1538f73a7a16509860858dbfd028cc
+  metadata.gz: 5c88ea61d8793644919fa066f7e4041a1b053c42
+  data.tar.gz: 19d60b87e1c253bc59a92266949f0199305cc913
 SHA512:
-  metadata.gz: 42d2430505f2c2433b0d82430def19df46da362df2daff2771f5e1abd2db536e52551dab5f5187471d9427776ff3a4e87656292f0fe27d87f80dead6bd1c7e54
-  data.tar.gz: eaea6e110b6b65dfc60fb90a51d71cca987d0768f653c2b791b98ccb1d7627cfeb298d040a4a4252d20176d3680b732208b5c50e938ce2d87014a7e516d7db77
+  metadata.gz: 83a423700adeb24fd29cbcca995d2df2784305619cdf3c7a276fc9f1c50fe073fe6da6905291c70325e00110fb569659c311c9bec64745ce417acc1e08df2f97
+  data.tar.gz: 72fcc6e21b186b999e04913d8873f53c1e17a4ea576f359eb69741597483f38ac9ef1b00a4cce65c5e69eae47e3ac560539e9a4535c69743695f869a94c79d38

data/CHANGELOG.md CHANGED

@@ -1,3 +1,9 @@
+# 0.3.1 (2016-10-31)
+Enhancements:
+* Add strptime_with_zone_offset and parse_with_zone_offset
 # 0.3.0 (2016-10-31)
 Changes:

data/README.md CHANGED

@@ -1,6 +1,6 @@
 # TimeWithZone
-Handle time with zone without ActiveSupport or `ENV['TZ']` for thread-safety.
+Handle time with zone without ActiveSupport, or `ENV['TZ']` for thread-safety.
 ## Installation
@@ -20,7 +20,53 @@ Or install it yourself as:
 ## Usage
-See [docs](https://sonots.github.io/time_with_zone/TimeWithZone.html)
+Assume your localtime zone is `+09:00` (`Asia/Tokyo`):
+```ruby
+require 'time'
+Time.strptime('2015-01-01', '%Y-%m-%d')
+#=> 2015-01-01 00:00:00 +0900
+```
+But, you want to get time in `+08:00` (`Asia/Taipei`) as `2015-01-01 00:00:00 +0800`.
+If the timezone format is in numeric formats such as `[+-]HH:MM`, `[+-]HHMM`, `[+-]HH`, you may use `%z` of strptime:
+```ruby
+require 'time'
+date = '2015-01-01'
+timezone = '+08:00'
+Time.strptime("#{date} #{timezone}", '%Y-%m-%d %z')
+#=> 2015-01-01 00:00:00 +0800
+```
+However, if the timezone format is in the `Region/Zone` format such as `Asia/Taipei`, `%Z` or `%z` won't work. So, use `time_with_zone` gem as:
+```ruby
+require 'time_with_zone'
+TimeWithZone.strptime_with_zone('2015-01-01', '%Y-%m-%d', 'Asia/Taipei')
+#=> 2015-01-01 00:00:00 +0800
+```
+TimeWithZone gem accepts numeric formats, and the `Region/Zone` format, and some of short-abbreviations of timezone such as UTC.
+## Documents
+Available methods are:
+  * strptime_with_zone(str, format, timezone)
+  * parse_with_zone(str, timezone)
+  * set_zone(time, timezone)
+  * zone_offset(timezone, time = nil)
+  * strptime_with_zone_offset(str, format, zone_offset)
+  * parse_with_zone_offset(str, zone_offset)
+  * set_zone_offset(time, zone_offset)
+See [docs](https://sonots.github.io/time_with_zone/TimeWithZone.html) for details
 ## Development

data/docs/TimeWithZone.html CHANGED

@@ -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.1</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.3.0</span><span class='tstring_end'>&quot;</span></span></pre></dd>
     </dl>
@@ -280,6 +280,30 @@
 <p>Time.parse with timezone.</p>
 </div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#parse_with_zone_offset-class_method" title="parse_with_zone_offset (class method)">+ (Time) <strong>parse_with_zone_offset</strong>(date, zone_offset) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Time.parse with zone_offset.</p>
+</div></span>
 </li>
@@ -352,6 +376,30 @@
 <p>Time.strptime with timezone.</p>
 </div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#strptime_with_zone_offset-class_method" title="strptime_with_zone_offset (class method)">+ (Time) <strong>strptime_with_zone_offset</strong>(date, format, zone_offset) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Time.strptime with zone_offset.</p>
+</div></span>
 </li>
@@ -430,7 +478,7 @@
 <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-10-20 00:00:00 +00:00</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
-<span class='id identifier rubyid_time'>time</span><span class='period'>.</span><span class='id identifier rubyid_dup'>dup</span><span class='period'>.</span><span class='id identifier rubyid_localtime'>localtime</span><span class='lparen'>(</span><span class='const'>TimeWithZone</span><span class='period'>.</span><span class='id identifier rubyid_zone_offset'>zone_offset</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Asia/Taipei</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rparen'>)</span>
+<span class='id identifier rubyid_time'>time</span><span class='period'>.</span><span class='id identifier rubyid_dup'>dup</span><span class='period'>.</span><span class='id identifier rubyid_localtime'>localtime</span><span class='lparen'>(</span><span class='const'>TimeWithZone</span><span class='period'>.</span><span class='id identifier rubyid_zone_offset'>zone_offset</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Asia/Taipei</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_time'>time</span><span class='rparen'>)</span><span class='rparen'>)</span>
 <span class='comment'>#=&gt; 2010-10-20 08:00:00 +0800
 </span></code></pre>
@@ -722,6 +770,99 @@
     </td>
   </tr>
 </table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="parse_with_zone_offset-class_method">
+    + (<tt>Time</tt>) <strong>parse_with_zone_offset</strong>(date, zone_offset)
+</h3><div class="docstring">
+  <div class="discussion">
+<p>Time.parse with zone_offset</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='const'>TimeWithZone</span><span class='period'>.</span><span class='id identifier rubyid_parse_with_zone_offset'>parse_with_zone_offset</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>2016-10-20</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='int'>28800</span><span class='rparen'>)</span>
+<span class='comment'>#=&gt; 2016-10-20 00:00:00 +0800
+</span></code></pre>
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+    <li>
+        <span class='name'>date</span>
+        <span class='type'>(<tt>String</tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>string to be parsed</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>zone_offset</span>
+        <span class='type'>(<tt>Integer</tt>)</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>
+    <td>
+      <pre class="lines">
+126
+127
+128
+129</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 126</span>
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_parse_with_zone_offset'>parse_with_zone_offset</span><span class='lparen'>(</span><span class='id identifier rubyid_date'>date</span><span class='comma'>,</span> <span class='id identifier rubyid_zone_offset'>zone_offset</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>
+  <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='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
       <div class="method_details ">
@@ -797,12 +938,12 @@
       <pre class="lines">
-161
-162
-163</pre>
+193
+194
+195</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 161</span>
+      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 193</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>
@@ -885,12 +1026,12 @@
       <pre class="lines">
-177
-178
-179</pre>
+209
+210
+211</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 177</span>
+      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 209</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>
@@ -1009,13 +1150,13 @@
       <pre class="lines">
-144
-145
-146
-147</pre>
+160
+161
+162
+163</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 144</span>
+      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 160</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>
@@ -1024,6 +1165,110 @@
     </td>
   </tr>
 </table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="strptime_with_zone_offset-class_method">
+    + (<tt>Time</tt>) <strong>strptime_with_zone_offset</strong>(date, format, zone_offset)
+</h3><div class="docstring">
+  <div class="discussion">
+<p>Time.strptime with zone_offset</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='const'>TimeWithZone</span><span class='period'>.</span><span class='id identifier rubyid_strptime_with_zone_offset'>strptime_with_zone_offset</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>2016-10-20</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>%Y-%m-%d</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='int'>28800</span><span class='rparen'>)</span>
+<span class='comment'>#=&gt; 2016-10-20 00:00:00 +0800
+</span></code></pre>
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+    <li>
+        <span class='name'>date</span>
+        <span class='type'>(<tt>String</tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>string to be parsed</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>format</span>
+        <span class='type'>(<tt>String</tt>)</span>
+    </li>
+    <li>
+        <span class='name'>zone_offset</span>
+        <span class='type'>(<tt>Integer</tt>)</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>
+    <td>
+      <pre class="lines">
+176
+177
+178
+179</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 176</span>
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_strptime_with_zone_offset'>strptime_with_zone_offset</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_zone_offset'>zone_offset</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>
+  <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='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
       <div class="method_details ">
@@ -1124,25 +1369,25 @@
       <pre class="lines">
-201
-202
-203
-204
-205
-206
-207
-208
-209
-210
-211
-212
-213
-214
-215
-216</pre>
+233
+234
+235
+236
+237
+238
+239
+240
+241
+242
+243
+244
+245
+246
+247
+248</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 201</span>
+      <pre class="code"><span class="info file"># File 'lib/time_with_zone.rb', line 233</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>
@@ -1170,7 +1415,7 @@
 </div>
     <div id="footer">
-  Generated on Mon Oct 31 19:57:03 2016 by
+  Generated on Mon Oct 31 21:29:32 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 CHANGED

@@ -104,7 +104,7 @@
 </div>
     <div id="footer">
-  Generated on Mon Oct 31 19:57:03 2016 by
+  Generated on Mon Oct 31 21:29:31 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 CHANGED

@@ -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 19:57:03 2016 by
+  Generated on Mon Oct 31 21:29:31 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 CHANGED

@@ -64,7 +64,7 @@
     <div id="content"><div id='filecontents'>
 <h1 id="label-TimeWithZone">TimeWithZone</h1>
-<p>Handle time with zone without ActiveSupport or <code>ENV['TZ']</code> for
+<p>Handle time with zone without ActiveSupport, or <code>ENV['TZ']</code> for
 thread-safety.</p>
 <h2 id="label-Installation">Installation</h2>
@@ -84,8 +84,65 @@ thread-safety.</p>
 <h2 id="label-Usage">Usage</h2>
+<p>Assume your localtime zone is <code>+09:00</code>
+(<code>Asia/Tokyo</code>):</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</span><span class='tstring_end'>&#39;</span></span>
+<span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_strptime'>strptime</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>2015-01-01</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%Y-%m-%d</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+<span class='comment'>#=&gt; 2015-01-01 00:00:00 +0900
+</span></code></pre>
+<p>But, you want to get time in <code>+08:00</code> (<code>Asia/Taipei</code>)
+as <code>2015-01-01 00:00:00 +0800</code>.</p>
+<p>If the timezone format is in numeric formats such as
+<code>[+-]HH:MM</code>, <code>[+-]HHMM</code>, <code>[+-]HH</code>, you may
+use <code>%z</code> of strptime:</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</span><span class='tstring_end'>&#39;</span></span>
+<span class='id identifier rubyid_date'>date</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>2015-01-01</span><span class='tstring_end'>&#39;</span></span>
+<span class='id identifier rubyid_timezone'>timezone</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>+08:00</span><span class='tstring_end'>&#39;</span></span>
+<span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_strptime'>strptime</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_date'>date</span><span class='embexpr_end'>}</span><span class='tstring_content'> </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_timezone'>timezone</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%Y-%m-%d %z</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+<span class='comment'>#=&gt; 2015-01-01 00:00:00 +0800
+</span></code></pre>
+<p>However, if the timezone format is in the <code>Region/Zone</code> format
+such as <code>Asia/Taipei</code>, <code>%Z</code> or <code>%z</code>
+won&#39;t work. So, use <code>time_with_zone</code> gem as:</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='const'>TimeWithZone</span><span class='period'>.</span><span class='id identifier rubyid_strptime_with_zone'>strptime_with_zone</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>2015-01-01</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%Y-%m-%d</span><span class='tstring_end'>&#39;</span></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; 2015-01-01 00:00:00 +0800
+</span></code></pre>
+<p>TimeWithZone gem accepts numeric formats, and the <code>Region/Zone</code>
+format, and some of short-abbreviations of timezone such as UTC.</p>
+<h2 id="label-Documents">Documents</h2>
+<p>Available methods are:</p>
+<ul><li>
+<p>strptime_with_zone(str, format, timezone)</p>
+</li><li>
+<p>parse_with_zone(str, timezone)</p>
+</li><li>
+<p>set_zone(time, timezone)</p>
+</li><li>
+<p>zone_offset(timezone, time = nil)</p>
+</li><li>
+<p>strptime_with_zone_offset(str, format, zone_offset)</p>
+</li><li>
+<p>parse_with_zone_offset(str, zone_offset)</p>
+</li><li>
+<p>set_zone_offset(time, zone_offset)</p>
+</li></ul>
 <p>See <a
-href="https://sonots.github.io/time_with_zone/TimeWithZone.html">docs</a></p>
+href="https://sonots.github.io/time_with_zone/TimeWithZone.html">docs</a>
+for details</p>
 <h2 id="label-Development">Development</h2>
@@ -124,7 +181,7 @@ href="http://opensource.org/licenses/MIT">MIT License</a>.</p>
 </div></div>
     <div id="footer">
-  Generated on Mon Oct 31 19:57:03 2016 by
+  Generated on Mon Oct 31 21:29:31 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 CHANGED

@@ -64,7 +64,7 @@
     <div id="content"><div id='filecontents'>
 <h1 id="label-TimeWithZone">TimeWithZone</h1>
-<p>Handle time with zone without ActiveSupport or <code>ENV['TZ']</code> for
+<p>Handle time with zone without ActiveSupport, or <code>ENV['TZ']</code> for
 thread-safety.</p>
 <h2 id="label-Installation">Installation</h2>
@@ -84,8 +84,65 @@ thread-safety.</p>
 <h2 id="label-Usage">Usage</h2>
+<p>Assume your localtime zone is <code>+09:00</code>
+(<code>Asia/Tokyo</code>):</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</span><span class='tstring_end'>&#39;</span></span>
+<span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_strptime'>strptime</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>2015-01-01</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%Y-%m-%d</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+<span class='comment'>#=&gt; 2015-01-01 00:00:00 +0900
+</span></code></pre>
+<p>But, you want to get time in <code>+08:00</code> (<code>Asia/Taipei</code>)
+as <code>2015-01-01 00:00:00 +0800</code>.</p>
+<p>If the timezone format is in numeric formats such as
+<code>[+-]HH:MM</code>, <code>[+-]HHMM</code>, <code>[+-]HH</code>, you may
+use <code>%z</code> of strptime:</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</span><span class='tstring_end'>&#39;</span></span>
+<span class='id identifier rubyid_date'>date</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>2015-01-01</span><span class='tstring_end'>&#39;</span></span>
+<span class='id identifier rubyid_timezone'>timezone</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>+08:00</span><span class='tstring_end'>&#39;</span></span>
+<span class='const'>Time</span><span class='period'>.</span><span class='id identifier rubyid_strptime'>strptime</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_date'>date</span><span class='embexpr_end'>}</span><span class='tstring_content'> </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_timezone'>timezone</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%Y-%m-%d %z</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+<span class='comment'>#=&gt; 2015-01-01 00:00:00 +0800
+</span></code></pre>
+<p>However, if the timezone format is in the <code>Region/Zone</code> format
+such as <code>Asia/Taipei</code>, <code>%Z</code> or <code>%z</code>
+won&#39;t work. So, use <code>time_with_zone</code> gem as:</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='const'>TimeWithZone</span><span class='period'>.</span><span class='id identifier rubyid_strptime_with_zone'>strptime_with_zone</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>2015-01-01</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%Y-%m-%d</span><span class='tstring_end'>&#39;</span></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; 2015-01-01 00:00:00 +0800
+</span></code></pre>
+<p>TimeWithZone gem accepts numeric formats, and the <code>Region/Zone</code>
+format, and some of short-abbreviations of timezone such as UTC.</p>
+<h2 id="label-Documents">Documents</h2>
+<p>Available methods are:</p>
+<ul><li>
+<p>strptime_with_zone(str, format, timezone)</p>
+</li><li>
+<p>parse_with_zone(str, timezone)</p>
+</li><li>
+<p>set_zone(time, timezone)</p>
+</li><li>
+<p>zone_offset(timezone, time = nil)</p>
+</li><li>
+<p>strptime_with_zone_offset(str, format, zone_offset)</p>
+</li><li>
+<p>parse_with_zone_offset(str, zone_offset)</p>
+</li><li>
+<p>set_zone_offset(time, zone_offset)</p>
+</li></ul>
 <p>See <a
-href="https://sonots.github.io/time_with_zone/TimeWithZone.html">docs</a></p>
+href="https://sonots.github.io/time_with_zone/TimeWithZone.html">docs</a>
+for details</p>
 <h2 id="label-Development">Development</h2>
@@ -124,7 +181,7 @@ href="http://opensource.org/licenses/MIT">MIT License</a>.</p>
 </div></div>
     <div id="footer">
-  Generated on Mon Oct 31 19:57:03 2016 by
+  Generated on Mon Oct 31 21:29:31 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 CHANGED

@@ -70,23 +70,35 @@
   <li class="r2 ">
-    <span class='object_link'><a href="TimeWithZone.html#set_zone-class_method" title="TimeWithZone.set_zone (method)">set_zone</a></span>
+    <span class='object_link'><a href="TimeWithZone.html#parse_with_zone_offset-class_method" title="TimeWithZone.parse_with_zone_offset (method)">parse_with_zone_offset</a></span>
     <small>TimeWithZone</small>
   </li>
   <li class="r1 ">
-    <span class='object_link'><a href="TimeWithZone.html#set_zone_offset-class_method" title="TimeWithZone.set_zone_offset (method)">set_zone_offset</a></span>
+    <span class='object_link'><a href="TimeWithZone.html#set_zone-class_method" title="TimeWithZone.set_zone (method)">set_zone</a></span>
     <small>TimeWithZone</small>
   </li>
   <li class="r2 ">
+    <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>
+  <li class="r1 ">
     <span class='object_link'><a href="TimeWithZone.html#strptime_with_zone-class_method" title="TimeWithZone.strptime_with_zone (method)">strptime_with_zone</a></span>
     <small>TimeWithZone</small>
   </li>
+  <li class="r2 ">
+    <span class='object_link'><a href="TimeWithZone.html#strptime_with_zone_offset-class_method" title="TimeWithZone.strptime_with_zone_offset (method)">strptime_with_zone_offset</a></span>
+    <small>TimeWithZone</small>
+  </li>
   <li class="r1 ">
     <span class='object_link'><a href="TimeWithZone.html#zone_offset-class_method" title="TimeWithZone.zone_offset (method)">zone_offset</a></span>
     <small>TimeWithZone</small>

data/docs/top-level-namespace.html CHANGED

@@ -103,7 +103,7 @@
 </div>
     <div id="footer">
-  Generated on Mon Oct 31 19:57:03 2016 by
+  Generated on Mon Oct 31 21:29:31 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 CHANGED

@@ -60,7 +60,7 @@ class TimeWithZone
   #      require 'time_with_zone'
   #      time = Time.parse("2016-10-20 00:00:00 +00:00")
   #
-  #      time.dup.localtime(TimeWithZone.zone_offset("Asia/Taipei"))
+  #      time.dup.localtime(TimeWithZone.zone_offset("Asia/Taipei", time))
   #      #=> 2010-10-20 08:00:00 +0800
   #
   # @param [Time] time object
@@ -113,6 +113,22 @@ class TimeWithZone
     set_zone!(time, timezone)
   end
+  # Time.parse with zone_offset
+  #
+  #      require 'time_with_zone'
+  #
+  #      TimeWithZone.parse_with_zone_offset("2016-10-20", 28800)
+  #      #=> 2016-10-20 00:00:00 +0800
+  #
+  # @param [String] date string to be parsed
+  # @param [Integer] zone_offset
+  # @return [Time]
+  def self.parse_with_zone_offset(date, zone_offset)
+    time = Time.parse(date)
+    set_zone_offset!(time, zone_offset)
+  end
   # Time.strptime with timezone
   #
   #      ENV['TZ'] = '+09:00' # Assume your local timezone is +09:00
@@ -146,6 +162,22 @@ class TimeWithZone
     set_zone!(time, timezone)
   end
+  # Time.strptime with zone_offset
+  #
+  #      require 'time_with_zone'
+  #
+  #      TimeWithZone.strptime_with_zone_offset("2016-10-20", "%Y-%m-%d", 28800)
+  #      #=> 2016-10-20 00:00:00 +0800
+  #
+  # @param [String] date string to be parsed
+  # @param [String] format
+  # @param [Integer] zone_offset
+  # @return [Time]
+  def self.strptime_with_zone_offset(date, format, zone_offset)
+    time = Time.strptime(date, format)
+    set_zone_offset!(time, zone_offset)
+  end
   # This method changes only the zone field of Time object
   #
   #     require 'time_with_zone'

data/lib/time_with_zone/version.rb CHANGED

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

metadata CHANGED

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