Project

timing

0.0
No commit activity in last 3 years
No release in over 3 years
Time utils
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.12
~> 0.8
~> 5.0, < 5.11
~> 0.2
~> 11.0
~> 0.16

Runtime

~> 0.0, >= 0.0.5
~> 1.4.0
 Project Readme

Timing

Gem Version Build Status Coverage Status Code Climate

Time utils

Installation

Add this line to your application's Gemfile:

gem 'timing'

And then execute:

$ bundle

Or install it yourself as:

$ gem install timing

Usage

TimeInZone

Acts like Time with specific utc offset.

Time.now                                  # => 2015-10-19 22:10:47 -0300
Timing::TimeInZone.now                    # => 2015-10-19 22:10:47 -0300
Timing::TimeInZone.now '-0400'            # => 2015-10-19 21:10:47 -0400

Timing::TimeInZone.at 1445303855          # => 2015-10-19 22:17:35 -0300
Timing::TimeInZone.at 1445303855, '+0200' # => 2015-10-20 03:17:35 +0200

Timing::TimeInZone.now                    # => 2015-10-19 22:22:52 -0300
Timing::TimeInZone.now.to_zone('-0100')   # => 2015-10-20 00:22:52 -0100

time = Timing::TimeInZone.now '+0200'     # => 2015-10-20 03:36:14 +0200
time.zone_offset = '-0100'
time                                      # => 2015-10-20 00:36:14 -0100

time = Timing::TimeInZone.now '-0700'     # => 2015-10-19 18:29:29 -0700
time + 3600                               # => 2015-10-19 19:29:29 -0700
Timing::TimeInZone.now - time             # => 250.85015296936035
time.to_time                              # => 2015-10-19 22:29:29 -0300

Interval

Seconds wrapper with helper methods.

Timing::Interval.new 10       # => 10s (10.0)

Timing::Interval.seconds(20)  # => 20s (20.0)
Timing::Interval.minutes(15)  # => 15m (900.0)
Timing::Interval.hours(7)     # => 7h (25200.0)
Timing::Interval.days(5)      # => 5d (432000.0)
Timing::Interval.weeks(2)     # => 2w (1209600.0)

Timing::Interval.parse('20s') # => 20s (20.0)
Timing::Interval.parse('15m') # => 15m (900.0)
Timing::Interval.parse('7h')  # => 7h (25200.0)
Timing::Interval.parse('5d')  # => 5d (432000.0)
Timing::Interval.parse('2w')  # => 2w (1209600.0)
Timing::Interval.parse('1m 10s')  # => 1m 10s (70.0)

interval = Timing::Interval.weeks(1)
interval.to_seconds           # => 604800.0
interval.to_minutes           # => 10080.0
interval.to_hours             # => 168.0
interval.to_days              # => 7.0
interval.to_weeks             # => 1.0

interval = Timing::Interval.seconds(1299785)
interval.to_human                     # => 2w 1d 1h 3m 5s
interval.to_human(biggest_unit: 'd')  # => 15d 1h 3m 5s
interval.to_human(smallest_unit: 'm') # => 2w 1d 1h 3m

NaturalTimeLanguage

Natural language to specify times.

Timing::NaturalTimeLanguage.parse 'now'

Named moments

- now
- Now -0500
- today
- today +0000
- Today -0600
- yesterday -0400
- tomorrow -0300

Last/Next day name

- last Monday +0200
- last fri +0100
- next tuesday +0000
- next sat -0100
- last thursday including today -0300
- next mon including today +0200

Date (at 00:00:00)

- 6 April
- 14 Jul 2010 +0400
- 2015-09-03
- 2015-06-20 -0800

Beginning/End of interval

- Beginning of month
- end of year +0700
- beginning of week
- End of Day -0100
- end of hour +0400

Time ago (now - interval)

- 1 minute ago
- 3 hours ago -0500
- 5 days ago -0100
- 4 weeks ago +0100
- 10 months ago +0330
- 7 years ago -0700

Date at time

- today at 15:40
- last sunday at 08:43:21 -0300
- yesterday at beginning
- next friday at beginning -0100
- beginning of year at end
- 14 May 2011 at end -0400
- 25 Nov at 13:25
- 2001-07-14 at 18:41
- 2012-08-17 14:35:20
- 1980-04-21T08:15:03-0500

Before/After moment

- 15 minutes from now
- 3 days before yesterday
- 1 month from today
- 1 week from last monday at 08:30 -0400
- 5 days before next friday at end
- 1 month before beginning of month
- 1 year before 9 Sep +0300
- 2 years from 2001-05-21T12:30:40 -0500

HourMinutesSeconds

Hour, minutes and seconds model.

HourMinutesSeconds.new 9, 23, 41 # => 09:23:41
HourMinutesSeconds.new 9, 23     # => 09:23:00
HourMinutesSeconds.new 9         # => 09:23:00

hhmmss = HourMinutesSeconds.parse '9:23:41'
hhmmss.hour    # => 9
hhmmss.minutes # => 23
hhmmss.seconds # => 41
hhmmss.iso8601 # => 09:23:41

ZoneOffset

Seconds wrapper helper for utc offset

Timing::ZoneOffset.new -10800 # => -0300 (-10800.0)
Timing::ZoneOffset.new 21600  # => +0600 (21600.0)

Timing::ZoneOffset.parse '-0300' # => -0300 (-10800.0)
Timing::ZoneOffset.parse '+0600' # => +0600 (21600.0)

zone_offset = Timing::ZoneOffset.parse '-0300'
zone_offset.iso8601 # => '-03:00'

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/gabynaiman/timing.

License

The gem is available as open source under the terms of the MIT License.