Struct JulianDate 

pub struct JulianDate { /* private fields */ }

Representation of a proleptic Julian date. Only represents logic down to single-day accuracy: i.e., leap days are included, but leap seconds are not. This is useful in keeping this calendar applicable to all different time scales. Can represent years from -2^31 up to 2^31 - 1.

Implementations

impl JulianDate

pub const fn new( year: i32, month: Month, day: u8, ) -> Result<Self, InvalidJulianDate>

Creates a new Julian date, given its year, month, and day. If the date is not a valid proleptic Julian date, returns a JulianDateDoesNotExist to indicate that the requested date does not exist in the proleptic Julian calendar.

This function will never panic.

pub const fn from_date(date: Date) -> Self

Constructs a Julian date from a given Date instance. Useful primarily when an existing Date must be printed in human-readable format.

Uses Howard Hinnant’s julian_from_days algorithm.

pub const fn into_date(&self) -> Date

Constructs a Date from a given Julian date. Uses Howard Hinnant’s days_from_julian algorithm.

pub const fn from_ordinal_date( year: i32, day_of_year: u16, ) -> Result<Self, InvalidDayOfYear>

Creates a new date given only the year and the day-of-year. Implementation is based on an algorithm found by A. Pouplier and reported by Jean Meeus in Astronomical Algorithms.

This function will never panic.

pub const fn year(&self) -> i32

Returns the year stored inside this proleptic Julian date. Astronomical year numbering is used (as also done in NAIF SPICE): the year 1 BCE is represented as 0, 2 BCE as -1, etc. Hence, around the year 0, the numbering is …, -2 (3 BCE), -1 (2 BCE), 0 (1 BCE), 1 (1 CE), 2 (2 CE), et cetera. In this manner, the year numbering proceeds smoothly through 0.

pub const fn month(&self) -> Month

Returns the month stored inside this proleptic Julian date.

pub const fn day(&self) -> u8

Returns the day-of-month stored inside this proleptic Julian date.

impl JulianDate

pub fn parse_partial( string: &str, ) -> Result<(Self, &str), JulianDateParsingError>

Parses a JulianDate based on some string. Accepts only the extended complete calendar date format specified in ISO 8601 (see section 5.2.2.1), though in addition any number of digits is accepted for the years term - to extend applicability of the format to a larger time range.

On success, returns the resulting JulianDate and any remaining input that was not yet parsed. On failure, returns a reason indicating why.

Trait Implementations

impl Clone for JulianDate

fn clone(&self) -> JulianDate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JulianDate

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

Formats the value using the given formatter.

impl From<Date> for JulianDate

fn from(value: Date) -> Self

Converts to this type from the input type.

impl From<JulianDate> for Date

fn from(value: JulianDate) -> Self

Converts to this type from the input type.

impl FromStr for JulianDate

fn from_str(string: &str) -> Result<Self, Self::Err>

Parses a JulianDate based on some string. Accepts only the extended complete calendar date format specified in ISO 8601 (see section 5.2.2.1), though in addition any number of digits is accepted for each term.

type Err = JulianDateParsingError

The associated error which can be returned from parsing.

impl Ord for JulianDate

fn cmp(&self, other: &JulianDate) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for JulianDate

fn eq(&self, other: &JulianDate) -> 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 PartialOrd for JulianDate

fn partial_cmp(&self, other: &JulianDate) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for JulianDate

impl Eq for JulianDate

impl StructuralPartialEq for JulianDate