as_tod: Convert datetime to time-of-day

In SunCalcMeeus: Sun Position and Daylight Calculations

Convert datetime to time-of-day

Description

Convert a datetime into a time of day expressed in hours, minutes or seconds from midnight in local time for a time zone. This conversion is useful when time-series data for different days needs to be compared or plotted based on the local time-of-day.

Usage

as_tod(x, unit.out = "hours", tz = NULL)

Arguments

x	a datetime object accepted by lubridate functions.
unit.out	character string, One of "tod_time", "hours", "minutes", or "seconds".
tz	character string indicating time zone to be used in output.

Value

A numeric vector of the same length as x. If unit.out = "tod_time" an object of class "tod_time" which a numeric vector as with unit.out = "hours" but with the class attribute set to "tod_time", which dispatches to special format() and print() methods.

See Also

solar_time

Other Time of day functions: format.tod_time(), print.tod_time()

Examples

library(lubridate)
my_instants <- ymd_hms("2020-05-17 12:05:03") + days(c(0, 30))
my_instants
as_tod(my_instants)
as_tod(my_instants, unit.out = "tod_time")

SunCalcMeeus documentation built on April 4, 2025, 1:43 a.m.