lubridate: hms – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

hms

Parse periods with hour, minute, and second components

Description

Transforms a character or numeric vector into a period object with the specified number of hours, minutes, and seconds. hms() recognizes all non-numeric characters except '-' as separators ('-' is used for negative durations). After hours, minutes and seconds have been parsed, the remaining input is ignored.

Usage

ms(..., quiet = FALSE, roll = FALSE)

hm(..., quiet = FALSE, roll = FALSE)

hms(..., quiet = FALSE, roll = FALSE)

Arguments

`...`	a character vector of hour minute second triples
`quiet`	logical. If `TRUE`, function evaluates without displaying customary messages.
`roll`	logical. If `TRUE`, smaller units are rolled over to higher units if they exceed the conventional limit. For example, `hms("01:59:120", roll = TRUE)` produces period "2H 1M 0S".

Value

a vector of period objects

Examples

ms(c("09:10", "09:02", "1:10"))
ms("7 6")
ms("6,5")
hm(c("09:10", "09:02", "1:10"))
hm("7 6")
hm("6,5")

x <- c("09:10:01", "09:10:02", "09:10:03")
hms(x)

hms("7 6 5", "3:23:::2", "2 : 23 : 33", "Finished in 9 hours, 20 min and 4 seconds")

lubridate

Make Dealing with Dates a Little Easier

v1.7.10

GPL (>= 2)

Authors

Vitalie Spinu [aut, cre], Garrett Grolemund [aut], Hadley Wickham [aut], Ian Lyttle [ctb], Imanuel Costigan [ctb], Jason Law [ctb], Doug Mitarotonda [ctb], Joseph Larmarange [ctb], Jonathan Boiser [ctb], Chel Hee Lee [ctb], Google Inc. [ctb, cph]

Initial release

hms