Struct CalendarDate 

pub struct CalendarDate {
    pub year: i32,
    pub month: i32,
    pub day: i32,
    pub hour: i32,
    pub minute: i32,
    pub second: f64,
}

Represents a calendar date

Fields

year: i32

month: i32

day: i32

hour: i32

minute: i32

second: f64

Implementations

impl CalendarDate

pub fn new( year: i32, month: i32, day: i32, hour: i32, minute: i32, second: f64, ) -> Self

Create a new calendar date

Examples found in repository

examples/time_conversion.rs (line 12)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    println!("=== Time Conversion Examples ===\n");

    // Example 1: Convert calendar date to Julian date
    println!("Example 1: Calendar to Julian Date");
    let cal = CalendarDate::new(2024, 1, 15, 12, 0, 0.0);
    let jd = cal.to_julian()?;
    println!(
        "  Calendar: {}-{:02}-{:02} {:02}:{:02}:{:02}",
        cal.year, cal.month, cal.day, cal.hour, cal.minute, cal.second as i32
    );
    println!("  Julian Date: {:.6}\n", jd.as_f64());

    // Example 2: Convert Julian date to calendar date
    println!("Example 2: Julian to Calendar Date");
    let jd2 = JulianDate::new(2460327.0); // January 15, 2024
    let cal2 = jd2.to_calendar();
    println!("  Julian Date: {:.6}", jd2.as_f64());
    println!(
        "  Calendar: {}-{:02}-{:02} {:02}:{:02}:{:02}\n",
        cal2.year, cal2.month, cal2.day, cal2.hour, cal2.minute, cal2.second as i32
    );

    // Example 3: Using from_calendar directly
    println!("Example 3: Direct conversion");
    let jd3 = JulianDate::from_calendar(2000, 1, 1, 12, 0, 0.0)?;
    println!("  January 1, 2000 12:00:00 UTC");
    println!("  Julian Date: {:.6}\n", jd3.as_f64());

    // Example 4: Historical dates
    println!("Example 4: Historical Dates");
    let dates = vec![
        (1969, 7, 20, 20, 17, 0.0, "Apollo 11 Moon Landing"),
        (1986, 1, 28, 11, 39, 0.0, "Space Shuttle Challenger"),
        (2021, 7, 20, 9, 13, 0.0, "Blue Origin NS-16"),
    ];

    for (year, month, day, hour, minute, second, event) in dates {
        let jd = JulianDate::from_calendar(year, month, day, hour, minute, second)?;
        println!("  {}: JD {:.6}", event, jd.as_f64());
    }

    Ok(())
}

examples/basic_usage.rs (line 55)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    println!("=== Rust JPL Ephemeris Reader - Basic Usage Example ===\n");

    // Initialize the ephemeris from config.toml
    println!("1. Initializing Ephemeris...");
    let eph = Ephemeris::new("config.toml")?;
    println!("   ✓ Ephemeris loaded successfully\n");

    // Display metadata
    println!("2. Ephemeris Metadata:");
    let metadata = eph.get_metadata();
    println!(
        "   - Date Range: {} - {}",
        metadata.start_year, metadata.end_year
    );
    println!(
        "   - Julian Date Range: {:.2} - {:.2}",
        metadata.julian_start, metadata.julian_end
    );
    println!("   - Interval: {} days", metadata.interval_days);
    println!(
        "   - Earth-Moon Mass Ratio: {:.6}",
        metadata.earth_moon_ratio
    );
    println!(
        "   - Number of Coefficients: {}\n",
        metadata.number_of_coefficients
    );

    // List available bodies
    println!("3. Available Celestial Bodies:");
    for body in eph.get_bodies() {
        let status = if body.active { "✓" } else { "✗" };
        println!(
            "   {} {} ({})",
            status,
            body.name,
            if body.active { "active" } else { "inactive" }
        );
    }
    println!();

    // Time conversion example
    println!("4. Time Conversion Example:");
    let calendar_date = rust_jpl::CalendarDate::new(2024, 1, 15, 12, 0, 0.0);
    println!(
        "   Calendar Date: {}-{:02}-{:02} {:02}:{:02}:{:02}",
        calendar_date.year,
        calendar_date.month,
        calendar_date.day,
        calendar_date.hour,
        calendar_date.minute,
        calendar_date.second as i32
    );

    let jd = calendar_date.to_julian()?;
    println!("   Julian Date: {:.6}", jd.as_f64());

    let converted_back = jd.to_calendar();
    println!(
        "   Converted back: {}-{:02}-{:02} {:02}:{:02}:{:02}\n",
        converted_back.year,
        converted_back.month,
        converted_back.day,
        converted_back.hour,
        converted_back.minute,
        converted_back.second as i32
    );

    // Get planetary positions
    println!(
        "5. Planetary Positions (at Julian Date {:.6}):",
        jd.as_f64()
    );
    let bodies = [
        "Sun", "Mercury", "Venus", "Earth", "Mars", "Jupiter", "Saturn",
    ];

    for body_name in &bodies {
        match eph.get_position(body_name, jd) {
            Ok(pos) => {
                println!(
                    "   {}: ({:12.6}, {:12.6}, {:12.6}) AU, Distance: {:.6} AU",
                    body_name,
                    pos.x,
                    pos.y,
                    pos.z,
                    pos.distance()
                );
            }
            Err(e) => {
                println!("   {}: Error - {}", body_name, e);
            }
        }
    }

    println!("\n=== Example Complete ===");
    Ok(())
}

