lazier 3.5.7 → 4.0.0
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.
- checksums.yaml +4 -4
- data/.travis-gemfile +5 -4
- data/.travis.yml +2 -2
- data/CHANGELOG.md +65 -8
- data/Gemfile +9 -8
- data/README.md +4 -0
- data/doc/Lazier.html +178 -110
- data/doc/Lazier/Boolean.html +7 -7
- data/doc/Lazier/Configuration.html +24 -50
- data/doc/Lazier/DateTime.html +50 -305
- data/doc/Lazier/DateTime/ClassMethods.html +116 -806
- data/doc/Lazier/Exceptions.html +2 -2
- data/doc/Lazier/Exceptions/Debug.html +1 -1
- data/doc/Lazier/Exceptions/MissingTranslation.html +18 -14
- data/doc/Lazier/Exceptions/TranslationExceptionHandler.html +213 -0
- data/doc/Lazier/Hash.html +19 -155
- data/doc/Lazier/I18n.html +1735 -230
- data/doc/Lazier/Math.html +1 -1
- data/doc/Lazier/Math/ClassMethods.html +13 -13
- data/doc/Lazier/Object.html +353 -339
- data/doc/Lazier/Pathname.html +4 -4
- data/doc/Lazier/Settings.html +150 -304
- data/doc/Lazier/String.html +39 -199
- data/doc/Lazier/TimeZone.html +244 -746
- data/doc/Lazier/TimeZone/ClassMethods.html +109 -127
- data/doc/Lazier/Version.html +4 -4
- data/doc/_index.html +15 -15
- data/doc/class_list.html +1 -1
- data/doc/file.README.html +5 -1
- data/doc/index.html +5 -1
- data/doc/method_list.html +97 -169
- data/doc/top-level-namespace.html +1 -1
- data/lazier.gemspec +9 -6
- data/lib/lazier.rb +41 -50
- data/lib/lazier/boolean.rb +0 -1
- data/lib/lazier/configuration.rb +26 -28
- data/lib/lazier/datetime.rb +33 -127
- data/lib/lazier/exceptions.rb +14 -6
- data/lib/lazier/hash.rb +7 -15
- data/lib/lazier/i18n.rb +130 -48
- data/lib/lazier/math.rb +6 -7
- data/lib/lazier/object.rb +79 -97
- data/lib/lazier/pathname.rb +0 -1
- data/lib/lazier/settings.rb +12 -25
- data/lib/lazier/string.rb +17 -38
- data/lib/lazier/timezone.rb +168 -164
- data/lib/lazier/version.rb +3 -4
- data/locales/en.yml +52 -51
- data/locales/it.yml +51 -50
- data/spec/coverage_helper.rb +0 -1
- data/spec/lazier/boolean_spec.rb +2 -3
- data/spec/lazier/configuration_spec.rb +3 -5
- data/spec/lazier/datetime_spec.rb +34 -95
- data/spec/lazier/exceptions_spec.rb +25 -0
- data/spec/lazier/hash_spec.rb +0 -21
- data/spec/lazier/i18n_spec.rb +135 -51
- data/spec/lazier/math_spec.rb +0 -1
- data/spec/lazier/object_spec.rb +105 -100
- data/spec/lazier/pathname_spec.rb +0 -1
- data/spec/lazier/settings_spec.rb +25 -28
- data/spec/lazier/string_spec.rb +7 -20
- data/spec/lazier/timezone_spec.rb +101 -87
- data/spec/lazier_spec.rb +25 -8
- data/spec/spec_helper.rb +3 -2
- metadata +15 -44
- data/doc/Lazier/Localizer.html +0 -545
- data/lib/lazier/localizer.rb +0 -41
- data/spec/lazier/localizer_spec.rb +0 -45
@@ -175,52 +175,6 @@
|
|
175
175
|
<span class="summary_desc"><div class='inline'><p>Returns the Easter (according to Gregorian calendar) date for the year.</p>
|
176
176
|
</div></span>
|
177
177
|
|
178
|
-
</li>
|
179
|
-
|
180
|
-
|
181
|
-
<li class="public ">
|
182
|
-
<span class="summary_signature">
|
183
|
-
|
184
|
-
<a href="#find_timezone-instance_method" title="#find_timezone (instance method)">- (TimeZone) <strong>find_timezone</strong>(name = true, dst_label = nil) </a>
|
185
|
-
|
186
|
-
|
187
|
-
|
188
|
-
</span>
|
189
|
-
|
190
|
-
|
191
|
-
|
192
|
-
|
193
|
-
|
194
|
-
|
195
|
-
|
196
|
-
|
197
|
-
|
198
|
-
<span class="summary_desc"><div class='inline'><p>Find a zone by its name.</p>
|
199
|
-
</div></span>
|
200
|
-
|
201
|
-
</li>
|
202
|
-
|
203
|
-
|
204
|
-
<li class="public ">
|
205
|
-
<span class="summary_signature">
|
206
|
-
|
207
|
-
<a href="#list_timezones-instance_method" title="#list_timezones (instance method)">- (Array) <strong>list_timezones</strong>(with_dst = true, dst_label = nil) </a>
|
208
|
-
|
209
|
-
|
210
|
-
|
211
|
-
</span>
|
212
|
-
|
213
|
-
|
214
|
-
|
215
|
-
|
216
|
-
|
217
|
-
|
218
|
-
|
219
|
-
|
220
|
-
|
221
|
-
<span class="summary_desc"><div class='inline'><p>Returns a list of names of all timezones.</p>
|
222
|
-
</div></span>
|
223
|
-
|
224
178
|
</li>
|
225
179
|
|
226
180
|
|
@@ -244,98 +198,6 @@
|
|
244
198
|
<span class="summary_desc"><div class='inline'><p>Returns strings representations of months.</p>
|
245
199
|
</div></span>
|
246
200
|
|
247
|
-
</li>
|
248
|
-
|
249
|
-
|
250
|
-
<li class="public ">
|
251
|
-
<span class="summary_signature">
|
252
|
-
|
253
|
-
<a href="#parameterize_zone-instance_method" title="#parameterize_zone (instance method)">- (String) <strong>parameterize_zone</strong>(tz, with_offset = true) </a>
|
254
|
-
|
255
|
-
|
256
|
-
|
257
|
-
</span>
|
258
|
-
|
259
|
-
|
260
|
-
|
261
|
-
|
262
|
-
|
263
|
-
|
264
|
-
|
265
|
-
|
266
|
-
|
267
|
-
<span class="summary_desc"><div class='inline'><p>Returns a string representation of a timezone.</p>
|
268
|
-
</div></span>
|
269
|
-
|
270
|
-
</li>
|
271
|
-
|
272
|
-
|
273
|
-
<li class="public ">
|
274
|
-
<span class="summary_signature">
|
275
|
-
|
276
|
-
<a href="#rationalize_offset-instance_method" title="#rationalize_offset (instance method)">- (Rational) <strong>rationalize_offset</strong>(offset) </a>
|
277
|
-
|
278
|
-
|
279
|
-
|
280
|
-
</span>
|
281
|
-
|
282
|
-
|
283
|
-
|
284
|
-
|
285
|
-
|
286
|
-
|
287
|
-
|
288
|
-
|
289
|
-
|
290
|
-
<span class="summary_desc"><div class='inline'><p>Returns an offset in rational value.</p>
|
291
|
-
</div></span>
|
292
|
-
|
293
|
-
</li>
|
294
|
-
|
295
|
-
|
296
|
-
<li class="public ">
|
297
|
-
<span class="summary_signature">
|
298
|
-
|
299
|
-
<a href="#timezones-instance_method" title="#timezones (instance method)">- (Array) <strong>timezones</strong> </a>
|
300
|
-
|
301
|
-
|
302
|
-
|
303
|
-
</span>
|
304
|
-
|
305
|
-
|
306
|
-
|
307
|
-
|
308
|
-
|
309
|
-
|
310
|
-
|
311
|
-
|
312
|
-
|
313
|
-
<span class="summary_desc"><div class='inline'><p>Returns all the availabe timezones.</p>
|
314
|
-
</div></span>
|
315
|
-
|
316
|
-
</li>
|
317
|
-
|
318
|
-
|
319
|
-
<li class="public ">
|
320
|
-
<span class="summary_signature">
|
321
|
-
|
322
|
-
<a href="#unparameterize_zone-instance_method" title="#unparameterize_zone (instance method)">- (String|TimeZone) <strong>unparameterize_zone</strong>(tz, as_string = false, dst_label = nil) </a>
|
323
|
-
|
324
|
-
|
325
|
-
|
326
|
-
</span>
|
327
|
-
|
328
|
-
|
329
|
-
|
330
|
-
|
331
|
-
|
332
|
-
|
333
|
-
|
334
|
-
|
335
|
-
|
336
|
-
<span class="summary_desc"><div class='inline'><p>Finds a parameterized timezone.</p>
|
337
|
-
</div></span>
|
338
|
-
|
339
201
|
</li>
|
340
202
|
|
341
203
|
|
@@ -346,8 +208,6 @@
|
|
346
208
|
|
347
209
|
|
348
210
|
|
349
|
-
(also: #is_valid?)
|
350
|
-
|
351
211
|
</span>
|
352
212
|
|
353
213
|
|
@@ -367,7 +227,7 @@
|
|
367
227
|
<li class="public ">
|
368
228
|
<span class="summary_signature">
|
369
229
|
|
370
|
-
<a href="#years-instance_method" title="#years (instance method)">- (Array) <strong>years</strong>(offset
|
230
|
+
<a href="#years-instance_method" title="#years (instance method)">- (Array) <strong>years</strong>(offset: 10, also_future: true, reference: nil, as_objects: false) </a>
|
371
231
|
|
372
232
|
|
373
233
|
|
@@ -464,12 +324,12 @@
|
|
464
324
|
<pre class="lines">
|
465
325
|
|
466
326
|
|
467
|
-
|
468
|
-
|
469
|
-
|
327
|
+
63
|
328
|
+
64
|
329
|
+
65</pre>
|
470
330
|
</td>
|
471
331
|
<td>
|
472
|
-
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line
|
332
|
+
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line 63</span>
|
473
333
|
|
474
334
|
<span class='kw'>def</span> <span class='id identifier rubyid_custom_format'>custom_format</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
|
475
335
|
<span class='op'>::</span><span class='const'>Lazier</span><span class='period'>.</span><span class='id identifier rubyid_settings'>settings</span><span class='period'>.</span><span class='id identifier rubyid_date_formats'>date_formats</span><span class='period'>.</span><span class='id identifier rubyid_fetch'>fetch</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_key'>key</span><span class='rparen'>)</span>
|
@@ -549,14 +409,14 @@
|
|
549
409
|
<pre class="lines">
|
550
410
|
|
551
411
|
|
412
|
+
18
|
552
413
|
19
|
553
414
|
20
|
554
415
|
21
|
555
|
-
22
|
556
|
-
23</pre>
|
416
|
+
22</pre>
|
557
417
|
</td>
|
558
418
|
<td>
|
559
|
-
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line
|
419
|
+
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line 18</span>
|
560
420
|
|
561
421
|
<span class='kw'>def</span> <span class='id identifier rubyid_days'>days</span><span class='lparen'>(</span><span class='id identifier rubyid_short'>short</span> <span class='op'>=</span> <span class='kw'>true</span><span class='rparen'>)</span>
|
562
422
|
<span class='op'>::</span><span class='const'>Lazier</span><span class='period'>.</span><span class='id identifier rubyid_settings'>settings</span><span class='period'>.</span><span class='id identifier rubyid_date_names'>date_names</span><span class='lbracket'>[</span><span class='id identifier rubyid_short'>short</span> <span class='op'>?</span> <span class='symbol'>:short_days</span> <span class='op'>:</span> <span class='symbol'>:long_days</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span><span class='period'>.</span><span class='id identifier rubyid_with_index'>with_index</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_label'>label</span><span class='comma'>,</span> <span class='id identifier rubyid_index'>index</span><span class='op'>|</span>
|
@@ -638,24 +498,24 @@
|
|
638
498
|
<pre class="lines">
|
639
499
|
|
640
500
|
|
641
|
-
|
642
|
-
|
643
|
-
|
644
|
-
|
645
|
-
|
646
|
-
|
647
|
-
|
648
|
-
|
649
|
-
|
650
|
-
|
651
|
-
|
652
|
-
|
501
|
+
85
|
502
|
+
86
|
503
|
+
87
|
504
|
+
88
|
505
|
+
89
|
506
|
+
90
|
507
|
+
91
|
508
|
+
92
|
509
|
+
93
|
510
|
+
94
|
511
|
+
95
|
512
|
+
96</pre>
|
653
513
|
</td>
|
654
514
|
<td>
|
655
|
-
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line
|
515
|
+
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line 85</span>
|
656
516
|
|
657
517
|
<span class='kw'>def</span> <span class='id identifier rubyid_easter'>easter</span><span class='lparen'>(</span><span class='id identifier rubyid_year'>year</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span>
|
658
|
-
<span class='id identifier rubyid_year'>year</span> <span class='op'>=</span> <span class='op'>::</span><span class='const'>Date</span><span class='period'>.</span><span class='id identifier rubyid_today'>today</span><span class='period'>.</span><span class='id identifier rubyid_year'>year</span> <span class='kw'>unless</span> <span class='id identifier rubyid_year'>year</span><span class='period'>.</span><span class='id identifier
|
518
|
+
<span class='id identifier rubyid_year'>year</span> <span class='op'>=</span> <span class='op'>::</span><span class='const'>Date</span><span class='period'>.</span><span class='id identifier rubyid_today'>today</span><span class='period'>.</span><span class='id identifier rubyid_year'>year</span> <span class='kw'>unless</span> <span class='id identifier rubyid_year'>year</span><span class='period'>.</span><span class='id identifier rubyid_integer?'>integer?</span>
|
659
519
|
|
660
520
|
<span class='comment'># Compute using Anonymous Gregorian Algorithm: http://en.wikipedia.org/wiki/Computus#Anonymous_Gregorian_algorithm
|
661
521
|
</span> <span class='id identifier rubyid_data'>data</span> <span class='op'>=</span> <span class='id identifier rubyid_easter_start'>easter_start</span><span class='lparen'>(</span><span class='id identifier rubyid_year'>year</span><span class='rparen'>)</span>
|
@@ -672,9 +532,9 @@
|
|
672
532
|
</div>
|
673
533
|
|
674
534
|
<div class="method_details ">
|
675
|
-
<h3 class="signature " id="
|
535
|
+
<h3 class="signature " id="months-instance_method">
|
676
536
|
|
677
|
-
- (<tt
|
537
|
+
- (<tt>Array</tt>) <strong>months</strong>(short = true)
|
678
538
|
|
679
539
|
|
680
540
|
|
@@ -682,7 +542,7 @@
|
|
682
542
|
|
683
543
|
</h3><div class="docstring">
|
684
544
|
<div class="discussion">
|
685
|
-
<p>
|
545
|
+
<p>Returns strings representations of months.</p>
|
686
546
|
|
687
547
|
|
688
548
|
</div>
|
@@ -693,34 +553,17 @@
|
|
693
553
|
|
694
554
|
<li>
|
695
555
|
|
696
|
-
<span class='name'>
|
556
|
+
<span class='name'>short</span>
|
697
557
|
|
698
558
|
|
699
|
-
<span class='type'>(<tt><span class='object_link'><a href="../
|
559
|
+
<span class='type'>(<tt><span class='object_link'><a href="../Boolean.html" title="Lazier::Boolean (module)">Boolean</a></span></tt>)</span>
|
700
560
|
|
701
561
|
|
702
562
|
<em class="default">(defaults to: <tt>true</tt>)</em>
|
703
563
|
|
704
564
|
|
705
565
|
—
|
706
|
-
<div class='inline'><p>
|
707
|
-
</div>
|
708
|
-
|
709
|
-
</li>
|
710
|
-
|
711
|
-
<li>
|
712
|
-
|
713
|
-
<span class='name'>dst_label</span>
|
714
|
-
|
715
|
-
|
716
|
-
<span class='type'>(<tt><span class='object_link'><a href="../String.html" title="Lazier::String (module)">String</a></span></tt>)</span>
|
717
|
-
|
718
|
-
|
719
|
-
<em class="default">(defaults to: <tt>nil</tt>)</em>
|
720
|
-
|
721
|
-
|
722
|
-
—
|
723
|
-
<div class='inline'><p>Label for the DST indication. Defaults to <code>(DST)</code>.</p>
|
566
|
+
<div class='inline'><p>If return the abbreviated representations.</p>
|
724
567
|
</div>
|
725
568
|
|
726
569
|
</li>
|
@@ -733,33 +576,44 @@
|
|
733
576
|
<li>
|
734
577
|
|
735
578
|
|
736
|
-
<span class='type'>(<tt
|
579
|
+
<span class='type'>(<tt>Array</tt>)</span>
|
737
580
|
|
738
581
|
|
739
582
|
|
740
583
|
—
|
741
|
-
<div class='inline'><p>
|
584
|
+
<div class='inline'><p>Return string representations of months.</p>
|
742
585
|
</div>
|
743
586
|
|
744
587
|
</li>
|
745
588
|
|
746
589
|
</ul>
|
747
590
|
|
591
|
+
<p class="tag_title">See Also:</p>
|
592
|
+
<ul class="see">
|
593
|
+
|
594
|
+
<li><span class='object_link'><a href="../Settings.html#setup_date_names-instance_method" title="Lazier::Settings#setup_date_names (method)">Settings#setup_date_names</a></span></li>
|
595
|
+
|
596
|
+
</ul>
|
597
|
+
|
748
598
|
</div><table class="source_code">
|
749
599
|
<tr>
|
750
600
|
<td>
|
751
601
|
<pre class="lines">
|
752
602
|
|
753
603
|
|
754
|
-
|
755
|
-
|
756
|
-
|
604
|
+
29
|
605
|
+
30
|
606
|
+
31
|
607
|
+
32
|
608
|
+
33</pre>
|
757
609
|
</td>
|
758
610
|
<td>
|
759
|
-
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line
|
611
|
+
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line 29</span>
|
760
612
|
|
761
|
-
<span class='kw'>def</span> <span class='id identifier
|
762
|
-
<span class='op'>::</span><span class='const'>
|
613
|
+
<span class='kw'>def</span> <span class='id identifier rubyid_months'>months</span><span class='lparen'>(</span><span class='id identifier rubyid_short'>short</span> <span class='op'>=</span> <span class='kw'>true</span><span class='rparen'>)</span>
|
614
|
+
<span class='op'>::</span><span class='const'>Lazier</span><span class='period'>.</span><span class='id identifier rubyid_settings'>settings</span><span class='period'>.</span><span class='id identifier rubyid_date_names'>date_names</span><span class='lbracket'>[</span><span class='id identifier rubyid_short'>short</span> <span class='op'>?</span> <span class='symbol'>:short_months</span> <span class='op'>:</span> <span class='symbol'>:long_months</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span><span class='period'>.</span><span class='id identifier rubyid_with_index'>with_index</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_label'>label</span><span class='comma'>,</span> <span class='id identifier rubyid_index'>index</span><span class='op'>|</span>
|
615
|
+
<span class='lbrace'>{</span><span class='label'>value:</span> <span class='lparen'>(</span><span class='id identifier rubyid_index'>index</span> <span class='op'>+</span> <span class='int'>1</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='period'>.</span><span class='id identifier rubyid_rjust'>rjust</span><span class='lparen'>(</span><span class='int'>2</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>0</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span><span class='comma'>,</span> <span class='label'>label:</span> <span class='id identifier rubyid_label'>label</span><span class='rbrace'>}</span>
|
616
|
+
<span class='rbrace'>}</span>
|
763
617
|
<span class='kw'>end</span></pre>
|
764
618
|
</td>
|
765
619
|
</tr>
|
@@ -767,9 +621,9 @@
|
|
767
621
|
</div>
|
768
622
|
|
769
623
|
<div class="method_details ">
|
770
|
-
<h3 class="signature " id="
|
624
|
+
<h3 class="signature " id="valid?-instance_method">
|
771
625
|
|
772
|
-
- (<tt>
|
626
|
+
- (<tt><span class='object_link'><a href="../Boolean.html" title="Lazier::Boolean (module)">Boolean</a></span></tt>) <strong>valid?</strong>(value, format = "%F %T")
|
773
627
|
|
774
628
|
|
775
629
|
|
@@ -777,7 +631,7 @@
|
|
777
631
|
|
778
632
|
</h3><div class="docstring">
|
779
633
|
<div class="discussion">
|
780
|
-
<p>
|
634
|
+
<p>Checks if the date is valid against to a specific format.</p>
|
781
635
|
|
782
636
|
|
783
637
|
</div>
|
@@ -788,34 +642,32 @@
|
|
788
642
|
|
789
643
|
<li>
|
790
644
|
|
791
|
-
<span class='name'>
|
792
|
-
|
645
|
+
<span class='name'>value</span>
|
793
646
|
|
794
|
-
<span class='type'>(<tt><span class='object_link'><a href="../Boolean.html" title="Lazier::Boolean (module)">Boolean</a></span></tt>)</span>
|
795
647
|
|
648
|
+
<span class='type'>(<tt><span class='object_link'><a href="../String.html" title="Lazier::String (module)">String</a></span></tt>)</span>
|
796
649
|
|
797
|
-
<em class="default">(defaults to: <tt>true</tt>)</em>
|
798
650
|
|
799
651
|
|
800
652
|
—
|
801
|
-
<div class='inline'><p>
|
653
|
+
<div class='inline'><p>The value to check.</p>
|
802
654
|
</div>
|
803
655
|
|
804
656
|
</li>
|
805
657
|
|
806
658
|
<li>
|
807
659
|
|
808
|
-
<span class='name'>
|
660
|
+
<span class='name'>format</span>
|
809
661
|
|
810
662
|
|
811
663
|
<span class='type'>(<tt><span class='object_link'><a href="../String.html" title="Lazier::String (module)">String</a></span></tt>)</span>
|
812
664
|
|
813
665
|
|
814
|
-
<em class="default">(defaults to: <tt
|
666
|
+
<em class="default">(defaults to: <tt>"%F %T"</tt>)</em>
|
815
667
|
|
816
668
|
|
817
669
|
—
|
818
|
-
<div class='inline'><p>
|
670
|
+
<div class='inline'><p>The format to check the value against.</p>
|
819
671
|
</div>
|
820
672
|
|
821
673
|
</li>
|
@@ -828,33 +680,46 @@
|
|
828
680
|
<li>
|
829
681
|
|
830
682
|
|
831
|
-
<span class='type'>(<tt>
|
683
|
+
<span class='type'>(<tt><span class='object_link'><a href="../Boolean.html" title="Lazier::Boolean (module)">Boolean</a></span></tt>)</span>
|
832
684
|
|
833
685
|
|
834
686
|
|
835
687
|
—
|
836
|
-
<div class='inline'><p>
|
688
|
+
<div class='inline'><p><code>true</code> if the value is valid against the format, <code>false</code> otherwise.</p>
|
837
689
|
</div>
|
838
690
|
|
839
691
|
</li>
|
840
692
|
|
841
693
|
</ul>
|
842
694
|
|
695
|
+
<p class="tag_title">See Also:</p>
|
696
|
+
<ul class="see">
|
697
|
+
|
698
|
+
<li>DateTime#custom_format</li>
|
699
|
+
|
700
|
+
</ul>
|
701
|
+
|
843
702
|
</div><table class="source_code">
|
844
703
|
<tr>
|
845
704
|
<td>
|
846
705
|
<pre class="lines">
|
847
706
|
|
848
707
|
|
849
|
-
|
850
|
-
|
851
|
-
|
708
|
+
73
|
709
|
+
74
|
710
|
+
75
|
711
|
+
76
|
712
|
+
77
|
713
|
+
78</pre>
|
852
714
|
</td>
|
853
715
|
<td>
|
854
|
-
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line
|
716
|
+
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line 73</span>
|
855
717
|
|
856
|
-
<span class='kw'>def</span> <span class='id identifier
|
857
|
-
<span class='op'>::</span><span class='const'>
|
718
|
+
<span class='kw'>def</span> <span class='id identifier rubyid_valid?'>valid?</span><span class='lparen'>(</span><span class='id identifier rubyid_value'>value</span><span class='comma'>,</span> <span class='id identifier rubyid_format'>format</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>%F %T</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span>
|
719
|
+
<span class='op'>::</span><span class='const'>DateTime</span><span class='period'>.</span><span class='id identifier rubyid_strptime'>strptime</span><span class='lparen'>(</span><span class='id identifier rubyid_value'>value</span><span class='comma'>,</span> <span class='id identifier rubyid_custom_format'>custom_format</span><span class='lparen'>(</span><span class='id identifier rubyid_format'>format</span><span class='rparen'>)</span><span class='rparen'>)</span>
|
720
|
+
<span class='kw'>true</span>
|
721
|
+
<span class='kw'>rescue</span>
|
722
|
+
<span class='kw'>false</span>
|
858
723
|
<span class='kw'>end</span></pre>
|
859
724
|
</td>
|
860
725
|
</tr>
|
@@ -862,9 +727,9 @@
|
|
862
727
|
</div>
|
863
728
|
|
864
729
|
<div class="method_details ">
|
865
|
-
<h3 class="signature " id="
|
730
|
+
<h3 class="signature " id="years-instance_method">
|
866
731
|
|
867
|
-
- (<tt>Array</tt>) <strong>
|
732
|
+
- (<tt>Array</tt>) <strong>years</strong>(offset: 10, also_future: true, reference: nil, as_objects: false)
|
868
733
|
|
869
734
|
|
870
735
|
|
@@ -872,7 +737,17 @@
|
|
872
737
|
|
873
738
|
</h3><div class="docstring">
|
874
739
|
<div class="discussion">
|
875
|
-
<p>Returns
|
740
|
+
<p>Returns a range of years.</p>
|
741
|
+
|
742
|
+
<p><code>ruby
|
743
|
+
Date.years(3, false, 2010)
|
744
|
+
# => [2007, 2008, 2009, 2010]
|
745
|
+
</code></p>
|
746
|
+
|
747
|
+
<p><code>ruby
|
748
|
+
Date.years(1, true, 2010, true)
|
749
|
+
# => [{:value=>2009, :label=>2009}, {:value=>2010, :label=>2010}, {:value=>2011, :label=>2011}]
|
750
|
+
</code></p>
|
876
751
|
|
877
752
|
|
878
753
|
</div>
|
@@ -883,608 +758,45 @@
|
|
883
758
|
|
884
759
|
<li>
|
885
760
|
|
886
|
-
<span class='name'>
|
887
|
-
|
761
|
+
<span class='name'>offset</span>
|
888
762
|
|
889
|
-
<span class='type'>(<tt><span class='object_link'><a href="../Boolean.html" title="Lazier::Boolean (module)">Boolean</a></span></tt>)</span>
|
890
763
|
|
764
|
+
<span class='type'>(<tt>Fixnum</tt>)</span>
|
891
765
|
|
892
|
-
<em class="default">(defaults to: <tt>true</tt>)</em>
|
893
766
|
|
894
767
|
|
895
768
|
—
|
896
|
-
<div class='inline'><p>
|
769
|
+
<div class='inline'><p>The width of the range.</p>
|
897
770
|
</div>
|
898
771
|
|
899
772
|
</li>
|
900
773
|
|
901
|
-
|
902
|
-
|
903
|
-
<
|
904
|
-
|
774
|
+
<li>
|
775
|
+
|
776
|
+
<span class='name'>also_future</span>
|
777
|
+
|
778
|
+
|
779
|
+
<span class='type'>(<tt><span class='object_link'><a href="../Boolean.html" title="Lazier::Boolean (module)">Boolean</a></span></tt>)</span>
|
780
|
+
|
781
|
+
|
782
|
+
|
783
|
+
—
|
784
|
+
<div class='inline'><p>If return also future years.</p>
|
785
|
+
</div>
|
786
|
+
|
787
|
+
</li>
|
905
788
|
|
906
789
|
<li>
|
907
790
|
|
791
|
+
<span class='name'>reference</span>
|
792
|
+
|
908
793
|
|
909
|
-
<span class='type'>(<tt>
|
794
|
+
<span class='type'>(<tt>Fixnum</tt>)</span>
|
910
795
|
|
911
796
|
|
912
797
|
|
913
798
|
—
|
914
|
-
<div class='inline'><p>
|
915
|
-
</div>
|
916
|
-
|
917
|
-
</li>
|
918
|
-
|
919
|
-
</ul>
|
920
|
-
|
921
|
-
<p class="tag_title">See Also:</p>
|
922
|
-
<ul class="see">
|
923
|
-
|
924
|
-
<li><span class='object_link'><a href="../Settings.html#setup_date_names-instance_method" title="Lazier::Settings#setup_date_names (method)">Settings#setup_date_names</a></span></li>
|
925
|
-
|
926
|
-
</ul>
|
927
|
-
|
928
|
-
</div><table class="source_code">
|
929
|
-
<tr>
|
930
|
-
<td>
|
931
|
-
<pre class="lines">
|
932
|
-
|
933
|
-
|
934
|
-
30
|
935
|
-
31
|
936
|
-
32
|
937
|
-
33
|
938
|
-
34</pre>
|
939
|
-
</td>
|
940
|
-
<td>
|
941
|
-
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line 30</span>
|
942
|
-
|
943
|
-
<span class='kw'>def</span> <span class='id identifier rubyid_months'>months</span><span class='lparen'>(</span><span class='id identifier rubyid_short'>short</span> <span class='op'>=</span> <span class='kw'>true</span><span class='rparen'>)</span>
|
944
|
-
<span class='op'>::</span><span class='const'>Lazier</span><span class='period'>.</span><span class='id identifier rubyid_settings'>settings</span><span class='period'>.</span><span class='id identifier rubyid_date_names'>date_names</span><span class='lbracket'>[</span><span class='id identifier rubyid_short'>short</span> <span class='op'>?</span> <span class='symbol'>:short_months</span> <span class='op'>:</span> <span class='symbol'>:long_months</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span><span class='period'>.</span><span class='id identifier rubyid_with_index'>with_index</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_label'>label</span><span class='comma'>,</span> <span class='id identifier rubyid_index'>index</span><span class='op'>|</span>
|
945
|
-
<span class='lbrace'>{</span><span class='label'>value:</span> <span class='lparen'>(</span><span class='id identifier rubyid_index'>index</span> <span class='op'>+</span> <span class='int'>1</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='period'>.</span><span class='id identifier rubyid_rjust'>rjust</span><span class='lparen'>(</span><span class='int'>2</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>0</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span><span class='comma'>,</span> <span class='label'>label:</span> <span class='id identifier rubyid_label'>label</span><span class='rbrace'>}</span>
|
946
|
-
<span class='rbrace'>}</span>
|
947
|
-
<span class='kw'>end</span></pre>
|
948
|
-
</td>
|
949
|
-
</tr>
|
950
|
-
</table>
|
951
|
-
</div>
|
952
|
-
|
953
|
-
<div class="method_details ">
|
954
|
-
<h3 class="signature " id="parameterize_zone-instance_method">
|
955
|
-
|
956
|
-
- (<tt><span class='object_link'><a href="../String.html" title="Lazier::String (module)">String</a></span></tt>) <strong>parameterize_zone</strong>(tz, with_offset = true)
|
957
|
-
|
958
|
-
|
959
|
-
|
960
|
-
|
961
|
-
|
962
|
-
</h3><div class="docstring">
|
963
|
-
<div class="discussion">
|
964
|
-
<p>Returns a string representation of a timezone.</p>
|
965
|
-
|
966
|
-
<p><code>ruby
|
967
|
-
DateTime.parameterize_zone(ActiveSupport::TimeZone["Pacific Time (US & Canada)"])
|
968
|
-
# => "-0800@pacific-time-us-canada"
|
969
|
-
</code></p>
|
970
|
-
|
971
|
-
|
972
|
-
</div>
|
973
|
-
</div>
|
974
|
-
<div class="tags">
|
975
|
-
<p class="tag_title">Parameters:</p>
|
976
|
-
<ul class="param">
|
977
|
-
|
978
|
-
<li>
|
979
|
-
|
980
|
-
<span class='name'>tz</span>
|
981
|
-
|
982
|
-
|
983
|
-
<span class='type'>(<tt><span class='object_link'><a href="../TimeZone.html" title="Lazier::TimeZone (module)">TimeZone</a></span></tt>)</span>
|
984
|
-
|
985
|
-
|
986
|
-
|
987
|
-
—
|
988
|
-
<div class='inline'><p>The zone to represent.</p>
|
989
|
-
</div>
|
990
|
-
|
991
|
-
</li>
|
992
|
-
|
993
|
-
<li>
|
994
|
-
|
995
|
-
<span class='name'>with_offset</span>
|
996
|
-
|
997
|
-
|
998
|
-
<span class='type'>(<tt><span class='object_link'><a href="../Boolean.html" title="Lazier::Boolean (module)">Boolean</a></span></tt>)</span>
|
999
|
-
|
1000
|
-
|
1001
|
-
<em class="default">(defaults to: <tt>true</tt>)</em>
|
1002
|
-
|
1003
|
-
|
1004
|
-
—
|
1005
|
-
<div class='inline'><p>If to include offset into the representation.</p>
|
1006
|
-
</div>
|
1007
|
-
|
1008
|
-
</li>
|
1009
|
-
|
1010
|
-
</ul>
|
1011
|
-
|
1012
|
-
<p class="tag_title">Returns:</p>
|
1013
|
-
<ul class="return">
|
1014
|
-
|
1015
|
-
<li>
|
1016
|
-
|
1017
|
-
|
1018
|
-
<span class='type'>(<tt><span class='object_link'><a href="../String.html" title="Lazier::String (module)">String</a></span></tt>)</span>
|
1019
|
-
|
1020
|
-
|
1021
|
-
|
1022
|
-
—
|
1023
|
-
<div class='inline'><p>A string representation which can be used for searches.</p>
|
1024
|
-
</div>
|
1025
|
-
|
1026
|
-
</li>
|
1027
|
-
|
1028
|
-
</ul>
|
1029
|
-
|
1030
|
-
</div><table class="source_code">
|
1031
|
-
<tr>
|
1032
|
-
<td>
|
1033
|
-
<pre class="lines">
|
1034
|
-
|
1035
|
-
|
1036
|
-
93
|
1037
|
-
94
|
1038
|
-
95</pre>
|
1039
|
-
</td>
|
1040
|
-
<td>
|
1041
|
-
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line 93</span>
|
1042
|
-
|
1043
|
-
<span class='kw'>def</span> <span class='id identifier rubyid_parameterize_zone'>parameterize_zone</span><span class='lparen'>(</span><span class='id identifier rubyid_tz'>tz</span><span class='comma'>,</span> <span class='id identifier rubyid_with_offset'>with_offset</span> <span class='op'>=</span> <span class='kw'>true</span><span class='rparen'>)</span>
|
1044
|
-
<span class='op'>::</span><span class='const'>ActiveSupport</span><span class='op'>::</span><span class='const'>TimeZone</span><span class='period'>.</span><span class='id identifier rubyid_parameterize_zone'>parameterize_zone</span><span class='lparen'>(</span><span class='id identifier rubyid_tz'>tz</span><span class='comma'>,</span> <span class='id identifier rubyid_with_offset'>with_offset</span><span class='rparen'>)</span>
|
1045
|
-
<span class='kw'>end</span></pre>
|
1046
|
-
</td>
|
1047
|
-
</tr>
|
1048
|
-
</table>
|
1049
|
-
</div>
|
1050
|
-
|
1051
|
-
<div class="method_details ">
|
1052
|
-
<h3 class="signature " id="rationalize_offset-instance_method">
|
1053
|
-
|
1054
|
-
- (<tt>Rational</tt>) <strong>rationalize_offset</strong>(offset)
|
1055
|
-
|
1056
|
-
|
1057
|
-
|
1058
|
-
|
1059
|
-
|
1060
|
-
</h3><div class="docstring">
|
1061
|
-
<div class="discussion">
|
1062
|
-
<p>Returns an offset in rational value.</p>
|
1063
|
-
|
1064
|
-
|
1065
|
-
</div>
|
1066
|
-
</div>
|
1067
|
-
<div class="tags">
|
1068
|
-
<p class="tag_title">Parameters:</p>
|
1069
|
-
<ul class="param">
|
1070
|
-
|
1071
|
-
<li>
|
1072
|
-
|
1073
|
-
<span class='name'>offset</span>
|
1074
|
-
|
1075
|
-
|
1076
|
-
<span class='type'>(<tt>Fixnum</tt>)</span>
|
1077
|
-
|
1078
|
-
|
1079
|
-
|
1080
|
-
—
|
1081
|
-
<div class='inline'><p>The offset to convert.</p>
|
1082
|
-
</div>
|
1083
|
-
|
1084
|
-
</li>
|
1085
|
-
|
1086
|
-
</ul>
|
1087
|
-
|
1088
|
-
<p class="tag_title">Returns:</p>
|
1089
|
-
<ul class="return">
|
1090
|
-
|
1091
|
-
<li>
|
1092
|
-
|
1093
|
-
|
1094
|
-
<span class='type'>(<tt>Rational</tt>)</span>
|
1095
|
-
|
1096
|
-
|
1097
|
-
|
1098
|
-
—
|
1099
|
-
<div class='inline'><p>The converted offset.</p>
|
1100
|
-
</div>
|
1101
|
-
|
1102
|
-
</li>
|
1103
|
-
|
1104
|
-
</ul>
|
1105
|
-
|
1106
|
-
</div><table class="source_code">
|
1107
|
-
<tr>
|
1108
|
-
<td>
|
1109
|
-
<pre class="lines">
|
1110
|
-
|
1111
|
-
|
1112
|
-
112
|
1113
|
-
113
|
1114
|
-
114</pre>
|
1115
|
-
</td>
|
1116
|
-
<td>
|
1117
|
-
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line 112</span>
|
1118
|
-
|
1119
|
-
<span class='kw'>def</span> <span class='id identifier rubyid_rationalize_offset'>rationalize_offset</span><span class='lparen'>(</span><span class='id identifier rubyid_offset'>offset</span><span class='rparen'>)</span>
|
1120
|
-
<span class='op'>::</span><span class='const'>ActiveSupport</span><span class='op'>::</span><span class='const'>TimeZone</span><span class='period'>.</span><span class='id identifier rubyid_rationalize_offset'>rationalize_offset</span><span class='lparen'>(</span><span class='id identifier rubyid_offset'>offset</span><span class='rparen'>)</span>
|
1121
|
-
<span class='kw'>end</span></pre>
|
1122
|
-
</td>
|
1123
|
-
</tr>
|
1124
|
-
</table>
|
1125
|
-
</div>
|
1126
|
-
|
1127
|
-
<div class="method_details ">
|
1128
|
-
<h3 class="signature " id="timezones-instance_method">
|
1129
|
-
|
1130
|
-
- (<tt>Array</tt>) <strong>timezones</strong>
|
1131
|
-
|
1132
|
-
|
1133
|
-
|
1134
|
-
|
1135
|
-
|
1136
|
-
</h3><div class="docstring">
|
1137
|
-
<div class="discussion">
|
1138
|
-
<p>Returns all the availabe timezones.</p>
|
1139
|
-
|
1140
|
-
|
1141
|
-
</div>
|
1142
|
-
</div>
|
1143
|
-
<div class="tags">
|
1144
|
-
|
1145
|
-
<p class="tag_title">Returns:</p>
|
1146
|
-
<ul class="return">
|
1147
|
-
|
1148
|
-
<li>
|
1149
|
-
|
1150
|
-
|
1151
|
-
<span class='type'>(<tt>Array</tt>)</span>
|
1152
|
-
|
1153
|
-
|
1154
|
-
|
1155
|
-
—
|
1156
|
-
<div class='inline'><p>All the zone available.</p>
|
1157
|
-
</div>
|
1158
|
-
|
1159
|
-
</li>
|
1160
|
-
|
1161
|
-
</ul>
|
1162
|
-
|
1163
|
-
</div><table class="source_code">
|
1164
|
-
<tr>
|
1165
|
-
<td>
|
1166
|
-
<pre class="lines">
|
1167
|
-
|
1168
|
-
|
1169
|
-
62
|
1170
|
-
63
|
1171
|
-
64</pre>
|
1172
|
-
</td>
|
1173
|
-
<td>
|
1174
|
-
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line 62</span>
|
1175
|
-
|
1176
|
-
<span class='kw'>def</span> <span class='id identifier rubyid_timezones'>timezones</span>
|
1177
|
-
<span class='op'>::</span><span class='const'>ActiveSupport</span><span class='op'>::</span><span class='const'>TimeZone</span><span class='period'>.</span><span class='id identifier rubyid_all'>all</span>
|
1178
|
-
<span class='kw'>end</span></pre>
|
1179
|
-
</td>
|
1180
|
-
</tr>
|
1181
|
-
</table>
|
1182
|
-
</div>
|
1183
|
-
|
1184
|
-
<div class="method_details ">
|
1185
|
-
<h3 class="signature " id="unparameterize_zone-instance_method">
|
1186
|
-
|
1187
|
-
- (<tt><span class='object_link'><a href="../String.html" title="Lazier::String (module)">String</a></span>|<span class='object_link'><a href="../TimeZone.html" title="Lazier::TimeZone (module)">TimeZone</a></span></tt>) <strong>unparameterize_zone</strong>(tz, as_string = false, dst_label = nil)
|
1188
|
-
|
1189
|
-
|
1190
|
-
|
1191
|
-
|
1192
|
-
|
1193
|
-
</h3><div class="docstring">
|
1194
|
-
<div class="discussion">
|
1195
|
-
<p>Finds a parameterized timezone.</p>
|
1196
|
-
|
1197
|
-
|
1198
|
-
</div>
|
1199
|
-
</div>
|
1200
|
-
<div class="tags">
|
1201
|
-
<p class="tag_title">Parameters:</p>
|
1202
|
-
<ul class="param">
|
1203
|
-
|
1204
|
-
<li>
|
1205
|
-
|
1206
|
-
<span class='name'>tz</span>
|
1207
|
-
|
1208
|
-
|
1209
|
-
<span class='type'>(<tt><span class='object_link'><a href="../String.html" title="Lazier::String (module)">String</a></span></tt>)</span>
|
1210
|
-
|
1211
|
-
|
1212
|
-
|
1213
|
-
—
|
1214
|
-
<div class='inline'><p>The zone to unparameterize.</p>
|
1215
|
-
</div>
|
1216
|
-
|
1217
|
-
</li>
|
1218
|
-
|
1219
|
-
<li>
|
1220
|
-
|
1221
|
-
<span class='name'>as_string</span>
|
1222
|
-
|
1223
|
-
|
1224
|
-
<span class='type'>(<tt><span class='object_link'><a href="../Boolean.html" title="Lazier::Boolean (module)">Boolean</a></span></tt>)</span>
|
1225
|
-
|
1226
|
-
|
1227
|
-
<em class="default">(defaults to: <tt>false</tt>)</em>
|
1228
|
-
|
1229
|
-
|
1230
|
-
—
|
1231
|
-
<div class='inline'><p>If return just the zone name.</p>
|
1232
|
-
</div>
|
1233
|
-
|
1234
|
-
</li>
|
1235
|
-
|
1236
|
-
<li>
|
1237
|
-
|
1238
|
-
<span class='name'>dst_label</span>
|
1239
|
-
|
1240
|
-
|
1241
|
-
<span class='type'>(<tt><span class='object_link'><a href="../String.html" title="Lazier::String (module)">String</a></span></tt>)</span>
|
1242
|
-
|
1243
|
-
|
1244
|
-
<em class="default">(defaults to: <tt>nil</tt>)</em>
|
1245
|
-
|
1246
|
-
|
1247
|
-
—
|
1248
|
-
<div class='inline'><p>Label for the DST indication. Defaults to <code>(DST)</code>.</p>
|
1249
|
-
</div>
|
1250
|
-
|
1251
|
-
</li>
|
1252
|
-
|
1253
|
-
</ul>
|
1254
|
-
|
1255
|
-
<p class="tag_title">Returns:</p>
|
1256
|
-
<ul class="return">
|
1257
|
-
|
1258
|
-
<li>
|
1259
|
-
|
1260
|
-
|
1261
|
-
<span class='type'>(<tt><span class='object_link'><a href="../String.html" title="Lazier::String (module)">String</a></span>|<span class='object_link'><a href="../TimeZone.html" title="Lazier::TimeZone (module)">TimeZone</a></span></tt>)</span>
|
1262
|
-
|
1263
|
-
|
1264
|
-
|
1265
|
-
—
|
1266
|
-
<div class='inline'><p>The found timezone or <code>nil</code> if the zone is not valid.</p>
|
1267
|
-
</div>
|
1268
|
-
|
1269
|
-
</li>
|
1270
|
-
|
1271
|
-
</ul>
|
1272
|
-
|
1273
|
-
<p class="tag_title">See Also:</p>
|
1274
|
-
<ul class="see">
|
1275
|
-
|
1276
|
-
<li>DateTime#parameterize_zone</li>
|
1277
|
-
|
1278
|
-
</ul>
|
1279
|
-
|
1280
|
-
</div><table class="source_code">
|
1281
|
-
<tr>
|
1282
|
-
<td>
|
1283
|
-
<pre class="lines">
|
1284
|
-
|
1285
|
-
|
1286
|
-
104
|
1287
|
-
105
|
1288
|
-
106</pre>
|
1289
|
-
</td>
|
1290
|
-
<td>
|
1291
|
-
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line 104</span>
|
1292
|
-
|
1293
|
-
<span class='kw'>def</span> <span class='id identifier rubyid_unparameterize_zone'>unparameterize_zone</span><span class='lparen'>(</span><span class='id identifier rubyid_tz'>tz</span><span class='comma'>,</span> <span class='id identifier rubyid_as_string'>as_string</span> <span class='op'>=</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='id identifier rubyid_dst_label'>dst_label</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span>
|
1294
|
-
<span class='op'>::</span><span class='const'>ActiveSupport</span><span class='op'>::</span><span class='const'>TimeZone</span><span class='period'>.</span><span class='id identifier rubyid_unparameterize_zone'>unparameterize_zone</span><span class='lparen'>(</span><span class='id identifier rubyid_tz'>tz</span><span class='comma'>,</span> <span class='id identifier rubyid_as_string'>as_string</span><span class='comma'>,</span> <span class='id identifier rubyid_dst_label'>dst_label</span><span class='rparen'>)</span>
|
1295
|
-
<span class='kw'>end</span></pre>
|
1296
|
-
</td>
|
1297
|
-
</tr>
|
1298
|
-
</table>
|
1299
|
-
</div>
|
1300
|
-
|
1301
|
-
<div class="method_details ">
|
1302
|
-
<h3 class="signature " id="valid?-instance_method">
|
1303
|
-
|
1304
|
-
- (<tt><span class='object_link'><a href="../Boolean.html" title="Lazier::Boolean (module)">Boolean</a></span></tt>) <strong>valid?</strong>(value, format = "%F %T")
|
1305
|
-
|
1306
|
-
|
1307
|
-
|
1308
|
-
<span class="aliases">Also known as:
|
1309
|
-
<span class="names"><span id='is_valid?-instance_method'>is_valid?</span></span>
|
1310
|
-
</span>
|
1311
|
-
|
1312
|
-
|
1313
|
-
|
1314
|
-
</h3><div class="docstring">
|
1315
|
-
<div class="discussion">
|
1316
|
-
<p>Checks if the date is valid against to a specific format.</p>
|
1317
|
-
|
1318
|
-
|
1319
|
-
</div>
|
1320
|
-
</div>
|
1321
|
-
<div class="tags">
|
1322
|
-
<p class="tag_title">Parameters:</p>
|
1323
|
-
<ul class="param">
|
1324
|
-
|
1325
|
-
<li>
|
1326
|
-
|
1327
|
-
<span class='name'>value</span>
|
1328
|
-
|
1329
|
-
|
1330
|
-
<span class='type'>(<tt><span class='object_link'><a href="../String.html" title="Lazier::String (module)">String</a></span></tt>)</span>
|
1331
|
-
|
1332
|
-
|
1333
|
-
|
1334
|
-
—
|
1335
|
-
<div class='inline'><p>The value to check.</p>
|
1336
|
-
</div>
|
1337
|
-
|
1338
|
-
</li>
|
1339
|
-
|
1340
|
-
<li>
|
1341
|
-
|
1342
|
-
<span class='name'>format</span>
|
1343
|
-
|
1344
|
-
|
1345
|
-
<span class='type'>(<tt><span class='object_link'><a href="../String.html" title="Lazier::String (module)">String</a></span></tt>)</span>
|
1346
|
-
|
1347
|
-
|
1348
|
-
<em class="default">(defaults to: <tt>"%F %T"</tt>)</em>
|
1349
|
-
|
1350
|
-
|
1351
|
-
—
|
1352
|
-
<div class='inline'><p>The format to check the value against.</p>
|
1353
|
-
</div>
|
1354
|
-
|
1355
|
-
</li>
|
1356
|
-
|
1357
|
-
</ul>
|
1358
|
-
|
1359
|
-
<p class="tag_title">Returns:</p>
|
1360
|
-
<ul class="return">
|
1361
|
-
|
1362
|
-
<li>
|
1363
|
-
|
1364
|
-
|
1365
|
-
<span class='type'>(<tt><span class='object_link'><a href="../Boolean.html" title="Lazier::Boolean (module)">Boolean</a></span></tt>)</span>
|
1366
|
-
|
1367
|
-
|
1368
|
-
|
1369
|
-
—
|
1370
|
-
<div class='inline'><p><code>true</code> if the value is valid against the format, <code>false</code> otherwise.</p>
|
1371
|
-
</div>
|
1372
|
-
|
1373
|
-
</li>
|
1374
|
-
|
1375
|
-
</ul>
|
1376
|
-
|
1377
|
-
<p class="tag_title">See Also:</p>
|
1378
|
-
<ul class="see">
|
1379
|
-
|
1380
|
-
<li>DateTime#custom_format</li>
|
1381
|
-
|
1382
|
-
</ul>
|
1383
|
-
|
1384
|
-
</div><table class="source_code">
|
1385
|
-
<tr>
|
1386
|
-
<td>
|
1387
|
-
<pre class="lines">
|
1388
|
-
|
1389
|
-
|
1390
|
-
149
|
1391
|
-
150
|
1392
|
-
151
|
1393
|
-
152
|
1394
|
-
153
|
1395
|
-
154</pre>
|
1396
|
-
</td>
|
1397
|
-
<td>
|
1398
|
-
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line 149</span>
|
1399
|
-
|
1400
|
-
<span class='kw'>def</span> <span class='id identifier rubyid_valid?'>valid?</span><span class='lparen'>(</span><span class='id identifier rubyid_value'>value</span><span class='comma'>,</span> <span class='id identifier rubyid_format'>format</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>%F %T</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span>
|
1401
|
-
<span class='op'>::</span><span class='const'>DateTime</span><span class='period'>.</span><span class='id identifier rubyid_strptime'>strptime</span><span class='lparen'>(</span><span class='id identifier rubyid_value'>value</span><span class='comma'>,</span> <span class='id identifier rubyid_custom_format'>custom_format</span><span class='lparen'>(</span><span class='id identifier rubyid_format'>format</span><span class='rparen'>)</span><span class='rparen'>)</span>
|
1402
|
-
<span class='kw'>true</span>
|
1403
|
-
<span class='kw'>rescue</span>
|
1404
|
-
<span class='kw'>false</span>
|
1405
|
-
<span class='kw'>end</span></pre>
|
1406
|
-
</td>
|
1407
|
-
</tr>
|
1408
|
-
</table>
|
1409
|
-
</div>
|
1410
|
-
|
1411
|
-
<div class="method_details ">
|
1412
|
-
<h3 class="signature " id="years-instance_method">
|
1413
|
-
|
1414
|
-
- (<tt>Array</tt>) <strong>years</strong>(offset = 10, also_future = true, reference = nil, as_objects = false)
|
1415
|
-
|
1416
|
-
|
1417
|
-
|
1418
|
-
|
1419
|
-
|
1420
|
-
</h3><div class="docstring">
|
1421
|
-
<div class="discussion">
|
1422
|
-
<p>Returns a range of years.</p>
|
1423
|
-
|
1424
|
-
<p><code>ruby
|
1425
|
-
Date.years(3, false, 2010)
|
1426
|
-
# => [2007, 2008, 2009, 2010]
|
1427
|
-
</code></p>
|
1428
|
-
|
1429
|
-
<p><code>ruby
|
1430
|
-
Date.years(1, true, 2010, true)
|
1431
|
-
# => [{:value=>2009, :label=>2009}, {:value=>2010, :label=>2010}, {:value=>2011, :label=>2011}]
|
1432
|
-
</code></p>
|
1433
|
-
|
1434
|
-
|
1435
|
-
</div>
|
1436
|
-
</div>
|
1437
|
-
<div class="tags">
|
1438
|
-
<p class="tag_title">Parameters:</p>
|
1439
|
-
<ul class="param">
|
1440
|
-
|
1441
|
-
<li>
|
1442
|
-
|
1443
|
-
<span class='name'>offset</span>
|
1444
|
-
|
1445
|
-
|
1446
|
-
<span class='type'>(<tt>Fixnum</tt>)</span>
|
1447
|
-
|
1448
|
-
|
1449
|
-
<em class="default">(defaults to: <tt>10</tt>)</em>
|
1450
|
-
|
1451
|
-
|
1452
|
-
—
|
1453
|
-
<div class='inline'><p>The width of the range.</p>
|
1454
|
-
</div>
|
1455
|
-
|
1456
|
-
</li>
|
1457
|
-
|
1458
|
-
<li>
|
1459
|
-
|
1460
|
-
<span class='name'>also_future</span>
|
1461
|
-
|
1462
|
-
|
1463
|
-
<span class='type'>(<tt><span class='object_link'><a href="../Boolean.html" title="Lazier::Boolean (module)">Boolean</a></span></tt>)</span>
|
1464
|
-
|
1465
|
-
|
1466
|
-
<em class="default">(defaults to: <tt>true</tt>)</em>
|
1467
|
-
|
1468
|
-
|
1469
|
-
—
|
1470
|
-
<div class='inline'><p>If return also future years.</p>
|
1471
|
-
</div>
|
1472
|
-
|
1473
|
-
</li>
|
1474
|
-
|
1475
|
-
<li>
|
1476
|
-
|
1477
|
-
<span class='name'>reference</span>
|
1478
|
-
|
1479
|
-
|
1480
|
-
<span class='type'>(<tt>Fixnum</tt>)</span>
|
1481
|
-
|
1482
|
-
|
1483
|
-
<em class="default">(defaults to: <tt>nil</tt>)</em>
|
1484
|
-
|
1485
|
-
|
1486
|
-
—
|
1487
|
-
<div class='inline'><p>The ending (or middle, if <code>also_future</code> is <code>true</code>) value of the range. Defaults to the current year.</p>
|
799
|
+
<div class='inline'><p>The ending (or middle, if <code>also_future</code> is <code>true</code>) value of the range. Defaults to the current year.</p>
|
1488
800
|
</div>
|
1489
801
|
|
1490
802
|
</li>
|
@@ -1497,8 +809,6 @@ Date.years(1, true, 2010, true)
|
|
1497
809
|
<span class='type'>(<tt><span class='object_link'><a href="../Boolean.html" title="Lazier::Boolean (module)">Boolean</a></span></tt>)</span>
|
1498
810
|
|
1499
811
|
|
1500
|
-
<em class="default">(defaults to: <tt>false</tt>)</em>
|
1501
|
-
|
1502
812
|
|
1503
813
|
—
|
1504
814
|
<div class='inline'><p>If to return years in hashes with <code>:value</code> and <code>label</code> keys.</p>
|
@@ -1532,15 +842,15 @@ Date.years(1, true, 2010, true)
|
|
1532
842
|
<pre class="lines">
|
1533
843
|
|
1534
844
|
|
845
|
+
53
|
1535
846
|
54
|
1536
847
|
55
|
1537
|
-
56
|
1538
|
-
57</pre>
|
848
|
+
56</pre>
|
1539
849
|
</td>
|
1540
850
|
<td>
|
1541
|
-
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line
|
851
|
+
<pre class="code"><span class="info file"># File 'lib/lazier/datetime.rb', line 53</span>
|
1542
852
|
|
1543
|
-
<span class='kw'>def</span> <span class='id identifier rubyid_years'>years</span><span class='lparen'>(</span><span class='
|
853
|
+
<span class='kw'>def</span> <span class='id identifier rubyid_years'>years</span><span class='lparen'>(</span><span class='label'>offset:</span> <span class='int'>10</span><span class='comma'>,</span> <span class='label'>also_future:</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='label'>reference:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>as_objects:</span> <span class='kw'>false</span><span class='rparen'>)</span>
|
1544
854
|
<span class='id identifier rubyid_y'>y</span> <span class='op'>=</span> <span class='id identifier rubyid_reference'>reference</span> <span class='op'>||</span> <span class='op'>::</span><span class='const'>Date</span><span class='period'>.</span><span class='id identifier rubyid_today'>today</span><span class='period'>.</span><span class='id identifier rubyid_year'>year</span>
|
1545
855
|
<span class='lparen'>(</span><span class='id identifier rubyid_y'>y</span> <span class='op'>-</span> <span class='id identifier rubyid_offset'>offset</span><span class='op'>..</span><span class='lparen'>(</span><span class='id identifier rubyid_also_future'>also_future</span> <span class='op'>?</span> <span class='id identifier rubyid_y'>y</span> <span class='op'>+</span> <span class='id identifier rubyid_offset'>offset</span> <span class='op'>:</span> <span class='id identifier rubyid_y'>y</span><span class='rparen'>)</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_year'>year</span><span class='op'>|</span> <span class='id identifier rubyid_as_objects'>as_objects</span> <span class='op'>?</span> <span class='lbrace'>{</span><span class='label'>value:</span> <span class='id identifier rubyid_year'>year</span><span class='comma'>,</span> <span class='label'>label:</span> <span class='id identifier rubyid_year'>year</span><span class='rbrace'>}</span> <span class='op'>:</span> <span class='id identifier rubyid_year'>year</span> <span class='rbrace'>}</span>
|
1546
856
|
<span class='kw'>end</span></pre>
|
@@ -1554,7 +864,7 @@ Date.years(1, true, 2010, true)
|
|
1554
864
|
</div>
|
1555
865
|
|
1556
866
|
<div id="footer">
|
1557
|
-
Generated on
|
867
|
+
Generated on Sun Jun 1 15:50:06 2014 by
|
1558
868
|
<a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
|
1559
869
|
0.8.7.4 (ruby-2.1.2).
|
1560
870
|
</div>
|