Make working with dates in R just that little bit easier
GPL-3.0 License
Bot releases are visible (Hide)
Published by vspinu over 1 year ago
as_datetime()
accepts multiple formats in format argument, just like as_date()
does.ymd_hm
on locales where p
format is not defined.as_date("character")
to work correctly with formats that include extra characters.make_dateime()
when units exceed their maximal values.Published by vspinu almost 2 years ago
roll
argument to updating and time-zone manipulation functions is deprecated in favor of a new roll_dst
parameter.as_date
with character inputs accepts multiple formats in format
argument. When format
is supplied, the input string is parsed with parse_date_time
instead of the old strptime
.as.integer
method for Duration, Period and Interval classes.year<-
, month<-
etc. accessors truly generic. In order to make them work with arbitrary class XYZ, it's enough to define a reclass_date.XYZ
method.year<-
, month<-
etc. accessors for data.table
's IDate and ITime objects.week_start
argument in all lubridate functions now accepts full and abbreviated names of the days of the week.wday<-
can be a string either in English or as provided by the current locale.unit
argument for rounding to a vector of date-times.as.duration
now allows for full roundtrip duration -> as.character -> as.duration
stamp
gained new argument exact=FALSE
to indicate whether orders
argument is an exact strptime formats string or not.%within
method with signature (Interval, list), which was documented but not implemented.format_ISO8601()
gained a new option usetz="Z"
to format time zones with a "Z" and convert the time to the UTC time zone.Period
objects in rounding functions is explicitly documented.%within%
now correctly works with flipped intervalsas_datetime()
now preserves the time zone of the POSIXt input.fast_strptime()
and parse_date_time2()
now have a recycled isdst
field.train
argument in parse_date_time
now takes effect. It was previously ignored.c.POSIXct
and c.Date
on empty single POSIXct and Date vectors.POSIXct
,POSIXlt
) heterogeneous concatenation.j
now works on numeric inputs.stamp()
now correctly errors when no formats could be guessed.tzs = "UTC"
) now returns a POSIXct.lubridate
is now relying on timechange
package for update and time-zone computation. Google's CCTZ code is no longer part of the package.lubridate
's updating logic is now built on top of timechange
package.c.Period
, c.Duration
and c.Interval
from S4 to S3.Published by vspinu over 3 years ago
fast_strptime()
and parse_date_time2()
now accept multiple formats and apply them in turn%z
formatPublished by vspinu over 4 years ago
Published by vspinu over 4 years ago
dyears(1) == years(1)
is now TRUE
.dmonths()
to complement other duration constructors.duration()
constructor now accepts months
and years
arguments.format_ISO8601()
methods.as_date()
now ignores the tz
argumentforce_tz()
, with_tz()
, tz<-
convert dates to date-timesNA_Date_
and NA_POSIXct_
which parallel built-in primitive constants.Date()
and POSIXct()
which parallel built-in primitive constructors.as_datetime()
always returns a POSIXct()
generics
dependency package.-
.%within%
throws more meaningful messages when applied on unsupported classesfiscal_start
s.leap_year()
works with objects supported by year()
.duration()/period()/make_difftime()
work with repeated unitsc.Period
concatenation doesn't fail with empty components.exact = TRUE
argument in parse_date_time2
, which was so far ignored.Published by vspinu over 6 years ago
%within%
now accepts a list of intervals, in which case an instant is checked if it occurs within any of the supplied intervals.%%
on intervals relies on %m+
arithmetic and doesn't produce NAs when intermediate computations result in non-existent dates.tz()
always returns "UTC" when tzone
attribute cannot be inferred.Published by vspinu over 6 years ago
Published by vspinu over 6 years ago
interval
constructor accepts start and end character vectors in ISO 8601 formatPublished by vspinu almost 7 years ago
force_tzs
for "enforcement" of heterogeneous time zones.local_time
for the retrieval of local day time in different time zones.cutoff_2000
for parsing functions to indicate 20th century cutoff for y
format.week_start
parameter in wday
and wday<-
to set week start.locale
in wday
. Labels of the returned factors (when label=TRUE
) now respect current locale.locale
in month
. Labels of the returned factors (when label=TRUE
) now respect current locale.quarter
gained a new argument fiscal_start
to address the issue of different fiscal conventions.epiweek
and epiyear
.week_start
to floor_date
, ceiling_date
and round_date
.season
is now supported.as_date
and as_datetime
now understand character vectors.parse_date_time
- train=TRUE
and drop=FALSE
which allow more refined control of the format guessing. Formats are no longer dropped in the process by default, process which resulted in surprising behavior on several occasions (#516,#308,#307).wday
and month
are now in current locale. The abbreviated labels in English locales have been changed to standard abbreviations (Tues -> Tue, Thurs -> Thu etc.).with_tz
on invalid timezone.B
and b
formats no longer match numeric months. This corresponds to the original intent, and was always documented as such.days
, dhours
, round_date
work when the methods package is not loaded.wday
work on character inputs as it is the case with all other day accessors.y
format when it's the last in format order (as in mdy
).m
and b
formats now works correctly.date()
when called with missing argument.NA
properly.make_datetime
respects tz
argument and is much faster now.day<-
, minute<-
, etc. from producing an error when length(x) is 0 (issue #517)parse_date_time
now throw warnings only for actual parsing errors (input with all NAs are silent)Published by vspinu about 8 years ago
semester
to extract semesters form date-time objects.period
and duration
constructors now accept string as first argument. Same parsing rules apply to the 'unit' parameter in rounding functions.hms
, hm
, ms
gained new argument roll=TRUE
which rolls minutes and seconds bigger than 59 towards higher units.round_date
, floor_date
and ceiling_date
now support rounding to multiple of units.yq
for parsing most common version of quarter strings.q
for parsing quarters in all lubridate parsing functions.as_datetime
to coerce to POSIXct object. A counterpart of as_date
.make_date
to produce Date objects. A counterpart of make_datetime
.ceiling_date
for Date
objects was changed to what most of the users expect. Rounding up by months now produces first day of the next months even for first day of the month.round_date
, ceiling_date
, and floor_date
now accept "quarter", "bimonth", and "halfyear" as unit
options.parse_date_time
and related functions are now deprecated.pretty.*
family of functions were renamed and are no longer exported. If you need to use them, use lubridate:::pretty_*
versions.change_on_boundary
argument in ceiling_date
does not allow for global option anymore.as.duration
, as.numeric
don't show "only estimate" messages on conversion from periods. The occasional approximate conversion is documented and deemed common knowledge.as.numeric
with unit="month"
now works on duration objects.Date
objects now return POSIXct
instead of POSIXlt
.mdy
or myd
beginning with "January"
or "Jan"
now parsing correctlyhere
and olson_time_zones
were deprecated in favor of new
and base OlsonNames
respectively.period
and duration
constructors.date_decimal
and decimal_date
.as.numeric
correctly converts periods to (approximate) numeric time lengths.Published by vspinu over 8 years ago
ceiling_date
gains new argument change_on_boundary
to allow ceiling on boundary of date-time objects.parse_date_time2
and fast_strptime
gain new lt
argument to control type of output.date
and date<-
additions to the year
, month
etc family of accessors.make_datetime
(dropin replacement of ISOdatetime
).force_tz
and with_tz
can handle data.frames component-wise.as_date
replacement of as.Date
with more intuitive behavior with non-UTC timezones.hms
parsers now handle negative components.ymd
family of functions return Date
object when tz
argument is NULL (new default) and POSIXct otherwise.base:strptime
fast_strptime
now returns POSIXlt
object. That is, its lt
argument defaults to TRUE
.interval
constructor treats timezones correctly and works with UTC whenever meaningful.as.period
correctly computes months with intervals spanning multiple years.time_length
and add_with_rollback
now work correctly with missing intervals.fast_strptime
and parse_date_time2
correctly treat non-UTC time zones.floor_date
and round_date
are not preserving tz component for larger than day unitsPublished by vspinu almost 9 years ago
This is a extensive bug fix release with no major known bugs left. The lubridate
package should be now faster, more stable and more user friendly.
There are two notable changes to the UI. First, new_zzz
style constructors, such as new_interval
, new_period
etc., were absorbed by interval
, period
etc. constructors without affecting the flexibility or backward compatibility. Second, new argument exact
to parse_date_time
allows direct specification of the formats and thus avoids guessing and training of the formats behind the scene.
time_length
method.isoyear
function to line up with isoweek
.exact = TRUE
parse_date_time
for faster and much more flexible specification ofsimple
argument to fit_to_timeline
and update
methods mostlyunique
method for interval
classpreserve_hms
and roll_to_first
in rollback
function.quarter
option in floor_date
and friends.as.list.Interval
S3 method.qday
(quarter day).new_interval
, new_period
,new_duration
, new_difftime
were deprecated in favour of the more powerfulinterval
, period
, duration
and make_difftime
functions.eseconds
, eminutes
etc. were deprecated in favour of dsecons
, dminutes
etc.test/testthat
.isodate
was replaced with a much faster parse_date_time2(paste(...))
alternativeLubridate
's trunc
,ceiling
and floor
functions have been optimised and now are relying on R'strunc.POSIXct
whenever possible.fst
objects.enc2utf8
.int_standardize
ceiling_date
skip day light gap.preproc_wday=T
.parse_date_time
.fit_to_timeline
function.isoweek
computationseconds_to_period
.$<-
assignment for periods are now properly recycled.round_date
.Published by vspinu almost 9 years ago
time-zones.R
in coercion.R
.standardise_lt_names
.as.period.period
if unit != NULL
.as.period.interval
without recurring to modulo arithmetic.hms
, hm
and ms
for new printing style.guess_formats
now matches flex regexp first.dmilliseconds
now correctly returns a Duration
object.