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

time_with_zone 0.3.0 → 0.3.1

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