pub fn to_julian(&self) -> Result<JulianDate, Error>

Convert to Julian date

Examples found in repository

examples/time_conversion.rs (line 13)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    println!("=== Time Conversion Examples ===\n");

    // Example 1: Convert calendar date to Julian date
    println!("Example 1: Calendar to Julian Date");
    let cal = CalendarDate::new(2024, 1, 15, 12, 0, 0.0);
    let jd = cal.to_julian()?;
    println!(
        "  Calendar: {}-{:02}-{:02} {:02}:{:02}:{:02}",
        cal.year, cal.month, cal.day, cal.hour, cal.minute, cal.second as i32
    );
    println!("  Julian Date: {:.6}\n", jd.as_f64());

    // Example 2: Convert Julian date to calendar date
    println!("Example 2: Julian to Calendar Date");
    let jd2 = JulianDate::new(2460327.0); // January 15, 2024
    let cal2 = jd2.to_calendar();
    println!("  Julian Date: {:.6}", jd2.as_f64());
    println!(
        "  Calendar: {}-{:02}-{:02} {:02}:{:02}:{:02}\n",
        cal2.year, cal2.month, cal2.day, cal2.hour, cal2.minute, cal2.second as i32
    );

    // Example 3: Using from_calendar directly
    println!("Example 3: Direct conversion");
    let jd3 = JulianDate::from_calendar(2000, 1, 1, 12, 0, 0.0)?;
    println!("  January 1, 2000 12:00:00 UTC");
    println!("  Julian Date: {:.6}\n", jd3.as_f64());

    // Example 4: Historical dates
    println!("Example 4: Historical Dates");
    let dates = vec![
        (1969, 7, 20, 20, 17, 0.0, "Apollo 11 Moon Landing"),
        (1986, 1, 28, 11, 39, 0.0, "Space Shuttle Challenger"),
        (2021, 7, 20, 9, 13, 0.0, "Blue Origin NS-16"),
    ];

    for (year, month, day, hour, minute, second, event) in dates {
        let jd = JulianDate::from_calendar(year, month, day, hour, minute, second)?;
        println!("  {}: JD {:.6}", event, jd.as_f64());
    }

    Ok(())
}

examples/basic_usage.rs (line 66)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    println!("=== Rust JPL Ephemeris Reader - Basic Usage Example ===\n");

    // Initialize the ephemeris from config.toml
    println!("1. Initializing Ephemeris...");
    let eph = Ephemeris::new("config.toml")?;
    println!("   ✓ Ephemeris loaded successfully\n");

    // Display metadata
    println!("2. Ephemeris Metadata:");
    let metadata = eph.get_metadata();
    println!(
        "   - Date Range: {} - {}",
        metadata.start_year, metadata.end_year
    );
    println!(
        "   - Julian Date Range: {:.2} - {:.2}",
        metadata.julian_start, metadata.julian_end
    );
    println!("   - Interval: {} days", metadata.interval_days);
    println!(
        "   - Earth-Moon Mass Ratio: {:.6}",
        metadata.earth_moon_ratio
    );
    println!(
        "   - Number of Coefficients: {}\n",
        metadata.number_of_coefficients
    );

    // List available bodies
    println!("3. Available Celestial Bodies:");
    for body in eph.get_bodies() {
        let status = if body.active { "✓" } else { "✗" };
        println!(
            "   {} {} ({})",
            status,
            body.name,
            if body.active { "active" } else { "inactive" }
        );
    }
    println!();

    // Time conversion example
    println!("4. Time Conversion Example:");
    let calendar_date = rust_jpl::CalendarDate::new(2024, 1, 15, 12, 0, 0.0);
    println!(
        "   Calendar Date: {}-{:02}-{:02} {:02}:{:02}:{:02}",
        calendar_date.year,
        calendar_date.month,
        calendar_date.day,
        calendar_date.hour,
        calendar_date.minute,
        calendar_date.second as i32
    );

    let jd = calendar_date.to_julian()?;
    println!("   Julian Date: {:.6}", jd.as_f64());

    let converted_back = jd.to_calendar();
    println!(
        "   Converted back: {}-{:02}-{:02} {:02}:{:02}:{:02}\n",
        converted_back.year,
        converted_back.month,
        converted_back.day,
        converted_back.hour,
        converted_back.minute,
        converted_back.second as i32
    );

    // Get planetary positions
    println!(
        "5. Planetary Positions (at Julian Date {:.6}):",
        jd.as_f64()
    );
    let bodies = [
        "Sun", "Mercury", "Venus", "Earth", "Mars", "Jupiter", "Saturn",
    ];

    for body_name in &bodies {
        match eph.get_position(body_name, jd) {
            Ok(pos) => {
                println!(
                    "   {}: ({:12.6}, {:12.6}, {:12.6}) AU, Distance: {:.6} AU",
                    body_name,
                    pos.x,
                    pos.y,
                    pos.z,
                    pos.distance()
                );
            }
            Err(e) => {
                println!("   {}: Error - {}", body_name, e);
            }
        }
    }

    println!("\n=== Example Complete ===");
    Ok(())
}

Trait Implementations

impl Clone for CalendarDate

fn clone(&self) -> CalendarDate

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for CalendarDate

impl Debug for CalendarDate

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for CalendarDate

fn eq(&self, other: &CalendarDate) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for CalendarDate