Skip to content
This repository
branch: master
Fetching contributors…

Octocat-spinner-32-eaf2f5

Cannot retrieve contributors at this time

file 395 lines (254 sloc) 14.015 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395
Version 1.3.3
-------------------------------------------------------------------------

DEVELOPMENT

* New low level C parser for numeric formats and two new front-end R functions
  parse_date_time2 and fast_strptime. The achieved speed up is 50-100x as
  compared to standard as.POSIXct and strptime functions.

  The user level parser functions of ymd_hms family drop to these C routines
  whenever plain numeric formats are detected.

BUG FIXES

* olson_time_zones now supports Solaris OS
* infinite recursion on parsing non-existing leap times was fixed

Version 1.3.2
-------------------------------------------------------------------------

DEVELOPMENT

* Lubridate's s4 methods no longer use the representation argument, which has been deprecated in R 3.0.0 (see ?setClass). As a result, lubridate is no longer backwards compatible with R <3.0.0.



Version 1.3.1
-------------------------------------------------------------------------


Version 1.3.0
-------------------------------------------------------------------------

DEVELOPMENT

* v1.3.0. treats math with month and year Periods more consistently. If adding
or subtracting n months would result in a non-existent date, lubridate will
return an NA instead of a day in the following month or year. For example,
`ymd("2013-01-31") + months(1)` will return `NA` instead of `2013-03-04`
as in v1.2.0. `ymd("2012-02-29") + years(1)` will also return an `NA`. This
rule change helps ensure that date + timespan - timespan = date (or NA). If
you'd prefer that such arithmetic just returns the last day of the resulting
month, see `%m+%` and `%m-%`.

* update.POSIXct and update.POSIXlt have been rewritten to be 7x faster than
their versions in v1.2.0. The speed gain is felt in `force_tz`, `with_tz`,
`floor_date`, `ceiling_date`, `second<-`, `minute<-`, `hour<-`, `day<-`,
`month<-`, `year<-`, and other functions that rely on update (such as math with
Periods).

* lubridate includes a Korean translation provided by
http://korea.gnu.org/gnustats/


NEW FEATURES

* lubridate parser and stamp functions now handle ISO8601 date format (e.g.,
2013-01-24 19:39:07.880-06:00, 2013-01-24 19:39:07.880Z)

* lubridate v1.3.0 comes with a new R vignette. see
`browseVignettes("lubridate")` to view it.

* The accessors `second`, `minute`, `hour`, `day`, `month`, `year` and the
settors `second<-`, `minute<-`, `hour<-`, `day<-`, `month<-`, `year<-` now
work on Period class objects

* users can control which messages lubridate returns when parsing and estimating
with the global option lubridate.verbose. Run
`options(lubridate.verbose = TRUE)` to turn parsing messages on. Run
`options(lubridate.verbose = FALSE)` to turn estimation and coercion messages
off.

* lubridate parser functions now propagate NA's just as as.POSIXct, strptime and
other functions do. Previously lubridate's parse functions would only return an
error.

