Nothing
###################################################################
# IDate -- a simple wrapper class around Date using integer storage
###################################################################
as.IDate = function(x, ...) UseMethod("as.IDate")
as.IDate.default = function(x, ..., tz = attr(x, "tzone", exact=TRUE)) {
if (is.null(tz)) tz = "UTC"
if (is.character(x)) {
# backport of similar patch to base::as.Date.character in R 4.0.3, #4676
is.na(x) = !nzchar(x)
}
as.IDate(as.Date(x, tz = tz, ...))
}
as.IDate.numeric = function(x, origin = "1970-01-01", ...) {
if (origin=="1970-01-01") {
# standard epoch
x = as.integer(x)
class(x) = c("IDate", "Date")
# We used to use structure() here because class(x)<- copied several times in R before v3.1.0
# Since R 3.1.0 improved class()<- and data.table's oldest oldest supported R is now 3.1.0, we can use class<- again
# structure() contains a match() and replace for specials, which we don't need.
# class()<- ensures at least 1 shallow copy as appropriate is returned.
x
} else {
# only call expensive as.IDate.character if we have to
as.IDate(origin, ...) + as.integer(x)
}
}
as.IDate.Date = function(x, ...) {
x = as.integer(x) # if already integer, x will be left unchanged as the original input
class(x) = c("IDate", "Date") # class()<- will copy if as.integer() did not create, and may not if it did we hope
x # always return a new object
}
as.IDate.POSIXct = function(x, tz = attr(x, "tzone", exact=TRUE), ...) {
if (is_utc(tz))
(setattr(as.integer(as.numeric(x) %/% 86400L), "class", c("IDate", "Date"))) # %/% returns new object so can use setattr() on it; wrap with () to return visibly
else
as.IDate(as.Date(x, tz = if (is.null(tz)) '' else tz, ...))
}
as.IDate.IDate = function(x, ...) x
as.Date.IDate = function(x, ...) {
x = as.numeric(x)
class(x) = "Date"
x
}
mean.IDate =
seq.IDate =
c.IDate =
cut.IDate =
rep.IDate =
unique.IDate =
function(x, ...) {
as.IDate(NextMethod())
}
# define this [<- method to prevent base R's internal rbind coercing integer IDate to double, #2008
`[<-.IDate` = function(x, i, value) {
if (!length(value)) return(x)
value = as.integer(as.IDate(value))
setattr(x, 'class', NULL)
x[i] = value
setattr(x, 'class', c('IDate', 'Date'))
x
}
# define min and max to avoid base R's Inf with warning on empty, #2256
min.IDate = max.IDate = function(x, ...) {
as.IDate(if (!length(x)) NA else NextMethod())
}
# fix for #1315
as.list.IDate = function(x, ...) NextMethod()
# rounding -- good for graphing / subsetting
## round.IDate = function (x, digits, units=digits, ...) {
## if (missing(digits)) digits = units # workaround to provide a units argument to match the round generic and round.POSIXt
## units = match.arg(digits, c("weeks", "months", "quarters", "years"))
round.IDate = function(x, digits=c("weeks", "months", "quarters", "years"), ...) {
units = match.arg(digits)
as.IDate(switch(units,
weeks = round(x, "year") + 7L * (yday(x) %/% 7L),
months = ISOdate(year(x), month(x), 1L),
quarters = ISOdate(year(x), 3L * (quarter(x)-1L) + 1L, 1L),
years = ISOdate(year(x), 1L, 1L)))
}
#Adapted from `+.Date`
`+.IDate` = function(e1, e2) {
if (nargs() == 1L)
return(e1)
# TODO: investigate Ops.IDate method a la Ops.difftime
if (inherits(e1, "difftime") || inherits(e2, "difftime"))
stopf("Internal error -- difftime objects may not be added to IDate, but Ops dispatch should have intervened to prevent this") # nocov
if (isReallyReal(e1) || isReallyReal(e2)) {
return(`+.Date`(e1, e2))
# IDate doesn't support fractional days; revert to base Date
}
if (inherits(e1, "Date") && inherits(e2, "Date"))
stopf("binary + is not defined for \"IDate\" objects")
(setattr(as.integer(unclass(e1) + unclass(e2)), "class", c("IDate", "Date"))) # () wrap to return visibly
}
`-.IDate` = function(e1, e2) {
if (!inherits(e1, "IDate")) {
if (inherits(e1, 'Date')) return(base::`-.Date`(e1, e2))
stopf("can only subtract from \"IDate\" objects")
}
if (storage.mode(e1) != "integer")
stopf("Internal error: storage mode of IDate is somehow no longer integer") # nocov
if (nargs() == 1L)
stopf("unary - is not defined for \"IDate\" objects")
if (inherits(e2, "difftime"))
stopf("Internal error -- difftime objects may not be subtracted from IDate, but Ops dispatch should have intervened to prevent this") # nocov
if ( isReallyReal(e2) ) {
# IDate deliberately doesn't support fractional days so revert to base Date
return(base::`-.Date`(as.Date(e1), e2))
# can't call base::.Date directly (last line of base::`-.Date`) as tried in PR#3168 because
# i) ?.Date states "Internal objects in the base package most of which are only user-visible because of the special nature of the base namespace."
# ii) .Date was newly exposed in R some time after 3.4.4
}
ans = as.integer(unclass(e1) - unclass(e2))
if (!inherits(e2, "Date")) setattr(ans, "class", c("IDate", "Date"))
ans
}
###################################################################
# ITime -- Integer time-of-day class
# Stored as seconds in the day
###################################################################
as.ITime = function(x, ...) UseMethod("as.ITime")
as.ITime.default = function(x, ...) {
as.ITime(as.POSIXlt(x, ...), ...)
}
as.ITime.POSIXct = function(x, tz = attr(x, "tzone", exact=TRUE), ...) {
if (is_utc(tz)) as.ITime(unclass(x), ...)
else as.ITime(as.POSIXlt(x, tz = if (is.null(tz)) '' else tz, ...), ...)
}
as.ITime.numeric = function(x, ms = 'truncate', ...) {
secs = clip_msec(x, ms) %% 86400L # the %% here ensures a local copy is obtained; the truncate as.integer() may not copy
(setattr(secs, "class", "ITime"))
}
as.ITime.character = function(x, format, ...) {
x = unclass(x)
if (!missing(format)) return(as.ITime(strptime(x, format = format, ...), ...))
# else allow for mixed formats, such as test 1189 where seconds are caught despite varying format
y = strptime(x, format = "%H:%M:%OS", ...)
w = which(is.na(y))
formats = c("%H:%M",
"%Y-%m-%d %H:%M:%OS",
"%Y/%m/%d %H:%M:%OS",
"%Y-%m-%d %H:%M",
"%Y/%m/%d %H:%M",
"%Y-%m-%d",
"%Y/%m/%d")
for (f in formats) {
if (!length(w)) break
new = strptime(x[w], format = f, ...)
nna = !is.na(new)
if (any(nna)) {
y[ w[nna] ] = new[nna]
w = w[!nna]
}
}
as.ITime(y, ...)
}
as.ITime.POSIXlt = function(x, ms = 'truncate', ...) {
secs = clip_msec(x$sec, ms)
(setattr(with(x, secs + min * 60L + hour * 3600L), "class", "ITime")) # () wrap to return visibly
}
as.ITime.times = function(x, ms = 'truncate', ...) {
secs = 86400 * (unclass(x) %% 1)
secs = clip_msec(secs, ms)
(setattr(secs, "class", "ITime")) # the first line that creates sec will create a local copy so we can use setattr() to avoid potential copy of class()<-
}
as.character.ITime = format.ITime = function(x, ...) {
# adapted from chron's format.times
# Fix for #811. Thanks to @StefanFritsch for the code snippet
neg = x < 0L
x = abs(unclass(x))
hh = x %/% 3600L
mm = (x - hh * 3600L) %/% 60L
# #2171 -- trunc gives numeric but %02d requires integer;
# as.integer is also faster (but doesn't handle integer overflow)
# http://stackoverflow.com/questions/43894077
ss = as.integer(x - hh * 3600L - 60L * mm)
res = sprintf('%02d:%02d:%02d', hh, mm, ss)
# Fix for #1354, so that "NA" input is handled correctly.
if (is.na(any(neg))) res[is.na(x)] = NA
neg = which(neg)
if (length(neg)) res[neg] = paste0("-", res[neg])
res
}
as.data.frame.ITime = function(x, ...) {
# This method is just for ggplot2, #1713
# Avoids the error "cannot coerce class '"ITime"' into a data.frame", but for some reason
# ggplot2 doesn't seem to call the print method to get axis labels, so still prints integers.
# Tried converting to POSIXct but that gives the error below.
# If user converts to POSIXct themselves, then it works for some reason.
ans = list(x)
# ans = list(as.POSIXct(x,tzone="")) # ggplot2 gives "Error: Discrete value supplied to continuous scale"
setattr(ans, "class", "data.frame")
setattr(ans, "row.names", .set_row_names(length(x)))
setattr(ans, "names", "V1")
ans
}
print.ITime = function(x, ...) {
print(format(x))
}
rep.ITime = function(x, ...)
{
y = rep(unclass(x), ...)
class(y) = "ITime" # unlass and rep could feasibly not copy, hence use class<- not setattr()
y
}
round.ITime <- function(x, digits = c("hours", "minutes"), ...)
{
(setattr(switch(match.arg(digits),
hours = as.integer(round(unclass(x)/3600)*3600),
minutes = as.integer(round(unclass(x)/60)*60)),
"class", "ITime"))
}
trunc.ITime <- function(x, units = c("hours", "minutes"), ...)
{
(setattr(switch(match.arg(units),
hours = as.integer(unclass(x)%/%3600*3600),
minutes = as.integer(unclass(x)%/%60*60)),
"class", "ITime"))
}
"[.ITime" = function(x, ..., drop = TRUE)
{
cl = oldClass(x)
class(x) = NULL
val = NextMethod("[")
class(val) = cl
val
}
unique.ITime = function(x, ...) {
ans = NextMethod()
class(ans) = "ITime"
ans
}
# various methods to ensure ITime class is retained, #3628
mean.ITime = seq.ITime = c.ITime = function(x, ...) as.ITime(NextMethod())
# create a data.table with IDate and ITime columns
# should work for most date/time formats like POSIXct
IDateTime = function(x, ...) UseMethod("IDateTime")
IDateTime.default = function(x, ...) {
data.table(idate = as.IDate(x, ...), itime = as.ITime(x, ...))
}
# POSIXt support
as.POSIXct.IDate = function(x, tz = "UTC", time = 0, ...) {
if (missing(time) && inherits(tz, "ITime")) {
time = tz # allows you to use time as the 2nd argument
tz = "UTC"
}
if (tz == "") tz = "UTC"
as.POSIXct(as.POSIXlt(x, ...), tz, ...) + time
}
as.POSIXct.ITime = function(x, tz = "UTC", date = Sys.Date(), ...) {
if (missing(date) && inherits(tz, c("Date", "IDate", "POSIXt", "dates"))) {
date = tz # allows you to use date as the 2nd argument
tz = "UTC"
}
as.POSIXct(as.POSIXlt(date), tz = tz) + x
}
as.POSIXlt.ITime = function(x, ...) {
as.POSIXlt(as.POSIXct(x, ...))
}
clip_msec = function(secs, action) {
switch(action,
truncate = as.integer(secs),
nearest = as.integer(round(secs)),
ceil = as.integer(ceiling(secs)),
stopf("Valid options for ms are 'truncate', 'nearest', and 'ceil'.")
)
}
###################################################################
# Date - time extraction functions
# Adapted from Hadley Wickham's routines cited below to ensure
# integer results.
# https://gist.github.com/hadley/10238
# See also Hadley et al's more advanced and complex lubridate package:
# https://github.com/tidyverse/lubridate
# lubridate routines do not return integer values.
###################################################################
second = function(x) {
# if we know the object is in UTC, can calculate the hour much faster
if (inherits(x, 'POSIXct') && is_utc(attr(x, 'tzone', exact=TRUE))) return(as.integer(as.numeric(x) %% 60L))
if (inherits(x, 'ITime')) return(as.integer(x) %% 60L)
as.integer(as.POSIXlt(x)$sec)
}
minute = function(x) {
# ever-so-slightly faster than x %% 3600L %/% 60L
if (inherits(x, 'POSIXct') && is_utc(attr(x, 'tzone', exact=TRUE))) return(as.integer(as.numeric(x) %/% 60L %% 60L))
if (inherits(x, 'ITime')) return(as.integer(x) %/% 60L %% 60L)
as.POSIXlt(x)$min
}
hour = function(x) {
# ever-so-slightly faster than x %% 86400L %/% 3600L
if (inherits(x, 'POSIXct') && is_utc(attr(x, 'tzone', exact=TRUE))) return(as.integer(as.numeric(x) %/% 3600L %% 24L))
if (inherits(x, 'ITime')) return(as.integer(x) %/% 3600L %% 24L)
as.POSIXlt(x)$hour
}
yday = function(x) convertDate(as.IDate(x), "yday")
wday = function(x) convertDate(as.IDate(x), "wday")
mday = function(x) convertDate(as.IDate(x), "mday")
week = function(x) convertDate(as.IDate(x), "week")
isoweek = function(x) {
# ISO 8601-conformant week, as described at
# https://en.wikipedia.org/wiki/ISO_week_date
# Approach:
# * Find nearest Thursday to each element of x
# * Find the number of weeks having passed between
# January 1st of the year of the nearest Thursdays and x
x = as.IDate(x) # number of days since 1 Jan 1970 (a Thurs)
nearest_thurs = as.IDate(7L * (as.integer(x + 3L) %/% 7L))
year_start = as.IDate(format(nearest_thurs, '%Y-01-01'))
1L + (nearest_thurs - year_start) %/% 7L
}
month = function(x) convertDate(as.IDate(x), "month")
quarter = function(x) convertDate(as.IDate(x), "quarter")
year = function(x) convertDate(as.IDate(x), "year")
yearmon = function(x) convertDate(as.IDate(x), "yearmon")
yearqtr = function(x) convertDate(as.IDate(x), "yearqtr")
convertDate = function(x, type) {
type = match.arg(type, c("yday", "wday", "mday", "week", "month", "quarter", "year", "yearmon", "yearqtr"))
.Call(CconvertDate, x, type)
}
Any scripts or data that you put into this service are public.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.