time_cursor 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 13d6fc3914b795f5587cc827bd66beb87ed3784a6425c6567cb3b38225a0f6ec
+  data.tar.gz: 8383cd520881f529af5009de0b9899ed7843d038f6e9341bbd356b4d8e38139c
+SHA512:
+  metadata.gz: 070fb20e91c91a491d49ac8b564b52b4e78a503810a4c52acfa289d2c9ec511ff4c2ffa593c220365ddb4e105ab7a2ac499e7ef60759de5cd3dcda14234b07f3
+  data.tar.gz: 7f6ed476e9cd62dc4aac181050f94729d6b607c585a99258a4e216276ccd6d6385aeaa1656c60b333be4a2da95d36a890c73dad1a3fc18c9e1456a8c865f7e29

data/.gitignore

@@ -0,0 +1,23 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+/vendor/
+*.pid
+*.log
+*.log.*
+/var/
+/log/
+*.swp
+/.rspec_status
+

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.2.2
+before_install: gem install bundler -v 1.10.6

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+gemspec
+

data/README.adoc

@@ -0,0 +1,143 @@
+= TimeCursor
+
+TimeCursor is a library to get the next or previous date time along the rules that are given in a crontab-like format.
+
+== Installation
+
+Add this line to your application's Gemfile:
+
+[source,ruby]
+----
+gem 'time_cursor'
+----
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install time_cursor
+    or
+    $ gem install -l time_cursor-x.x.x.gem
+
+== Usage
+
+=== Initialize matcher
+
+[source,ruby]
+----
+time_cursor  =  TimeCursor.new( at: '2015-02-26 01:23' )
+time_cursor  =  TimeCursor.new( year: 2015, month: 2, day: 26, hour: 1, min: 23 )
+
+time_cursor  =  TimeCursor.new( cron: '0  9,17  *  *  mon-fri' )
+time_cursor  =  TimeCursor.new( wday: 'mon-fri', hour: [9,17] )
+
+time_cursor  =  TimeCursor.new( cron: '0  12  1-7  *  sun' )
+time_cursor  =  TimeCursor.new( day: 1..7, wday: 'sun', hour: 12 )
+
+time_cursor  =  TimeCursor.new( sec: '*/10' )
+----
+
+=== Get next time
+
+[source,ruby]
+----
+time_cursor  =  TimeCursor.new( cron: '* * * * *' )             = => =<TimeCursor::Matcher>
+time  =  time_cursor.next( '2015-02-26 01:23' )                 = => 2015-02-26 01:24:00
+time  =  time_cursor.next( time )                               = => 2015-02-26 01:25:00
+----
+
+=== Get previous time
+
+[source,ruby]
+----
+time_cursor  =  TimeCursor.new( hour: '*/3' )                   = => =<TimeCursor::Matcher>
+time  =  time_cursor.prev( '2015-02-26 01:23' )                 = => 2015-02-26 00:00:00
+time  =  time_cursor.prev( time )                               = => 2015-02-25 21:00:00
+----
+
+=== Check to match
+
+[source,ruby]
+----
+time_cursor  =  TimeCursor.new( day: 26, hour: 12 )             = => =<TimeCursor::Matcher>
+time  =  time_cursor.match( '2015-02-26 12:00' )                = => 2015-02-26 12:00:00
+time  =  time_cursor.match( '2015-02-26 00:00' )                = => nil
+----
+
+== Reference
+
+=== Create a new TimeCursor with conditions.
+
+[source,ruby]
+----
+TimeCursor.new( at: nil, cron: nil, year: nil, month: nil, day: nil, wday: nil, hour: nil, min: nil, sec: 0, msec: nil )
+----
+
+* Result:
+  ** TimeCursor::Matcher object.
+
+* Parameter:
+  ** at:  time. Time or String object. (default: nil)
+  ** cron:  set of min, hour, day, month, wday pattern. (default: nil)
+  ** year:  year. unlimited range is denied. (default: nil)
+  ** month:  month. 1..12, jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec. (default: nil)
+  ** day:  day of month. 1..31. (default: nil)
+  ** wday:  day of week. 0..7, sun, mon, tue, wed, thr, fri, sat. (default: nil)
+  ** hour:  minute. 0..23. (default: nil)
+  ** min:  minute. 0..59. (default: nil)
+  ** sec:  second. 0..59. (default: 0)
+  ** msec:  millisecond. 0..999. (default: nil), If msec is assigned, then other parameters are ignored.
+    In detail, it can use "*" as wildcard.
+
+=== Get next time
+
+[source,ruby]
+----
+TimeCursor::Matcher#next( time = Time.now )
+----
+
+* Result:
+  ** Next Time object or nil.
+
+* Parameter:
+  ** time:  base time. Time or String object. (default: Time.now)
+
+=== Get previous time
+
+[source,ruby]
+----
+TimeCursor::Matcher#prev( time = Time.now )
+----
+
+* Result:
+  ** Previous Time object or nil.
+
+* Parameter:
+  ** time:  base time. Time or String object. (default: Time.now)
+
+=== Check to match
+
+[source,ruby]
+----
+TimeCursor::Matcher#match( time )
+----
+
+* Result:
+  ** Time object or nil.
+
+* Parameter:
+  ** time:  Time or String object for matching.
+
+== Caution
+
+Because it is calculated in local time, it does not work as expected when switching to daylight saving time.
+
+== Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/arimay/time_cursor. 
+
+== License
+
+The gem is available as open source under the terms of the http://opensource.org/licenses/MIT[MIT License].

