Data.Time.Solar

This module contains basic solar calculation functions. It is based on the methods found at https://www.esrl.noaa.gov/gmd/grad/solcalc/calcdetails.html

Accordingly, the same caveats apply. This method is therefore only accurate for dates between 1901 and 2099. The sunrise and sunset results are theoretically accurate to within a minute for locations between +/- 72° latitude, and within 10 minutes outside of those latitudes.

Documentation

data Location

Constructors

Location

Fields

• latitude :: Double
• longitude :: Double

Instances

Eq Location

Defined in Data.Time.Solar

Methods

(==) :: Location -> Location -> Bool

(/=) :: Location -> Location -> Bool

Ord Location

Defined in Data.Time.Solar

Methods

compare :: Location -> Location -> Ordering

(<) :: Location -> Location -> Bool

(<=) :: Location -> Location -> Bool

(>) :: Location -> Location -> Bool

(>=) :: Location -> Location -> Bool

max :: Location -> Location -> Location

min :: Location -> Location -> Location

Read Location

Defined in Data.Time.Solar

Methods

readsPrec :: Int -> ReadS Location

readList :: ReadS [Location]

readPrec :: ReadPrec Location

readListPrec :: ReadPrec [Location]

Show Location

Defined in Data.Time.Solar

Methods

showsPrec :: Int -> Location -> ShowS

show :: Location -> String

showList :: [Location] -> ShowS

solarNoon :: ZonedTime -> Location -> ZonedTime

Return the time of solar noon in a given timezone for a given day, at a given location. Solar noon is the moment when the sun contacts the observer's meridian, reaching its highest position above the horizon on that day.

solarMidnight :: ZonedTime -> Location -> ZonedTime

Return the time of solar midnight, opposite of solarNoon. Note that this will return the next solar midnight!

sunrise :: ZonedTime -> Location -> ZonedTime

Determine the time of sunrise relative to a zoned time, at a given location.

sunset :: ZonedTime -> Location -> ZonedTime

Determine the time of sunset relative to a zoned time, at a given location.

sunlightDuration :: ZonedTime -> Location -> DiffTime

Duration of sunlight on a given date and location.

hourAngle :: ZonedTime -> Location -> Double

Return hour angle, one of the coordinates used in the equatorial coordinate system to give the direction of a point on the celestial sphere. Given in degrees.

trueSolarTime :: ZonedTime -> Location -> DiffTime

Time of day at a given location as measured by the movement of the sun, given as time after midnight.

solarZenithAngle :: ZonedTime -> Location -> Double

The solar zenith angle is the angle between the zenith and the centre of the Sun's disc. Given in degrees.

solarElevationAngle :: ZonedTime -> Location -> Double

The solar elevation angle is the altitude of the Sun, the angle between the horizon and the centre of the Sun's disc. Given in degrees. Complimentary to solarZenithAngle.

Local Solar Time

solarNoonLST :: ZonedTime -> Location -> Double

Solar Noon given in local solar time.

sunriseLST :: ZonedTime -> Location -> Double

Sunrise given in local solar time.

sunsetLST :: ZonedTime -> Location -> Double

Sunset given in local solar time.

Re-Export

data ZonedTime

A local time together with a time zone.

Constructors

ZonedTime

Fields

• zonedTimeToLocalTime :: LocalTime
• zonedTimeZone :: TimeZone

Instances

Data ZonedTime

Defined in Data.Time.LocalTime.Internal.ZonedTime

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> ZonedTime -> c ZonedTime

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c ZonedTime

toConstr :: ZonedTime -> Constr

dataTypeOf :: ZonedTime -> DataType

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c ZonedTime)

dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c ZonedTime)

gmapT :: (forall b. Data b => b -> b) -> ZonedTime -> ZonedTime

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> ZonedTime -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> ZonedTime -> r

gmapQ :: (forall d. Data d => d -> u) -> ZonedTime -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> ZonedTime -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> ZonedTime -> m ZonedTime

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> ZonedTime -> m ZonedTime

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> ZonedTime -> m ZonedTime

Show ZonedTime

Defined in Data.Time.LocalTime.Internal.ZonedTime

Methods

showsPrec :: Int -> ZonedTime -> ShowS

show :: ZonedTime -> String

showList :: [ZonedTime] -> ShowS

NFData ZonedTime

Defined in Data.Time.LocalTime.Internal.ZonedTime

Methods

rnf :: ZonedTime -> ()

FormatTime ZonedTime

Defined in Data.Time.Format

Methods

formatCharacter :: Char -> Maybe (TimeLocale -> Maybe NumericPadOption -> Maybe Int -> ZonedTime -> String)

ParseTime ZonedTime

Defined in Data.Time.Format.Parse

Methods

buildTime :: TimeLocale -> [(Char, String)] -> Maybe ZonedTime