datetime.append: Append Date-Time Information to a Dataset
In contact: Creating Contact and Social Networks

Description Usage Arguments Value Examples

This function appends date-time information to a dataset in POSIXct date_time format. It also uses functions from the lubridate package and minor calculations to parse out month, day, hour, minute, second, daySecond (the sequentially ordered second of a day), and totalSecond (sequentially ordered second over the course of the study period) of observations in a given dataset with date (format: "mdy" = month/day/year, "ymd" = year/month/day, "dmy" = day/month/year, or "ydm" = year/day/month (note: no preceding zeroes should be included before numbers <10)) and time (format: hour:minute:second (note:preceding zeroes must be included before numbers < 10, ex. 00:00:01)) information, appends this metadata to the dataset, and can assign each day a unique ID.

datetime.append(
  x,
  date = NULL,
  time = NULL,
  dateTime = NULL,
  dateFormat = "mdy",
  dateFake = FALSE,
  startYear = 2000,
  tz.in = "UTC",
  tz.out = NULL,
  month = FALSE,
  day = FALSE,
  year = FALSE,
  hour = FALSE,
  minute = FALSE,
  second = FALSE,
  daySecond = FALSE,
  totalSecond = FALSE
)

`x`	Data frame or list of data frames to which new information will be appended.
`date`	Vector of length nrow(data.frame(x)) or singular character data, detailing the relevant colname in x, that denotes what date information will be used. If argument == NULL, datetime.append assumes a column with the colname "date" exists in x, or that the dateTime argument != NULL. Defaults to NULL.
`time`	Vector of length nrow(data.frame(x)) or singular character data, detailing the relevant colname in x, that denotes what time information will be used. If argument == NULL, datetime.append assumes a column with the colname "time" exists in x, or that the dateTime argument != NULL. Defaults to NULL.
`dateTime`	Vector of length nrow(data.frame(x)) or singular character data, detailing the relevant colname in x, that denotes what dateTime information will be used. If argument == NULL, date and time arguments must be appropriately defined, OR "date and "time" columns must exist in x. Defaults to NULL.
`dateFormat`	Character string. Defines how date information is presented. Takes values "mdy" (i.e., month/day/year), "ymd" (i.e., year/month/day), "dmy" (i.e., day/month/year), or "ydm" (i.e., year/day/month). Defaults to "mdy."
`dateFake`	Logical. If TRUE, the function will assign fake date information, beginning 01/01/startYear, to each of the timestamps. Defaults to FALSE.
`startYear`	Numerical. Denotes what year fake date information will begin if dateFake == TRUE. Defaults to 2000.
`tz.in`	Character. Identifies the timezone associated with the time/dateTime argument input. Defaults to "UTC." Timezone names often take the form "Country/City." See the listing of timezones at: http://en.wikipedia.org/wiki/List_of_tz_database_time_zones.
`tz.out`	Character. Identifies the timezone that the output dateTime information will be converted to. If NULL, tz.out will be identical to tz.in. Defaults to NULL. Timezone names often take the form "Country/City." See the listing of timezones at: http://en.wikipedia.org/wiki/List_of_tz_database_time_zones.
`month`	Logical. If TRUE, output will contain a "month" column with relevant information derived from dateTime information. Defaults to FALSE.
`day`	Logical. If TRUE, output will contain a "day" column with relevant information derived from dateTime information. Defaults to FALSE.
`year`	Logical. If TRUE, output will contain a "year" column with relevant information derived from dateTime information. Defaults to FALSE.
`hour`	Logical. If TRUE, output will contain a "hour" column with relevant information derived from dateTime information. Defaults to FALSE.
`minute`	Logical. If TRUE, output will contain a "minute" column with relevant information derived from dateTime information. Defaults to FALSE.
`second`	Logical. If TRUE, output will contain a "second" column with relevant information derived from dateTime information. Defaults to FALSE.
`daySecond`	Logical. If TRUE, output will contain a "daySecond" column with information detailing what the second of a given day the associated dateTime value corresponds to. Defaults to FALSE.
`totalSecond`	Logical. If TRUE, output will contain a "totalSecond" column with information detailing what the second of the entire data set the associated dateTime value corresponds to. Defaults to FALSE.

Output is x with new columns appended according to corresponding argmuents.

1
2
3

data("calves")
calves.dateTime<-datetime.append(calves, date = calves$date, time = calves$time) 
head(calves.dateTime) #see now that a dateTime column exists.

  calftag     x     y     time       date            dateTime
1     101 63.38 47.43 00:00:14 05-02-2016 2016-05-02 00:00:14
2     101 63.48 46.59 00:00:22 05-02-2016 2016-05-02 00:00:22
3     101 62.90 47.07 00:00:26 05-02-2016 2016-05-02 00:00:26
4     101 63.27 47.26 00:00:34 05-02-2016 2016-05-02 00:00:34
5     101 63.04 46.62 00:00:38 05-02-2016 2016-05-02 00:00:38
6     101 63.53 47.24 00:00:42 05-02-2016 2016-05-02 00:00:42