= tolBasis =

== Introducción ==

{{{tolBasis}}} es el paquete fundamental para la incorporación de TOL en R. Son los cimientos sobre los que se apoyan los desarrollos de TOL en R.

No necesita de una instalación de TOL para ser usado.

Incorpora los conceptos TOL a R: fechados, series temporales polinomios de retardos, etc.

== Fechas en R (clases Date y POSIXt) ==

Las fechas en R ya disponen de un soporte compatible con TOL:
 * La clase "Date" para las ''fechas enteras'' (sin horas, minutos y segundos).
 * Las clases "POSIXct" y "POSIXlt" (derivadas de "POSIXt") para los instantes temporales en general (con horas, minutos y segundos).

Para ampliar el conjunto de funcionalidades con fechas, {{{tolBasis}}} se apoya en el paquete {{{lubridate}}} de R.
Este paquete se carga automáticamnete con {{{tolBasis}}}.

Se incorpora una nueva función con el mismo nombre de la clase ("Date") a modo de ''constructora'' de fechas al estilo de TOL, es decir, indicando el año y opcionalmente el mes y el día.

Ejemplos:
{{{
#!perl
Date(2012) # equivale a y2012 en TOL
Date(2015,5,12) # equivale a y2015m05d12 en TOL
}}}

== Fechados en R (clase Dating) ==

Los fechados de TOL han sido parcialmente reimplementados en R, para poder dar un soporte a las series temporales con la misma concepción que en TOL.

Los fechados en R se implementan a través de una clase (S3) denominada "Dating".

Inicialmente sólo se han considerado los fechados con ''fechas enteras'' (sin horas, minutos y segundos). [[BR]]
Esta decisión se debe a varios motivos: 
 * La mayor sencillez de la implementación usando sólo fechas (clase "Date" en R), 
 * Las dificultades de usar instantes temporales, por la existencia de zonas horarias, cambios de hora, etc.
 * El uso más común de estos fechados (de fecha entera).

Los fechados más comunes ya están predefinidos:
 * {{{Yearly}}}, {{{Monthly}}}, {{{Weekly}}}, {{{Daily}}}. 
 [[BR]] Nótese que {{{Weekly}}} en R se refiere a los domingos (por cómo se definen las semanas en R) y no a los lunes como ocurre en TOL.
 * {{{Mondays}}}, {{{Tuesdays}}}, {{{Wednesdays}}}, {{{Thursdays}}}, {{{Fridays}}}, {{{Saturdays}}}, {{{Sundays}}}. 
 [[BR]] Corresponden a los ''timesets'' de TOL del tipo {{{W(n)}}}. Nótese que {{{Mondays}}} coincide con el fechado {{{Weekly}}} en TOL.
 * {{{Quarterly}}}, {{{HalfYearly}}}.

Para el uso de los fechados en R, se incorporan algunos métodos, siguiendo la siguiente nomenclatura: "D" (de Dating) más el nombre de la función (en minúsculas):
 * Dbelong
 * Dseq
 * Dsucc
 * Dfloor
 * Dceiling
 * Dround

Ejemplos:
{{{
#!perl
Dsucc(Sys.Date(), Monthly, 1) # próximo mes
currYear <- Dfloor(Sys.Date(), Yearly) # año en curso
Dseq(currYear, dating=Monthly, len=12) # meses del año en curso
}}}

== Series en R (clase Serie) ==

...

== Polinomios de retardos en R (clase Polyn) ==

...

== Cocientes de polinomios de retardos en R (clase Ratio) ==

...