Chronik by Marcin Ciunelis (G-Forces Polska)

DESCRIPTION:

A Polish version of the Tom Preston-Werner’s Chronic (github.com/mojombo/chronic/tree/master) natural language date/time parser written in pure Ruby. See below for the wide variety of formats Chronik will parse.

INSTALLATION:

Chronik can be installed via RubyGems:

$ gem sources -a gems.github.com

$ sudo gem install gforces-chronik

CODE:

You can grab the code (and help with development) via git:

$ git clone git://github.com/gforces/chronik.git

USAGE:

You can parse strings containing a natural language date using the Chronik.parse method.

require 'rubygems'
require 'chronik'

Time.now   #=> Sun Aug 27 23:18:25 PDT 2006

#---

Chronik.parse('jutro')       
  #=> Mon Aug 28 12:00:00 PDT 2006

Chronik.parse('ponidziałek', :context => :past)
  #=> Mon Aug 21 12:00:00 PDT 2006

Chronik.parse('przyszły wtorek 5:00')
  #=> Tue Aug 29 17:00:00 PDT 2006

Chronik.parse('przyszły wtorek 5:00', :ambiguous_time_range => :none)
  #=> Tue Aug 29 05:00:00 PDT 2006

Chronik.parse('27 maja', :now => Time.local(2000, 1, 1))
  #=> Sat May 27 12:00:00 PDT 2000

Chronik.parse('27 maja', :guess => false)
  #=> Sun May 27 00:00:00 PDT 2007..Mon May 28 00:00:00 PDT 2007

See Chronik.parse for detailed usage instructions.

EXAMPLES:

Chronik can parse a huge variety of date and time formats. Following is a small sample of strings that will be properly parsed. Parsing is case insensitive and will handle common abbreviations and misspellings.

Simple

czwartek
listopad
lato
piątek 13:00
pon 2:35
4 po południu
6 rano
piątek 1 po południu
sob 7 wieczorem
wczoraj
dzisiaj
jutro
przysły wtorek
przysły miesiąc
ostatnia zima
dzisiaj rano
wczoraj w nocy
teraz
wczoraj o 4:00
poprzeni piątek o  20:00
jutro o 6:45 wieczorem
wczoraj po południu

Complex

3 years ago
5 months before now
7 hours ago
7 days from now
1 week hence
in 3 hours
1 year ago tomorrow
3 months ago saturday at 5:00 pm
7 hours before tomorrow at noon
3rd wednesday in november
3rd month next year
3rd thursday this september
4th day last week

Specific Dates

January 5
dec 25
may 27th
October 2006
oct 06
jan 3 2010
february 14, 2004
3 jan 2000
17 april 85
5/27/1979
27/5/1979
05/06
1979-05-27
Friday
5
4:00
17:00
0800

Specific Times (many of the above with an added time)

January 5 at 7pm
1979-05-27 05:00:00
etc

TIME ZONES:

Chronik allows you to set which Time class to use when constructing times. By default, the built in Ruby time class creates times in your system’s local time zone. You can set this to something like ActiveSupport’s TimeZone class to get full time zone support.

>> Time.zone = "UTC"
>> Chronik.time_class = Time.zone
>> Chronik.parse("June 15 2006 at 5:45 AM")
=> Thu, 15 Jun 2006 05:45:00 UTC +00:00

LIMITATIONS:

Chronik uses Ruby’s built in Time class for all time storage and computation. Because of this, only times that the Time class can handle will be properly parsed. Parsing for times outside of this range will simply return nil. Support for a wider range of times is planned for a future release.

LICENSE:

(The MIT License)

Copyright © 2009 Marcin Ciunelis (G-Forces Polska)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.