circadia 0.1.0

Compute sunrise/sunset times
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52


//! This module provides types for representing
//! a position on the globe.

/// Represents a position on the earth.
#[derive(Debug, Clone)]
pub struct GlobalPosition {
    latitude: f64,
    longitude: f64,
    lng_hour: f64
}

impl GlobalPosition {

    /// Create a new GlobalPosition at the
    /// given latitude and longitude
    pub fn at(lat: f64, lng: f64) -> Self {
        GlobalPosition {
            latitude: lat,
            longitude: lng,
            lng_hour: lng / 15.0
        }
    }

    /// The latitude of the position
    pub fn lat(&self) -> f64 {
        self.latitude
    }

    /// The longitude of the position
    pub fn lng(&self) -> f64 {
        self.longitude
    }

    pub(crate) fn lng_hour(&self) -> f64 {
        self.lng_hour
    }

    /// Returns a [FixedOffset] timezone calculated from
    /// this location's longitude
    ///
    /// [FixedOffset]: chrono::FixedOffset
    pub fn lng_timezone(&self) -> chrono::FixedOffset {
        const SECS_IN_HOUR: f64 = 3600_f64;
        if self.lng() >= 0_f64 {
            chrono::FixedOffset::east((self.lng_hour.abs() * SECS_IN_HOUR) as i32)
        } else {
            chrono::FixedOffset::west((self.lng_hour.abs() * SECS_IN_HOUR) as i32)
        }
    }

}