* added [[ and [[<- methods for INterval, Period and Duration class objects

* added `%m+%` and `%m-%` methods for Interval and Duration class objects that
throw useful errors.

* `olson_time_zones` retreives a character vector is Olson-style time zone names
to use in lubridate

* summary methods for Interval, Period, and Duration classes

* date_decimal converts a date written as a decimal of a year into a POSIXct
date-time

BUG FIXES

* fixed bug in way update.POSIXct and update.POSIXlt handle dates that occur in
the fall daylight savings overlap. update will choose the date-time closest to
the original date time (on the timeline) when two identical clock times exist
due to the DST overlap.

* fixed bugs that created unintuitive results for `as.interval`, `int_overlaps`, `%within%` and the interval methods of `c`, `intersect`, `union`, `setdiff`, and `summary`.

* parse functions, `as.interval`, `as.period` and `as.duration` now handle
vectors of NA's without returning errors.

* parsers better handle vectors of input that have more than 100 elements and
many NAs

* data frames that contain timespan objects with NAs in thme no longer fail to
print

* `round_date`, `ceiling_date` and `update` now correctly handle input of length
zero

* `decimal_date` no longer returns NaN for first second of the year


Version 1.2.0
-------------------------------------------------------------------------
DEVELOPMENT

* lubridate 1.2.0 is significantly faster than lubridate 1.1.0. This is
largely thanks to a parser rewrite submitted by Vitalie Spinu. Thank you,
Vitalie. Some metrics:
  - parser speed up - 60x faster
  - `with_tz` speed up - 15x faster
  - `force_tz` speed up - 3x faster

* Development for 1.2.0 has also focused on improving the way we work with
months. `rollback` rolls dates back to the last day of the previous month.
provides more options for working with months. `days_in_month` finds the
number of days in a date's month. And, `%m+%` and `%m-%` provide a new way to
handle unequal month lengths while doing arithmetic. See NEW FEATURES for more
details

* date parsing can now parse multiple date formats within the same vector of
date-times. Parsing can also recognize a greater variety of date-time formats
as well as incomplete (truncated) date-times. Contributed by Vitalie Spinu.
Thank you, Vitalie.

* 1.2.0 introduces a new display format for periods. The display is more math
and international friendly.

* 1.2.0 transforms negative intervals into periods much more gracefully (e.g, -
 3 days instead of -1 years, 11 months, and 27 days)

* S3 update methods are now exported

NEW FEATURES

* `stamp` allows users to print dates in whatever form they like. Contributed
by Vitalie Spinu. Thank you, Vitalie.

* periods now handle fractional seconds. Contributed by Vitalie Spinu. Thank
you, Vitalie.

* date parsing can now parse multiple date formats within the same vector of
date-times. Parsing can also recognize a greater variety of date-time formats
as well as incomplete (truncated) date-times. Contributed by Vitalie Spinu.
Thank you, Vitalie.

* `sort`, `order`, `rank` and `xtfrm` now work with periods

* `as.period.Interval` accepts a unit argument. `as.period` will convert
intervals into periods no larger than the supplied unit.

* `days_in_month` takes a date, returns the number of days in the date's month.
 Contributed by Richard Cotton. Thank you, Richard.

* `%m+%` and `%m-%` perform addition and subtraction with months (and years)
without rollover at the end of a month. These can be used in place of + and -.
These can't be used with periods smaller than a month, which should be handled
separately. An example of the new behavior:

    ymd("2010-01-31") %m+% months(1)
    # "2010-02-28 UTC"
    
    ymd("2010-01-31") + months(1)
    # "2010-03-03 UTC"

    ymd("2010-03-31") %m-% months(1)
    # "2010-02-28 UTC"
    
    ymd("2010-01-31") - months(1)
    # "2010-03-03 UTC"

* `rollback` rolls a date back to the last day of the previous month.

* `quarter` returns the fiscal quarter that a date occurs in. Like `quartes`
in base R, but returns a numeric instead of a character string.

BUG FIXES

* date parsers now handle NAs

* periods now handle NAs

* `[<-` now correctly updates all elements of a period inside a vector, list,
or data.frame

* `period()` now works with unit = "weeks"

* `ceiling_date` no longer rounds up if a date is already at a ceiling

* the redundant (i.e, repeated) hour of fall daylight savings time now
displays with the correct time zone

* `update.POSIXct` and `update.POSIXlt` handle vectors that sum to zero in the
days argument

* the format method for periods, intervals and duration now accurately
displays objects of length 0.




Version 1.1.0
-------------------------------------------------------------------------
DEVELOPMENT

* lubridate no longer overwrites base R methods for +, - , *, /, %%, and %/%.
To recreate the previous experience of subtracting two date times to create an
interval, we've added the interval creation function %--%.

* lubridate has moved to an S4 object system. Timespans, Intervals, Durations,
and Periods have each been redefined as an S4 class with its own methods.

* arithmetic operations will no longer perform implicit class changes between
timespans. Users must explicitly state how and when they wish class changes to
occur with as.period(), as.duration(), and as.interval(). This makes code
written with lubridate more robust, as such implicit changes often did not
produce consistent behavior across a variety of operations. It also allows
lubridate to be less chatty with fewer console messages. lubridate does not
need to explain what it is doing, because it no longer attempts to do things
whose outcome would not be clear. On the other hand, arithmetic between
multiple time classes will produce informative error messages.

* the internal structure of lubridate R code has been reorganized at
https://github.com/hadley/lubridate to make lubridate more development friendly.


NEW FEATURES

* intervals are now more useful and lubridate has more ways to manipulate them.
Intervals can be created with %--%; modified with int_shift(), int_flip(), and
int_standardize(); manipulated with intersect(), union(), and setdiff(); and
used in logical tests with int_aligns(), int_overlaps(), and %within%.
lubridate will no longer perform arithmetic between two intervals because the
correct results of such operations is no more obvious than the correct result
of adding two dates. Instead users are encouraged to use the new set
operations or to directly modify intervals with int_start() and int_end(),
which can also be used as settors. lubridate now supports negative intervals
as well as positive intervals. Intervals also now display with a time zone.

* Modulo methods for timespans have been changed to return a timespan. this
allows modulo methods to be used with integer division in an intuitive manner,
e.g.

a = a %/% b * b + a %% b

Users can still acheive a numerical result by using as.numeric() on input
before performing modulo.

* Periods, durations, and intervals can now all be put into a data frame.

* Periods, durations, and intervals can be intuitively subset with $ and [].
These operations also can be used as settors with <-.

* The parsing functions and the as.period method for intervals are now
slightly faster.

* month<- and wday<- settors accept names as well as numbers

* parsing functions now have a quiet argument to parse without messages and a
tz argument to directly parse times into the desired time zone.

* logical comparison methods now work for period objects.

Version 0.2.6
-------------------------------------------------------------------------

* use `test_package` to avoid incompatibility with current version of
  `testthat`
  
* other minor fixes to pass `R CMD check`

Version 0.2.5
-------------------------------------------------------------------------

* added ymdThms() for parsing ISO 8061 formatted combned dates and times

BUG FIXES

* removed bug in parsing dates with "T" in them

* modified as.period.interval() to display periods in positive units

Version 0.2.4
-------------------------------------------------------------------------

* Add citations to JSS article

Version 0.2.3
-------------------------------------------------------------------------
NEW FEATURES

* ymd_hms(), hms(), and ms() functions can now parse dates that include
decimal values in the seconds element.

* milliseconds(), microseconds(), nanoseconds(), and picoseconds() create
period objects of the specified lengths. dmilliseconds(), dmicroseconds(),
dnanoseconds(), and dpicoseconds() make duration objects of the specified
lengths.


BUG FIXES

* lubridate no longer overwrites months(), start(), and end() from base R.
Start and end have been replaced with int_start() and int_end().

* lubridate imports plyr and stringr packages, instead of depending on them.

Version 0.2.2
-------------------------------------------------------------------------
NEW FEATURES

* made division, modulo, and integer division operations compatible with
difftimes

* created c() methods for periods and durations


BUG FIXES

* fixed bug in division, modulo, and integer operations with timespans


Version 0.2.1
-------------------------------------------------------------------------

NEW FEATURES

* created parsing functions ymd_hm ymd_h dmy_hms dmy_hm dmy_h mdy_hms mdy_hm
mdy_h ydm_hms ydm_hm ydm_h, which operate in the same way as ymd_hms().

BUG FIXES

* fixed bug in add_dates(). duration objects can now be successfully added to
numeric objects.


Version 0.2
-------------------------------------------------------------------------

NEW FEATURES

* division between timespans: each timespan class (durations, periods,
intervals) can be divided by other timespans. For example, how many weeks are
there between Halloween and Christmas?: (christmas - halloween) / weeks(1)
  
* modulo operations between timespans

* duration objects now have their own class and display format separate from
difftimes

* interval objects now use an improved data structure and have a cleaner
display format

* lubridate now loads its own namespace

* math operations now automatically coerce interval objects to duration objects.
Allows intervals to be used "right out of the box" without error messages.
  
* created start() and end() functions for accessing and changing the boundary
date-times of an interval


* rep() methods for periods, intervals, and durations



MINOR CHANGES

* added a package help page with functions listed by purpose

* eseconds(), eminutes(), etc. are aliased to dseconds(), dminutes(), etc. to
make it easier to remember they are duration objects.
  
* changed leap.years() to leap_years() to maintain consistent naming scheme



BUG FIXES

* rewrote as.period() to create only positive periods.

* fixed rollover bug in update.POSIXct()

* edited make_diff() to display in days when approporiate, not weeks
Something went wrong with that request. Please try again.