getSunlightTimes {suncalc} | R Documentation |
Get Sunlight times
Description
Get Sunlight times
Usage
getSunlightTimes(
date = NULL,
lat = NULL,
lon = NULL,
data = NULL,
keep = c("solarNoon", "nadir", "sunrise", "sunset", "sunriseEnd", "sunsetStart",
"dawn", "dusk", "nauticalDawn", "nauticalDusk", "nightEnd", "night", "goldenHourEnd",
"goldenHour"),
tz = "UTC"
)
Arguments
date |
: |
lat |
: |
lon |
: |
data |
: |
keep |
: |
tz |
: |
Details
Available variables are :
"sunrise" : sunrise (top edge of the sun appears on the horizon)
"sunriseEnd" : sunrise ends (bottom edge of the sun touches the horizon)
"goldenHourEnd" : morning golden hour (soft light, best time for photography) ends
"solarNoon" : solar noon (sun is in the highest position)
"goldenHour" : evening golden hour starts
"sunsetStart" : sunset starts (bottom edge of the sun touches the horizon)
"sunset" : sunset (sun disappears below the horizon, evening civil twilight starts)
"dusk" : dusk (evening nautical twilight starts)
"nauticalDusk" : nautical dusk (evening astronomical twilight starts)
"night" : night starts (dark enough for astronomical observations)
"nadir" : nadir (darkest moment of the night, sun is in the lowest position)
"nightEnd" : night ends (morning astronomical twilight starts)
"nauticalDawn" : nautical dawn (morning nautical twilight starts)
"dawn" : dawn (morning nautical twilight ends, morning civil twilight starts)
Value
data.frame
See Also
getSunlightTimes, getMoonTimes, getMoonIllumination, getMoonPosition,getSunlightPosition
Examples
# one date
getSunlightTimes(date = Sys.Date(), lat = 50.1, lon = 1.83, tz = "CET")
# multiple date + subset
getSunlightTimes(date = seq.Date(Sys.Date()-9, Sys.Date(), by = 1),
keep = c("sunrise", "sunriseEnd", "sunset", "sunsetStart"),
lat = 50.1, lon = 1.83, tz = "CET")
# multiple coordinates
data <- data.frame(date = seq.Date(Sys.Date()-9, Sys.Date(), by = 1),
lat = c(rep(50.1, 10), rep(49, 10)),
lon = c(rep(1.83, 10), rep(2, 10)))
getSunlightTimes(data = data,
keep = c("sunrise", "sunriseEnd", "sunset", "sunsetStart"), tz = "CET")