Parses a character time representation to another format.

Description

Converts a character vector in a variety of forms into either the raw second, second classed as POSIXct, or days since Unix epoch.

Usage

parse.time(t="",format=c("seconds", "days", "POSIX"), tzone = 0, 
	start = NULL, startmidnight = NULL)

Arguments

Details

The function processes character vectors of the form "DATE TIME" – that is to say, a maximum of two terms separated by a space per value.

"TIME" is given in 24 hour format, seperated by colons, in "hh:mm", "hh:mm:ss", "hh:mm:ss:ms" or "hh:mm:ss.ms" format. If ommitted, the time is taken to be 00:00:00.000.

"DATE" can be a date representation as "YYYY-MM-DD", "DD/MM/YY" or "DD/MM/YYYY" (noting the use of a colon or backslash seperator to distinguish between the two). Alternatively, with start and/or startmidnight supplied, an integer "NN" or string "DOW" corresponding to a day of the week can be used instead. Then, the function will find the first timestamp matching the correct "TIME", that falls NN midnights after startmidnight and is after start, or, in the latter case, the first timestamp after the day of start that matches the appropriate day of the week. If a blank "DATE" is supplied, the function will either use the UNIX epoch, or find the first match, corresponding to the case NN = 0.

Once this is done the time is converted to the required format: POSIX is the usual R POSIXct format; days is the julian days since UNIX epoch 1970-1-1; seconds is the number of seconds (including subseconds) since 1970-1-1. Note that for formats other than POSIX, the output is in the same timezone as tzone. POSIX stores the time internally as the time in UTC, and applies a format that gives this time local to the user.

Value

A converted date-time string in the specified format. In the case of "seconds", or "days", a numeric. For POSIX, a POSIXct object.

See Also

convert.time, get.intervals

Examples

t1 = parse.time("2012-06-21 13:04:01"); print(t1)
parse.time("21/06/12 13:04:01") #gives the same result

parse.time(c("19/07/70", "20/07/70"), format = "days")
#results here will depend on your locale
parse.time(c("19/07/70", "20/07/70"), format = "POSIX", tzone = -4)

#one is the same day, one can only find a match the next day
parse.time("13:05", start = t1) - t1
parse.time("13:00", start = t1) - t1
#asking to wait 1 midnight means both times are considered as 
#times on the same, full day of data
parse.time(c("1 13:05", "1 13:00"), start = t1) - t1
#2012-06-21 is a Thursday, so this is equivalent
parse.time(c("Fri 13:05", "Fri 13:00"), start = t1) - t1
#Longer form days of the week are also understood. Note that 
#the first day does not get matched.
parse.time(c("Thursday 13:05", "Thursday 13:00"), start = t1) - t1

Results

R version 3.3.1 (2016-06-21) -- "Bug in Your Hair"
Copyright (C) 2016 The R Foundation for Statistical Computing
Platform: x86_64-pc-linux-gnu (64-bit)

R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.

R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.

Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

> library(GENEAread)
Loading required package: bitops
GENEAread 1.1.1 loaded

> png(filename="/home/ddbj/snapshot/RGM3/R_CC/result/GENEAread/parse.time.Rd_%03d_medium.png", width=480, height=480)
> ### Name: parse.time
> ### Title: Parses a character time representation to another format.
> ### Aliases: parse.time
> ### Keywords: utilities
> 
> ### ** Examples
> 
> 
> t1 = parse.time("2012-06-21 13:04:01"); print(t1)
[1] 1340283841
> parse.time("21/06/12 13:04:01") #gives the same result
[1] 1340283841
> 
> parse.time(c("19/07/70", "20/07/70"), format = "days")
[1] 199 200
> #results here will depend on your locale
> parse.time(c("19/07/70", "20/07/70"), format = "POSIX", tzone = -4)
[1] "1970-07-19 13:00:00 JST" "1970-07-20 13:00:00 JST"
> 
> #one is the same day, one can only find a match the next day
> parse.time("13:05", start = t1) - t1
[1] 59
> parse.time("13:00", start = t1) - t1
[1] 86159
> #asking to wait 1 midnight means both times are considered as 
> #times on the same, full day of data
> parse.time(c("1 13:05", "1 13:00"), start = t1) - t1
[1] 86459 86159
> #2012-06-21 is a Thursday, so this is equivalent
> parse.time(c("Fri 13:05", "Fri 13:00"), start = t1) - t1
[1] 86459 86159
> #Longer form days of the week are also understood. Note that 
> #the first day does not get matched.
> parse.time(c("Thursday 13:05", "Thursday 13:00"), start = t1) - t1
[1] 604859 604559
> 
> 
> 
> 
> 
> 
> dev.off()
null device 
          1 
>