data/README.ja.adoc

@@ -0,0 +1,143 @@
+= TimeCursor
+
+TimeCursor は crontab のような書式で与えた規則で, 次または前の日時を得るためのライブラリ.
+
+== 導入
+
+アプリの Gemfile にこの行を追加
+
+[source,ruby]
+----
+gem 'time_cursor'
+----
+
+それから実行
+
+    $ bundle install
+
+または次のように手動で導入
+
+    $ gem install time_cursor
+    or
+    $ gem install -l time_cursor-x.x.x.gem
+
+== 使い方
+
+=== マッチャを初期化
+
+[source,ruby]
+----
+time_cursor  =  TimeCursor.new( at: '2015-02-26 01:23' )
+time_cursor  =  TimeCursor.new( year: 2015, month: 2, day: 26, hour: 1, min: 23 )
+
+time_cursor  =  TimeCursor.new( cron: '0  9,17  *  *  mon-fri' )
+time_cursor  =  TimeCursor.new( wday: 'mon-fri', hour: [9,17] )
+
+time_cursor  =  TimeCursor.new( cron: '0  12  1-7  *  sun' )
+time_cursor  =  TimeCursor.new( day: 1..7, wday: 'sun', hour: 12 )
+
+time_cursor  =  TimeCursor.new( sec: '*/10' )
+----
+
+=== 次の日時を得る
+
+[source,ruby]
+----
+time_cursor  =  TimeCursor.new( cron: '* * * * *' )             = => =<TimeCursor::Matcher>
+time  =  time_cursor.next( '2015-02-26 01:23' )                 = => 2015-02-26 01:24:00
+time  =  time_cursor.next( time )                               = => 2015-02-26 01:25:00
+----
+
+=== 前の日時を得る
+
+[source,ruby]
+----
+time_cursor  =  TimeCursor.new( hour: '*/3' )                   = => =<TimeCursor::Matcher>
+time  =  time_cursor.prev( '2015-02-26 01:23' )                 = => 2015-02-26 00:00:00
+time  =  time_cursor.prev( time )                               = => 2015-02-25 21:00:00
+----
+
+=== マッチするか調べる
+
+[source,ruby]
+----
+time_cursor  =  TimeCursor.new( day: 26, hour: 12 )             = => =<TimeCursor::Matcher>
+time  =  time_cursor.match( '2015-02-26 12:00' )                = => 2015-02-26 12:00:00
+time  =  time_cursor.match( '2015-02-26 00:00' )                = => nil
+----
+
+== リファレンス
+
+=== 条件を指定して、新たな TimeCursor を作成する.
+
+[source,ruby]
+----
+TimeCursor.new( at: nil, cron: nil, year: nil, month: nil, day: nil, wday: nil, hour: nil, min: nil, sec: 0, msec: nil )
+----
+
+* Result:
+  ** TimeCursor::Matcher オブジェクト.
+
+* Parameter:
+  ** at:  日時. Time または String オブジェクト. (default: nil)
+  ** cron:  分、時、日、月、曜パターンのセット. (default: nil)
+  ** year:  年. 範囲制限なしは拒否される. (default: nil)
+  ** month:  月. 1..12, jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec. (default: nil)
+  ** day:  日. 1..31. (default: nil)
+  ** wday:  曜. 0..7, sun, mon, tue, wed, thr, fri, sat. (default: nil)
+  ** hour:  時. 0..23. (default: nil)
+  ** min:  分. 0..59. (default: nil)
+  ** sec:  秒. 0..59. (default: 0)
+  ** msec:  ミリ秒. 0..999. (default: nil), ミリ秒が指定されたとき, 他のパラメータは無視される.
+    詳細では, ワイルドカードとして "*" を使用できる.
+
+=== 次の日時を得る.
+
+[source,ruby]
+----
+TimeCursor::Matcher#next( time = Time.now )
+----
+
+* Result:
+  ** 次の Time オブジェクト または nil.
+
+* Parameter:
+  ** time:  基準日時. Time または String オブジェクト. (default: Time.now)
+
+=== 前の日時を得る.
+
+[source,ruby]
+----
+TimeCursor::Matcher#prev( time = Time.now )
+----
+
+* Result:
+  ** 前の Time オブジェクト または nil.
+
+* Parameter:
+  ** time:  基準日時. Time または String オブジェクト. (default: Time.now)
+
+=== 日時が条件に適合するか調べる.
+
+[source,ruby]
+----
+TimeCursor::Matcher#match( time )
+----
+
+* Result:
+  ** Time object or nil.
+
+* Parameter:
+  ** time:  適合検査のための Time または String オブジェクト.
+
+== 注意
+
+地域時刻で計算しているため、夏時間の切り替わりにおいて期待しない挙動となる.
+
+== 貢献
+
+不具合報告とプルリクエストは GitHub https://github.com/arimay/time_cursor まで. 
+
+== ライセンス
+
+この Gem は、 http://opensource.org/licenses/MIT[MITライセンス] の条件に基づいてオープンソースとして入手できる.

