R/split.R

Defines functions split.xts

Documented in split.xts

#
#   xts: eXtensible time-series 
#
#   Copyright (C) 2008  Jeffrey A. Ryan jeff.a.ryan @ gmail.com
#
#   Contributions from Joshua M. Ulrich
#
#   This program is free software: you can redistribute it and/or modify
#   it under the terms of the GNU General Public License as published by
#   the Free Software Foundation, either version 2 of the License, or
#   (at your option) any later version.
#
#   This program is distributed in the hope that it will be useful,
#   but WITHOUT ANY WARRANTY; without even the implied warranty of
#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#   GNU General Public License for more details.
#
#   You should have received a copy of the GNU General Public License
#   along with this program.  If not, see <http://www.gnu.org/licenses/>.

split.xts <-
function(x, f="months", drop=FALSE, k=1, ...) {
  if(is.character(f) && length(f) == 1L) {
    ep <- endpoints(x, on=f, k=k)
    sp <- (ep + 1)[-length(ep)]
    ep <- ep[-1]
    out <- lapply(seq_along(ep), function(X) x[sp[X]:ep[X]])

    if(f == "secs" || f == "mins") {
      f <- substr(f, 1L, 3L)
    }
    f <- match.arg(f, c("years", "quarters", "months", "weeks", "days", "hours",
    "minutes", "seconds", "milliseconds", "microseconds", "ms", "us"))

    obs.for.names <- index(x)[sp]
    outnames <-
      switch(f,
             "years"    = format(obs.for.names, "%Y"),
             "quarters" = as.character(as.yearqtr(as.POSIXlt(obs.for.names))),
             "months"   = format(obs.for.names, "%b %Y"),
             "weeks"    = format(obs.for.names, "%Y-%m-%d"),
             "days"     = format(obs.for.names, "%Y-%m-%d"),
             "hours"    = format(obs.for.names, "%Y-%m-%d %H:00:00"),
             "minutes"  = format(obs.for.names, "%Y-%m-%d %H:%M:00"),
             "seconds"  = format(obs.for.names, "%Y-%m-%d %H:%M:%S"),
             "milliseconds" = ,
             "ms" = format(obs.for.names, "%Y-%m-%d %H:%M:%OS3"),
             "microseconds" = ,
             "us" = format(obs.for.names, "%Y-%m-%d %H:%M:%OS6"))
    setNames(out, outnames)
  } else
  NextMethod("split")
}
joshuaulrich/xts documentation built on March 9, 2024, 2:50 a.m.