NEWS.md

In datetimeoffset: Datetimes with Optional UTC Offsets and/or Heterogeneous Time Zones

datetimeoffset 1.0.0

Bumps required {clock} version to version 0.7.3 (#64).

datetimeoffset 0.4.1

New features

• format_iso8601()'s mode argument now supports "toml" for outputting datetimes using the subset of ISO 8601 supported by TOML v1.0.0 (#60).

Bug fixes and minor improvements

• as_datetimeoffset.character() can now parse ISO 8601 times without associated dates (#59).
• format() and format_iso8601() can now format times without associated dates (#59).
• format_edtf() now truncates the number of subsecond digits according to the subsecond_digits field.
• New get_tz.Date() S3 method which returns NA_character_ for "Date" objects (#62).
• Stops using functions deprecated in {clock} v0.7.0.

datetimeoffset 0.3.1

New features

• format_pdfmark() has new argument prefix that supports "D:" or "" (#57).
• If you have a version of {clock} whose as_sys_time() method has an ... argument then the registered S3 method for datetimeoffset() objects now supports arguments ambiguous, nonexistent, and fill (#33).

datetimeoffset 0.2.1

New features

• format_exiftool() formats datetime strings as expected by the command-line tool exiftool (#54).
• as_datetimeoffset.integer() and as_datetimeoffset.numeric() coerce numeric values as the new datetimeoffset() objects year field (#53).

Bug fixes and minor improvements

• format_iso8601() has new argument mode which supports "normal" and "xmp".

• XMP metadata datetimes are a strict subset of ISO 8601 datetimes

• as_datetimeoffset.character() now parses pdfmark datetimes of the form D:YYYYmmddHHMMSSZ00'00' (#56)

• Skip a test on CRAN which was failing on r-oldrel-windows-ix86+x86_64 (#52)

datetimeoffset 0.1.2

Initial features

• datetimeoffset() objects

• A {vctrs} "record" object that supports datetimes with optional UTC offsets and/or (possibly heteregeneous) time zones

  • Suitable for use as a column in data frames and tibbles
  • Separate {vctrs} accessible record "fields" for year, month, day, hour, minute, second, nanosecond, hour_offset, minute_offset, and time zone all of which can be missing except year and can all be accessed by {clock} (style) accessor functions. If suggested {lubridate} is installed can also use {lubridate} accessors/extractors.
  • Non-missing time zones need not all be the same value

• Supports lossless import/export of pdfmark datetime strings and a decent subset of ISO 8601 datetime strings even when datetime elements are unknown

• as_datetimeoffset() converts from standard datetime strings and from other R datetime objects:

• All pdfmark datetime strings

• Decent subset of ISO 8601 datetime strings

  • Also supports the extension of specifying a named time zone at the end surrounded in brackets.

• The datetime strings understood by the default tryFormats of as.POSIXlt()

• Date() objects
• POSIXct() objects
• POSIXlt() objects
• nanotime::nanotime() objects
• parttime::parttime() objects
• five {clock} calendars and three {clock} times

• Any other datetime objects with an as.POSIXct() method

• Support for formatting output strings:

• format() returns RFC 3339 with de facto time zone extension strings

• format_edtf() returns Extended Date Time Format (EDTF) strings

  • Supports unofficial extensions of "Unspecified Digit" feature to time components and time zones
  • format_edtf(x, precision = "nanosecond", usetz = TRUE) prints out all information

• format_iso8601() and lubridate::format_ISO8601() returns ISO 8601 strings

• format_pdfmark() returns pdfmark datetimes strings

• format_nanotime() allows CCTZ style formatting

  • Can output SQL Server / ODBC datetime literals

• format_strftime() allows base::strftime() style formatting

• Support for converting to other R datetime objects:

• as.Date() and as_date() converts the local date to a base::Date() object

• as.POSIXct() and as_date_time() converts the datetime to a base::POSIXct() object
• as.POSIXlt() converts the datetime to a base::POSIXlt() object
• as.nanotime() converts the datetime to a nanotime::nanotime() object
• as.parttime() converts the datetime to a parttime::parttime() object

• {clock} calendars, times, and weekdays:

  • as_iso_year_week_day(), as_year_day(), as_year_month_day(), as_year_month_weekday(), as_year_quarter_day()
  • as_naive_time(), as_sys_time(), as_zoned_time()
  • as_weekday()

• Support for several accessor S3 methods from {clock}

• get_year() and set_year()

• get_month() and set_month()
• get_day() and set_day()
• get_hour() and set_hour()
• get_minute() and set_minute()
• get_second() and set_second()

• get_nanosecond() and set_nanosecond()

• Support for several accessor methods from {lubridate}

• year() and year()<-

• month() and month()<-
• day() and day()<-
• hour() and hour()<-
• minute() and minute()<-
• second() and second()<-

• tz() and tz()<-

• New accessor S3 methods:

• get_subsecond_digits() and set_subsecond_digits()

• get_hour_offset() and set_hour_offset()
• get_minute_offset() and set_minute_offset()

• get_tz() and set_tz() (changes system time, not clock time)

• Get/set datetime "precision" S3 methods

• datetime_cast()

• datetime_narrow()
• datetime_precision()

• datetime_widen()

• Additional subsecond accessors

• get_millisecond() and set_millisecond()

• get_microsecond() and set_microsecond()

• get_subsecond() and set_subsecond()

• Other utilities:

• datetimeoffset_now() returns the current time in the corresponding time zone(s).

• is_datetimeoffset() and NA_datetimeoffset_
• fill_tz() and fill_utc_offsets() fill in missing time zones and missing UTC offsets respectively.
• mode_tz() is an S3 method that gets most common time zone for a datetime object
• datetime_at_tz() can be used to change the timezone (changes clock time, not system time).
• get_utc_offsets() and set_utc_offsets() gets/sets UTC offset strings
• Support for {clock} invalid datetime methods invalid_detect(), invalid_any(), invalid_count(), invalid_remove(), and invalid_resolve().
• precision_to_int() converts datetime precisions to an integer
• Support for {base} datetime extractors weekdays(), months(), quarters(), and julian()
• Support for {lubridate} datetime extractors date(), date()<-, isoyear(), epiyear(), quarter(), semester(), week(), isoweek(), epiweek(), qday(), qday<-(), wday(), wday<-(), yday(), yday<-(), am(), pm(), days_in_month(), dst(), and leap_year().
• Support for {lubridate} force_tz() and with_tz().

datetimeoffset documentation built on April 4, 2025, 4:42 a.m.