data/Rakefile

@@ -0,0 +1,96 @@
+require "bundler/gem_helper"
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+class Bundler::GemHelper
+
+  def git_archive( dir = "../#{Time.now.strftime("%Y%m%d")}" )
+    FileUtils.mkdir_p  dir
+    dest_path  =  File.join(dir, "#{name}-#{version}.zip")
+    cmnd  =  "git archive --format zip --prefix=#{name}/ HEAD > #{dest_path}"
+
+    out, code = sh_with_status( cmnd )
+    raise "Couldn't archive gem,"  unless  code == 0
+
+    Bundler.ui.confirm "#{name} #{version} archived to #{dest_path}."
+  end
+
+  def git_push
+    ver  =  version.to_s
+
+    cmnd  =  "git push origin  #{ver} "
+    out, code = sh_with_status( cmnd )
+    raise "Couldn't git push origin."  unless  code == 0
+
+    cmnd  =  "git push "
+    out, code = sh_with_status( cmnd )
+    raise "Couldn't git push."         unless  code == 0
+
+    Bundler.ui.confirm "Git Push #{ver}."
+  end
+
+  def update_version( new_version )
+    version_filename  =  %x[ find . -type f -name "version.rb" | grep -v vendor | head -1 ].chomp
+    version_pathname  =  File.expand_path( version_filename )
+    lines  =  File.open( version_pathname ).read
+    lines  =  lines.gsub( /VERSION\s*=\s*\"\d+\.\d+\.\d+\"/, "VERSION = \"#{new_version}\"" )
+    File.open( version_pathname, "w" ) do |file|
+      file.write( lines )
+    end
+
+    cmnd  =  "git add  #{version_pathname} "
+    out, code = sh_with_status( cmnd )
+    raise "Couldn't git add,"  unless  code == 0
+
+    cmnd  =  "git commit -m  '#{new_version}' "
+    out, code = sh_with_status( cmnd )
+    raise "Couldn't git commit."  unless  code == 0
+
+    cmnd  =  "git tag        #{new_version} "
+    out, code = sh_with_status( cmnd )
+    raise "Couldn't git tag."          unless  code == 0
+
+    Bundler.ui.confirm "Update Tags to #{new_version}."
+  end
+
+end
+
+Bundler::GemHelper.new(Dir.pwd).instance_eval do
+
+  desc "Archive #{name}-#{version}.zip from repository"
+  task 'zip' do
+    git_archive
+  end
+
+  desc "Git Push"
+  task 'push' do
+    git_push
+  end
+
+  desc "Update Version Tiny"
+  task 'tiny' do
+    major, minor, tiny  =  version.to_s.split('.')
+    new_version  =  [major, minor, tiny.to_i + 1].join('.')
+    update_version( new_version )
+  end
+
+  desc "Update Version Minor"
+  task 'minor' do
+    major, minor, tiny  =  version.to_s.split('.')
+    new_version  =  [major, minor.to_i + 1, 0].join('.')
+    update_version( new_version )
+  end
+
+  desc "Update Version Major"
+  task 'major' do
+    major, minor, tiny  =  version.to_s.split('.')
+    new_version  =  [major.to_i + 1, 0, 0].join('.')
+    update_version( new_version )
+  end
+
+end
+

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "time_cursor"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/time_cursor.rb

