stri_datetime_fields: Get Values for Date and Time Fields

View source: R/time_calendar.R

stri_datetime_fieldsR Documentation

Get Values for Date and Time Fields


Computes and returns values for all date and time fields.


stri_datetime_fields(time, tz = attr(time, "tzone"), locale = NULL)



an object of class POSIXct (as.POSIXct will be called on character vectors and objects of class POSIXlt, Date, and factor)


NULL or '' for the default time zone or a single string with time zone identifier, see stri_timezone_list


NULL or '' for the current default locale, or a single string with a locale identifier; a non-Gregorian calendar may be specified by setting @calendar=name keyword


Vectorized over time.


Returns a data frame with the following columns:

  1. Year (0 is 1BC, -1 is 2BC, etc.)

  2. Month (1-based, i.e., 1 stands for the first month, e.g., January; note that the number of months depends on the selected calendar, see stri_datetime_symbols)

  3. Day

  4. Hour (24-h clock)

  5. Minute

  6. Second

  7. Millisecond

  8. WeekOfYear (this is locale-dependent)

  9. WeekOfMonth (this is locale-dependent)

  10. DayOfYear

  11. DayOfWeek (1-based, 1 denotes Sunday; see stri_datetime_symbols)

  12. Hour12 (12-h clock)

  13. AmPm (see stri_datetime_symbols)

  14. Era (see stri_datetime_symbols)


Marek Gagolewski and other contributors

See Also

The official online manual of stringi at

Gagolewski M., stringi: Fast and portable character string processing in R, Journal of Statistical Software 103(2), 2022, 1-59, doi: 10.18637/jss.v103.i02

Other datetime: stri_datetime_add(), stri_datetime_create(), stri_datetime_format(), stri_datetime_fstr(), stri_datetime_now(), stri_datetime_symbols(), stri_timezone_get(), stri_timezone_info(), stri_timezone_list()


stri_datetime_fields(stri_datetime_now(), locale='@calendar=hebrew')
   stri_datetime_fields(stri_datetime_now(), locale='@calendar=hebrew')$Month

stringi documentation built on Jan. 11, 2023, 5:18 p.m.