Made Location::try_new public

[Ghamza-Jd]

In order to get observational islamic date for locations other than MECCA and CAIRO

Example:

let new_york = Location::try_new(40.7, -74.0, 10.0, -5.0 / 24.0).unwrap();
let fixed = fixed_from_gregorian(2026, 3, 13);
let (year, month, day) = observational_islamic_from_fixed(fixed, new_york);
println!("Observational NYC: {day}/{month}/{year}");

Changelog

calendrical_calculations: Changed Location::try_new from pub(crate) to pub

• New Methods: Location::try_new()
• New errors: LocationOutOfBoundsError

[CLAassistant]

All committers have signed the CLA.

[Manishearth]

I think this is fine, but we should be careful about new public APIs

If htis is public, do we think it's sufficiently well-documented?

cc @sffc @robertbastian

[Ghamza-Jd]

I've updated the docs to include utc_offset bound

[sffc]

I'm in favor of making calendrical_calculations more useful. I've also hit situations before where constructors that "should be" public were just not public.

[Manishearth]

Please fix the doc CI issue (ignore the semver one, I don't know why that's failing)

[Manishearth]

Verified that LocationOutOfBoundsError is decently written and ready to be public