Parse datetimes

Convert character, numeric, integer, or POSIXct datetimes to POSIXct.

parseDatetime(
  datetime = NULL,
  timezone = NULL,
  expectAll = FALSE,
  isJulian = FALSE,
  quiet = TRUE
)

Arguments

datetime: Vector of character, numeric, integer, or POSIXct datetimes.
timezone: Olson timezone used to interpret incoming datetimes.
expectAll: Logical value specifying whether to stop if any non-missing input values fail to parse.
isJulian: Logical value specifying whether datetime should be interpreted as a Julian date using day-of-year notation.
quiet: Logical value passed to lubridate::parse_date_time() to suppress parsing warnings.

Value

A POSIXct vector.

Details

This function accepts a variety of compact date/time formats commonly used in Mazama Science packages, including Y, Ym, Ymd, YmdH, YmdHM, and YmdHMS. Inputs may be mixed within the same vector.

Examples of equivalent inputs include:


20181012130900
"2018-10-12-13-09-00"
"2018 Oct. 12 13:09:00"

All incoming datetimes are interpreted in the specified timezone. If datetime is already POSIXct, it is converted to the requested timezone with lubridate::with_tz().

If a character datetime includes signed offset information, such as "-07:00", that offset is used by lubridate::parse_date_time() when determining the equivalent instant.

Mazama Science conventions

Within Mazama Science packages, datetimes not already in POSIXct format are often represented as compact decimal values with no separators, such as 20181012 or 20181012130900, either as numbers or strings.

Implementation

parseDatetime() is a wrapper around lubridate::parse_date_time() that defines the datetime formats supported by MazamaCoreUtils.

Examples