parse_t: Parse Character Representation of Time Indices Given the...

In tind: A Common Representation of Time Indices of Different Types

Parse Character Representation of Time Indices Given the Order of Components

Description

parse_t parses character vector to create an object of tind class based on provided order(s) of time index components. Index type is inferred from components given.

Usage

parse_t(x, order, locale = NULL, type = NULL, tz = NULL)

Arguments

x	a character vector of time indices to be parsed.
order	a character string or a character vector describing order(s) of time index components in the input (x), see Details.
locale	(optional) a character value determining locale or NULL (the default, interpreted as the current system locale), see calendar-names for information on locale settings.
type	(optional) a character value determining time index type.
tz	(optional) a character value determining the time zone (the default NULL is interpreted as the system time zone). See tzone documentation for information on time zones.

Details

Accepted names of components are:

y

year.

q

quarter.

m

month, number (1–12) or name.

d

day.

j

day of year.

w

week (01–53) as defined in ISO 8601.

u

day of week, number (1–7 with Monday as the first day, ISO 8601) or name.

H

hour.

I

hour, 12-hour clock.

p

AM/PM indicator.

M

minute.

S

second.

z

UTC offset (+-HHMM, +-HH, +-HH:MM, or letter Z for UTC) or time zone abbreviation (like CET or CEST).

The following combinations of components (in any order) are accepted for different index types (whitespace between specifiers is ignored):

year (type "y"):

y.

quarter (type "q"):

y and q.

month (type "m"):

y and m.

week (type "w"):

y and w.

date (type "d"):

y, m, and d; y, and j; y, w, and u.

time of day (type "h"):

at least hour component with optional minutes and seconds.

date-time (type "t"):

any valid combination for date and at least hour component with optional minutes and seconds.

During parsing all non-digits are skipped in front of "y", "q", "w", "d", "j", "H", "I", "M", "S" specifiers and all non-alphanumeric characters are skipped in front of "m", "u", "p". Only whitespace is ignored in front of "z" specifier.

parse_t was inspired by ymd, mdy, etc. family of functions from package lubridate but independently implemented from scratch (and is a bit faster).

Value

An object of tind class.

See Also

strptind for index parsing requiring strict format specification, calendar-names for information on locale settings.

Examples

## years
# four-digit year
parse_t(as.character(1998:2002), "y")
# two-digit year
parse_t(c("98", "99", "00", "01", "02"), "y")
# mixture of four-digit and two-digit years
parse_t(c("1998", "1999", "00", "01", "02"), "y")

## quarters
parse_t(c("2020Q1", "2020Q2", "2020Q3", "2020Q4"), "yq")

## months
parse_t(c("2020-03", "2020-06", "2020-09", "2020-12"), "ym")
parse_t(c("03/20", "06/20", "09/20", "12/20"), "my")
# missing leading zeros are also handled
parse_t(c("3/20", "6/20", "9/20", "12/20"), "my")

## weeks
# standard format
parse_t(c("2020-W01", "2020-W05", "2020-W09", "2020-W13"), "yw")
# non-standard format
parse_t(c("2020, week: 01", "2020, week: 05", "2020, week: 09", "2020, week: 13"), "yw")
# missing leading zeros are also handled
parse_t(c("2020, week: 1", "2020, week: 5", "2020, week: 9", "2020, week: 13"), "yw")

## dates
# ISO format
parse_t(c("2025-03-19", "2025-06-18", "2025-09-17", "2025-12-17"), "ymd")
# US format
parse_t(c("03/19/25", "06/18/25", "09/17/25", "12/17/25"), "mdy")
# missing leading zeros are handled
parse_t(c("3/19/25", "6/18/25", "9/17/25", "12/17/25"), "mdy")
# European format
parse_t(c("19.03.2025", "18.06.2025", "17.09.2025", "17.12.2025"), "dmy")
# mixed formats
parse_t(c("03/19/25", "06/18/25", "17.09.2025", "17.12.2025"), c("mdy", "dmy"))
parse_t(c("03/19/25", "06/18/25", "2025-09-17", "2025-12-17"),  c("mdy", "ymd"))

## time of day
parse_t("13:03:34.534", "HMS")
parse_t("13:03:34", "HMS")
parse_t("13:03", "HM")
parse_t("13", "H")
parse_t("1:03:44 pm", "IMSp")
parse_t("1pm", "Ip")

## date-time
parse_t("2025-02-01 13:03:34.534", "ymdHMS")
parse_t("2025-02-01 13:03:34.534", "ymdHMS", tz = "UTC")
parse_t("02/01/25 01:03:34pm", "mdyIMSp")
parse_t("02/01/25 01:03:34pm", "mdyIMSp", tz = "UTC")

tind documentation built on Dec. 28, 2025, 1:06 a.m.