convert_dtc_to_dt: Convert a Date Character Vector into a Date Object
In epijim/admiral: ADaM in R Asset Library

Description Usage Arguments Value Author(s) Examples

Convert a date character vector (usually '–DTC') into a Date vector (usually '–DT').

convert_dtc_to_dt(
  dtc,
  date_imputation = NULL,
  min_dates = NULL,
  max_dates = NULL,
  preserve = FALSE
)

`dtc`	The –DTC date to convert. A character date is expected in a format like yyyy-mm-dd or yyyy-mm-ddThh:mm:ss. A partial date will return a NA date and a warning will be issued: 'All formats failed to parse. No formats found.'. Note: you can use impute_dtc function to build a complete date.
`date_imputation`	The value to impute the day/month when a datepart is missing. If `NULL`: no date imputation is performed and partial dates are returned as missing. Otherwise, a character value is expected, either as a format with month and day specified as `"mm-dd"`: e.g. `"06-15"` for the 15th of June, or as a keyword: `"FIRST"`, `"MID"`, `"LAST"` to impute to the first/mid/last day/month. Default is `NULL`.
`min_dates`	Minimum dates A list of dates is expected. It is ensured that the imputed date is not before any of the specified dates, e.g., that the imputed adverse event start date is not before the first treatment date. Only dates which are in the range of possible dates of the `dtc` value are considered. The possible dates are defined by the missing parts of the `dtc` date (see example below). This ensures that the non-missing parts of the `dtc` date are not changed. For example impute_dtc( "2020-11", min_dates = list( ymd_hms("2020-12-06T12:12:12"), ymd_hms("2020-11-11T11:11:11") ), date_imputation = "first" ) returns `"2020-11-11T11:11:11"` because the possible dates for `"2020-11"` range from `"2020-11-01T00:00:00"` to `"2020-11-30T23:59:59"`. Therefore `"2020-12-06T12:12:12"` is ignored. Returning `"2020-12-06T12:12:12"` would have changed the month although it is not missing (in the `dtc` date).
`max_dates`	Maximum dates A list of dates is expected. It is ensured that the imputed date is not after any of the specified dates, e.g., that the imputed date is not after the data cut off date. Only dates which are in the range of possible dates are considered.
`preserve`	Preserve day if month is missing and day is present For example `"2019---07"` would return `"2019-06-07` if `preserve = TRUE` (and `date_imputation = "MID"`). Permitted Values: `TRUE`, `FALSE` Default: `FALSE`