@@ -0,0 +1,11 @@
+require "time_cursor/version"
+require "time_cursor/base"
+require "time_cursor/elements"
+require "time_cursor/matcher"
+
+module TimeCursor
+  class  <<  self
+    include TimeCursor::Base
+  end
+end
+

data/lib/time_cursor/base.rb

@@ -0,0 +1,103 @@
+require "time"
+require "date"
+
+module TimeCursor
+
+  module Base
+
+    def new( at: nil, cron: nil, year: nil, month: nil, day: nil, wday: nil, hour: nil, min: nil, sec: 0, msec: nil )
+      if  !at.nil?
+        at( at )
+      elsif  !cron.nil?
+        cron( cron )
+      else
+        detail( year: year, month: month, day: day, wday: wday, hour: hour, min: min, sec: sec, msec: msec )
+      end
+    end
+
+    def at( time )
+      case  time
+      when  String
+        date  =  Date.parse( time )  rescue  nil
+        time  =  Time.parse( time )
+      when  Time
+        date  =  time.to_date
+      end
+
+      case  time
+      when  Date
+        Matcher.new(
+          year:   time.year,
+          month:  time.month,
+          day:    time.day,
+          hour:   0,
+          min:    0,
+          sec:    0,
+        )
+      when  Time
+        if  date.nil?
+          Matcher.new(
+            hour:   time.hour,
+            min:    time.min,
+            sec:    time.sec,
+          )
+        else
+          Matcher.new(
+            year:   time.year,
+            month:  time.month,
+            day:    time.day,
+            hour:   time.hour,
+            min:    time.min,
+            sec:    time.sec,
+          )
+        end
+      else
+        raise  ArgumentError, "invalid class : '#{datetime}'"
+      end
+    end
+
+    def cron( patterns )
+      case  patterns
+      when  String
+      else
+        raise  ArgumentError, "invalid class : '#{patterns}'"
+      end
+      a  =  patterns.split("\s")
+      unless  a.size == 5
+        raise  ArgumentError, "too/few count of fields : '#{patterns}'"
+      end
+      Matcher.new(
+        month:  a[3],
+        day:    a[2],
+        wday:   a[4],
+        hour:   a[1],
+        min:    a[0],
+      )
+    end
+
+    def detail( year: nil, month: nil, day: nil, wday: nil, hour: nil, min: nil, sec: 0, msec: nil )
+      if  msec.nil?
+        month  ||=  1    unless  year.nil?
+        day    ||=  1    unless  month.nil?
+        hour   ||=  0    unless  ( day.nil? && wday.nil? )
+        min    ||=  0    unless  hour.nil?
+        Matcher.new(
+          year:   year,
+          month:  month,
+          day:    day,
+          wday:   wday,
+          hour:   hour,
+          min:    min,
+          sec:    sec,
+        )
+      else
+        Matcher.new(
+          msec:   msec,
+        )
+      end
+    end
+
+  end
+
+end
+

