Provides chronological objects which can handle dates and times.
This directory contains code and help for an R port of CHRON, an S-PLUS
package for working with chronological objects (times and dates).
The original was downloaded from
http://netlib.bell-labs.com/cm/ms/departments/sia/project/misc/chron.html
See the file `PORTING' for the changes made for the R version.
The original `README' is appended below.
*** Original README **************************************************
This directory contains S functions to work with chron objects. These
objects handle dates and times. For the time being issues relating to
time-zones, daylight savings time, etc. are being put aside.
NOTE: To use chron objects you need library(statistics) in S.
In S-PLUS you need library(chron, first = T)
For source and details, see
http://cm.bell-labs.com/ms/departments/sia/dj/chron.html
The following methods and functions are available for chron objects:
function description
---------- -----------------------------------------------------
chron createas a chron object; it takes either julian dates
or character dates. See help(chron).
dates creates a dates object (simply invokes chron)
times creates a times object (simply inoveks chron)
as.numeric returns a vector of julian dates + fraction of day (times)
as.character returns a character representation of dates/times
is.na
print print dates and times nicely
plot plot with time axis
hist histogram with time axis
identify identify points in scatterplot
lines, points add lines/points
axis.times add time axis to plot
cut make ordered factors from dates (e.g., by month, week)
seq generate a sequence of dates
min, max, numeric summaries
range, summary
sort, order
trunc, ceiling,
round, signif,
diff
[.times selects, e.g., dates[ dates > "02/20/92" ], or
lathe.date[ start.date > min(scan.date) ]
[<-.times replacement
c combines chrons
days, months, extact day, month, year, quarter number, etc.
years, quarters
weekdays,
hours, minutes,
seconds
is.holiday
is.weekend
month.day.year date conversion (modified from the S "blue" book)
julian,
day.of.week
UNDOCUMENTED FEATURES:
----------------------
1. Chron matrices can be created from chron objects by using dim()
(can't use matrix() nor array())
> dim(x) <- c(20,3)
> x[2,3] <- "03/28/90" # replaces a cell
2. The c() method takes anything that can be coerced to chrons:
y <- c(x, "03/21/92", 8123)
but a bug(?) in the S evaluator makes it necessary to
specify the chron object first, i.e., c("03/28/90", x) does not
dispath the c.dates() method.