Intelligent parsing of date-time strings.
This package is inspired by the R package lubridate, and the Ruby gem stamp
This package can be installed from github using the devtools
package.
require(devtools)
install_github("intellidate", "ramnathv")
intellidate provides five main functions to work with date-time strings.
str_to_date
: converts a date string to aDate
objectstamp
: stamps a date object, given a template stringguess_date_format
: detects all formats matching a date stringguess_time_format
: detects the format of a time stringguess_datetime_format
: detects all formats matching a date-time string
Converts a date string to a Date
object.
str_to_date
uses a set of simple heuristics to resolve the date components uniquely. If the date cannot be resolved uniquely, str_to_date
uses a default ordering of month-date-year to break the ambiguity.
str_to_date("12/14/2011") #= 2011-12-14
str_to_date("14/12/2011") #= 2011-12-14
str_to_date("11/10/1989", 'mdy') #= 1989-11-10
Formats a date-time string based on a user provided template. This function is inspired by the Ruby gem stamp.
Suppose you want to stamp all your graphs based on the message template "Created on Nov 22, 2009 at 23:00 hours". You could do it with stamp
by calling
now <- Sys.time() #= "2011-12-15 08:28:58 EST"
stamp("Created on Nov 22, 2009 at 23:00 hours", now)
[1] "Created on Dec 15, 2011 at 08:29 hours"
stamp("21 Aug 2011, 11:15pm", now)
Given a date string, returns all date formats that match it.
guess_date_format("Jan 1, 1999") #= "%b %e, %Y"
guess_date_format("Sunday, May 1, 2000") #= "%A, %B %e, %Y"
guess_date_format("Sun Aug 5") #= "%a %b %e"
guess_date_format('20 01 89') #= "%d %m %y"
guess_date_format('1 13 89') #= "%m %d %y"
guess_date_format('00/13/10') #= "%y/%d/%m"
guess_date_format("01-01/99") #= c("%m-%d/%y", "%d-%m/%y"))
guess_date_format("12/11/00") #= c("%m/%d/%y", "%d/%m/%y"))