data/lib/time_cursor/elements.rb

@@ -0,0 +1,111 @@
+
+module TimeCursor
+
+  class Elements < Array
+
+    DATE_ALIAS  =  {
+      'sun'=>'0', 'mon'=>'1', 'tue'=>'2', 'wed'=>'3',  'thr'=>'4',  'fri'=>'5', 'sat'=>'6',
+      'jan'=>'1', 'feb'=>'2', 'mar'=>'3', 'apr'=>'4',  'may'=>'5',  'jun'=>'6',
+      'jul'=>'7', 'aug'=>'8', 'sep'=>'9', 'oct'=>'10', 'nov'=>'11', 'dec'=>'12',
+    }
+    RE_ALL   =  %r|\A\*(/1)?\Z|
+    RE_WILD  =  %r|\A\*(/(\d+))?\Z|
+    RE_LIST  =  %r|\A(\d+)(-(\d+)(/(\d+))?)?\Z|
+
+    def self.build( target, range = nil )
+      case  target
+      when  Array
+        target  =  target.join(',')
+
+      when  Symbol
+        target  =  target.to_s
+
+      end
+
+      case  target
+      when  NilClass
+        Elements.new( [] )
+
+      when  Range
+        Elements.new( target.to_a )
+
+      when  Numeric
+        Elements.new( [target] )
+
+      when  String
+        factors  =  DATE_ALIAS.inject( target.downcase ) do |s, (k, v)| s.gsub( k, v ) end
+        items  =  factors.split(',').map do |factor|
+          if  m = RE_ALL.match( factor )
+            []
+          elsif  m = RE_WILD.match( factor )
+            if  range.nil?
+              raise  ArgumentError, "disallow wildcard without range : '#{target}'"
+            end
+            from  =  range.first
+            to    =  range.last
+            step  =  ( m[2] || 1 ).to_i
+            expand( from, to, step, range )
+          elsif  m = RE_LIST.match( factor )
+            from  =  ( m[1] ).to_i
+            to    =  ( m[3] || m[1] ).to_i
+            step  =  ( m[5] || 1 ).to_i
+            expand( from, to, step, range )
+          else
+            raise  ArgumentError, "format invalid : '#{target}'"
+          end
+        end
+        Elements.new( items.flatten.sort.uniq )
+
+      else
+        raise  ArgumentError, "type invalid : '#{target}'"
+
+      end
+    end
+
+    def self.expand( from, to, step, range )
+      result  =  []
+      cur  =  from
+      if  from <= to
+        loop do
+          result  <<  cur
+          cur  +=  step
+          break    if  cur > to
+        end
+      else
+        loop do
+          result  <<  cur
+          cur  +=  step
+          break    if  cur > range.last
+        end
+        cur  =  range.first
+        loop do
+          result  <<  cur
+          cur  +=  step
+          break    if  cur > to
+        end
+      end
+      result
+    end
+
+    def right( item )
+      0.upto(self.size-1) do |i|
+        return  self[i]    if  item < self[i]
+      end
+      nil
+    end
+
+    def left( item )
+      (self.size-1).downto(0) do |i|
+        return  self[i]    if  self[i] < item
+      end
+      nil
+    end
+
+    def correspond?( item )
+      self.empty?  ||  self.include?( item )
+    end
+
+  end
+
+end
+

data/lib/time_cursor/matcher.rb

