Constructor Function For timeDate Objects

DESCRIPTION:

Construct a time object corresponding to calendar dates and/or times of day.

USAGE:

timeCalendar(m=<<see below>>, d=<<see below>>, y=<<see below>>,  
              h=<<see below>>, min=<<see below>>, s=<<see below>>,  
              ms=<<see below>>, format=<<see below>>, zone=<<see below>>) 

OPTIONAL ARGUMENTS:

m
calendar months (1-12), defaults are 1.
d
calendar days (1-31), defaults are 1.
y
calendar years (e.g. 1997), defaults are 1960.
h
hours of the days (0-23), defaults are 0.
min
minutes of the days (0-59), defaults are 0.
s
seconds of the days (0-59), defaults are 0.
ms
milliseconds of the days (0-999), defaults are 0.
format
output format string to put on returned object, default is from options("time.out.format").
zone
time zone of input date and time, also stored in result; default is from options("time.zone").

VALUE:

Returns a timeDate object corresponding to the input.

DETAILS:

If none of m, d, y, h, min, s, and ms are supplied, this function returns a time vector of length zero. If more than one is supplied, they must all have compatible lengths; shorter inputs will be used cyclically to make up the maximum length, but they must be even multiples. The arguments represent the date and time of day in the given time zone, with missing ones supplied to give a time of midnight, January 1, 1960. Leap seconds will not cause NA values, but may cause times of day to be off by a second in days containing them.

SEE ALSO:

, class, mdy, .

EXAMPLES:

timeCalendar(m = c(3, 4, 5), d = c(12, 15, 7), y = c(1998, 1997, 2004), 
     format = "%b. %d, %Y") 
timeCalendar(h = c(9, 14), min = c(15, 23), format = "%I:%02M %p")