@@ -0,0 +1,356 @@
+require "time"
+require "date"
+
+module TimeCursor
+
+  class Matcher
+
+    def initialize( year: '*', month: '*', day: '*', wday: '*', hour: '*', min: '*', sec: 0, msec: nil )
+      if  msec.nil?
+        @years    =  Elements.build( year           )
+        @months   =  Elements.build( month,  1..12  )
+        @days     =  Elements.build( day,    1..31  )
+        @wdays    =  Elements.build( wday,   0..6   )
+        @hours    =  Elements.build( hour,   0..23  )
+        @mins     =  Elements.build( min,    0..59  )
+        @secs     =  Elements.build( sec,    0..59  )
+        @usecs    =  Elements.new
+
+        if  !@years.empty? || !@months.empty? || !@days.empty? || !@wdays.empty?
+          @next_for  =  :next_for_date
+          @prev_for  =  :prev_for_date
+
+        elsif  !@hours.empty? || !@mins.empty?
+          @next_for  =  :next_for_time
+          @prev_for  =  :prev_for_time
+
+        else
+          @secs  =  Elements.build( '0-59', 0..59 )    if @secs.empty?
+          @next_for  =  :next_for_sec
+          @prev_for  =  :prev_for_sec
+
+        end
+
+      else
+        @years    =  Elements.new
+        @months   =  Elements.new
+        @days     =  Elements.new
+        @wdays    =  Elements.new
+        @hours    =  Elements.new
+        @mins     =  Elements.new
+        @secs     =  Elements.new
+        @usecs    =  Elements.build( msec,   0..999 )
+        @usecs.each_with_index do |item, ndx|
+          @usecs[ndx]  *= 1000
+        end
+
+        @next_for  =  :next_for_usec
+        @prev_for  =  :prev_for_usec
+
+      end
+    end
+
+    def next( time = Time.now )
+      case  time
+      when  Time
+      when  String
+        time  =  Time.parse( time )
+      else
+        raise  ArgumentError, "can not parse as time."
+      end
+      send( @next_for, time )
+    end
+
+    def prev( time = Time.now )
+      case  time
+      when  Time
+      when  String
+        time  =  Time.parse( time )
+      else
+        raise  ArgumentError, "can not parse as time."
+      end
+      send( @prev_for, time )
+    end
+
+    def match( time = Time.now )
+      case  time
+      when  Time
+      when  String
+        time  =  Time.parse( time )
+      else
+        raise  ArgumentError, "can not parse as time."
+      end
+
+      if  @years.correspond?( time.year )  &&
+          @months.correspond?( time.month )  &&
+          @days.correspond?( time.day )  &&
+          @hours.correspond?( time.hour )  &&
+          @mins.correspond?( time.min )  &&
+          @secs.correspond?( time.sec )
+        time
+      else
+        nil
+      end
+    end
+
+    # private
+
+    def next_for_date( time )
+      time  +=  1
+      loop do
+        if  !@years.correspond?( year = time.year )
+          year  =  @years.right( year )
+          return  time  =  nil   if  year.nil?
+          time  =  forward_to_year( time, year )
+
+        elsif  !@months.correspond?( month = time.month )
+          month  =  @months.right( month ) || @months.first
+          time  =  forward_to_month( time, month )
+
+        elsif  !@wdays.correspond?( wday = time.wday )
+          wday  =  @wdays.right( wday ) || @wdays.first
+          time  =  forward_to_wday( time, wday )
+
+        elsif  !@days.correspond?( day = time.day )
+          day  =  @days.right( day ) || @days.first
+          time  =  forward_to_day( time, day )
+
+        elsif  !@hours.correspond?( hour = time.hour )
+          hour  =  @hours.right( hour ) || @hours.first
+          time  =  forward_to_hour( time, hour )
+
+        elsif  !@mins.correspond?( min = time.min )
+          min  =  @mins.right( min ) || @mins.first
+          time  =  forward_to_min( time, min )
+
+        elsif  !@secs.correspond?( sec = time.sec )
+          sec  =  @secs.right( sec ) || @secs.first
+          time  =  forward_to_sec( time, sec )
+
+        else
+          return  time
+
+        end
+      end
+    end
+
+    def next_for_time( time )
+      time  +=  1
+      loop do
+        if  !@hours.correspond?( hour = time.hour )
+          hour  =  @hours.right( hour ) || @hours.first
+          time  =  forward_to_hour( time, hour )
+
+        elsif  !@mins.correspond?( min = time.min )
+          min  =  @mins.right( min ) || @mins.first
+          time  =  forward_to_min( time, min )
+
+        elsif  !@secs.correspond?( sec = time.sec )
+          sec  =  @secs.right( sec ) || @secs.first
+          time  =  forward_to_sec( time, sec )
+
+        else
+          return  time
+
+        end
+      end
+    end
+
+    def next_for_sec( time )
+      sec  =  @secs.right( time.sec ) || @secs.first
+      time  =  forward_to_sec( time, sec )
+    end
+
+    def next_for_usec( time )
+      usec  =  @usecs.right( time.usec ) || @usecs.first
+      time  =  forward_to_usec( time, usec )
+    end
+
+    def prev_for_date( time )
+      time  -=  1
+      loop do
+        if  !@years.correspond?( year = time.year )
+          year  =  @years.left( year )
+          return  time  =  nil    if  year.nil?
+          time  =  back_to_year( time, year )
+
+        elsif  !@months.correspond?( month = time.month )
+          month  =  @months.left( month ) || @months.last
+          time  =  back_to_month( time, month )
+
+        elsif  !@wdays.correspond?( wday = time.wday )
+          wday  =  @wdays.left( wday ) || @wdays.last
+          time  =  back_to_wday( time, wday )
+
+        elsif  !@days.correspond?( day = time.day )
+          day  =  @days.left( day ) || @days.last
+          time  =  back_to_day( time, day )
+
+        elsif  !@hours.correspond?( hour = time.hour )
+          hour  =  @hours.left( hour ) || @hours.last
+          time  =  back_to_hour( time, hour )
+
+        elsif  !@mins.correspond?( min = time.min )
+          min  =  @mins.left( min ) || @mins.last
+          time  =  back_to_min( time, min )
+
+        elsif  !@secs.correspond?( sec = time.sec )
+          sec  =  @secs.left( sec ) || @secs.last
+          time  =  back_to_sec( time, sec )
+
+        else
+          return  time
+
+        end
+      end
+    end
+
+    def prev_for_time( time )
+      time  -=  1
+      loop do
+        if  !@hours.correspond?( hour = time.hour )
+          hour  =  @hours.left( hour ) || @hours.last
+          time  =  back_to_hour( time, hour )
+
+        elsif  !@mins.correspond?( min = time.min )
+          min  =  @mins.left( min ) || @mins.last
+          time  =  back_to_min( time, min )
+
+        elsif  !@secs.correspond?( sec = time.sec )
+          sec  =  @secs.left( sec ) || @secs.last
+          time  =  back_to_sec( time, sec )
+
+        else
+          return  time
+
+        end
+      end
+    end
+
+    def prev_for_sec( time )
+      sec  =  @secs.left( time.sec ) || @secs.last
+      time  =  back_to_sec( time, sec )
+    end
+
+    def prev_for_usec( time )
+      usec  =  @usecs.left( time.usec ) || @usecs.last
+      time  =  back_to_usec( time, usec )
+    end
+
+    def forward_to_year( time, year )
+      if time.year < year
+        Time.new( year )
+      else
+        nil
+      end
+    end
+
+    def forward_to_month( time, month )
+      date  =  Date.new( time.year, time.month, time.day )
+      loop do
+        date  =  date.next_month
+        break    if  date.month == month
+      end
+      Time.new( date.year, date.month )
+    end
+
+    def forward_to_day( time, day )
+      date  =  Date.new( time.year, time.month, time.day )
+      loop do
+        date  =  date.next_day
+        break    if  date.day == day
+      end
+      Time.new( date.year, date.month, date.day )
+    end
+
+    def forward_to_wday( time, wday )
+      date  =  Date.new( time.year, time.month, time.day )
+      loop do
+        date  =  date.next_day
+        break    if  date.wday == wday
+      end
+      Time.new( date.year, date.month, date.day )
+    end
+
+    def forward_to_hour( time, hour )
+      time  +=  60 * 60 * 24    if hour <= time.hour
+      Time.new( time.year, time.month, time.day, hour )
+    end
+
+    def forward_to_min( time, min )
+      time  +=  60 * 60    if min <= time.min
+      Time.new( time.year, time.month, time.day, time.hour, min )
+    end
+
+    def forward_to_sec( time, sec )
+      time  +=  60    if sec <= time.sec
+      Time.new( time.year, time.month, time.day, time.hour, time.min, sec )
+    end
+
+    def forward_to_usec( time, usec )
+      time  +=  1    if  usec <= time.usec
+      Time.local( time.year, time.month, time.day, time.hour, time.min, time.sec, usec )
+    end
+
+    def back_to_year( time, year )
+      if year < time.year
+        Time.new( year + 1 ) - 1
+      else
+        nil
+      end
+    end
+
+    def back_to_month( time, month )
+      date  =  Date.new( time.year, time.month, time.day )
+      loop do
+        date  =  date.prev_month
+        break    if  date.month == month
+      end
+      date  =  date.next_month
+      Time.new( date.year, date.month ) - 1
+    end
+
+    def back_to_day( time, day )
+      date  =  Date.new( time.year, time.month, time.day )
+      loop do
+        date  =  date.prev_day
+        break    if  date.day == day
+      end
+      date  =  date.next_day
+      Time.new( date.year, date.month, date.day ) - 1
+    end
+
+    def back_to_wday( time, wday )
+      date  =  Date.new( time.year, time.month, time.day )
+      loop do
+        date  =  date.prev_day
+        break    if  date.wday == wday
+      end
+      date  =  date.next_day
+      Time.new( date.year, date.month, date.day ) - 1
+    end
+
+    def back_to_hour( time, hour )
+      time  -=  60 * 60 * 24    if  time.hour <= hour
+      Time.new( time.year, time.month, time.day, hour, 59, 59 )
+    end
+
+    def back_to_min( time, min )
+      time  -=  60 * 60    if  time.min <= min
+      Time.new( time.year, time.month, time.day, time.hour, min, 59 )
+    end
+
+    def back_to_sec( time, sec )
+      time  -=  60    if  time.sec <= sec
+      Time.new( time.year, time.month, time.day, time.hour, time.min, sec )
+    end
+
+    def back_to_usec( time, usec )
+      time  -=  1    if  time.usec < usec
+      Time.local( time.year, time.month, time.day, time.hour, time.min, time.sec, usec )
+    end
+
+  end
+
+end
+

data/lib/time_cursor/version.rb

@@ -0,0 +1,4 @@
+module TimeCursor
+  VERSION = "1.0.0"
+end
+

data/time_cursor.gemspec

@@ -0,0 +1,23 @@
+lib = File.expand_path("lib", __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'time_cursor/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "time_cursor"
+  spec.version       = TimeCursor::VERSION
+  spec.authors       = ["arimay"]
+  spec.email         = ["arima.yasuhiro@gmail.com"]
+
+  spec.summary       = %q{ Get the datetime for event schedule. }
+  spec.description   = %q{ Get the next or previous datetime along the rules that are given in a crontab-like format or other options. }
+  spec.homepage      = "https://github.com/arimay/time_cursor/"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification
+name: time_cursor
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- arimay
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2020-08-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: " Get the next or previous datetime along the rules that are given in
+  a crontab-like format or other options. "
+email:
+- arima.yasuhiro@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- README.adoc
+- README.ja.adoc
+- Rakefile
+- bin/console
+- bin/setup
+- lib/time_cursor.rb
+- lib/time_cursor/base.rb
+- lib/time_cursor/elements.rb
+- lib/time_cursor/matcher.rb
+- lib/time_cursor/version.rb
+- time_cursor.gemspec
+homepage: https://github.com/arimay/time_cursor/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key: 
+specification_version: 4
+summary: Get the datetime for event schedule.
+test_files: []