Source code
Revision control
Copy as Markdown
Other Tools
// This file is part of ICU4X. For terms of use, please see the file
// called LICENSE at the top level of the ICU4X source tree
#[diplomat::bridge]
pub mod ffi {
use alloc::boxed::Box;
use alloc::sync::Arc;
use core::convert::TryInto;
use core::fmt::Write;
use icu_calendar::{AnyCalendar, DateTime, Iso, Time};
use tinystr::TinyAsciiStr;
use crate::calendar::ffi::ICU4XCalendar;
use crate::date::ffi::{ICU4XDate, ICU4XIsoDate, ICU4XIsoWeekday};
use crate::errors::ffi::ICU4XError;
use crate::time::ffi::ICU4XTime;
#[cfg(feature = "icu_calendar")]
use crate::week::ffi::ICU4XWeekCalculator;
#[diplomat::opaque]
/// An ICU4X DateTime object capable of containing a ISO-8601 date and time.
#[diplomat::rust_link(icu::calendar::DateTime, Struct)]
pub struct ICU4XIsoDateTime(pub DateTime<Iso>);
impl ICU4XIsoDateTime {
/// Creates a new [`ICU4XIsoDateTime`] from the specified date and time.
#[diplomat::rust_link(icu::calendar::DateTime::try_new_iso_datetime, FnInStruct)]
#[diplomat::attr(all(supports = constructors, supports = fallible_constructors), constructor)]
pub fn create(
year: i32,
month: u8,
day: u8,
hour: u8,
minute: u8,
second: u8,
nanosecond: u32,
) -> Result<Box<ICU4XIsoDateTime>, ICU4XError> {
let mut dt = DateTime::try_new_iso_datetime(year, month, day, hour, minute, second)?;
dt.time.nanosecond = nanosecond.try_into()?;
Ok(Box::new(ICU4XIsoDateTime(dt)))
}
/// Creates a new [`ICU4XIsoDateTime`] from an [`ICU4XIsoDate`] and [`ICU4XTime`] object
#[diplomat::rust_link(icu::calendar::DateTime::new, FnInStruct)]
#[diplomat::attr(all(supports = constructors, supports = fallible_constructors, supports = named_constructors), named_constructor = "from_date_and_time")]
pub fn crate_from_date_and_time(
date: &ICU4XIsoDate,
time: &ICU4XTime,
) -> Box<ICU4XIsoDateTime> {
let dt = DateTime::new(date.0, time.0);
Box::new(ICU4XIsoDateTime(dt))
}
/// Creates a new [`ICU4XIsoDateTime`] of midnight on January 1, 1970
#[diplomat::rust_link(icu::calendar::DateTime::local_unix_epoch, FnInStruct)]
#[diplomat::attr(all(supports = constructors, supports = fallible_constructors, supports = named_constructors), named_constructor = "local_unix_epoch")]
pub fn local_unix_epoch() -> Box<ICU4XIsoDateTime> {
let dt = DateTime::local_unix_epoch();
Box::new(ICU4XIsoDateTime(dt))
}
/// Construct from the minutes since the local unix epoch for this date (Jan 1 1970, 00:00)
#[diplomat::rust_link(
icu::calendar::DateTime::from_minutes_since_local_unix_epoch,
FnInStruct
)]
#[diplomat::attr(all(supports = constructors, supports = fallible_constructors, supports = named_constructors), named_constructor = "from_minutes_since_local_unix_epoch")]
pub fn create_from_minutes_since_local_unix_epoch(minutes: i32) -> Box<ICU4XIsoDateTime> {
Box::new(ICU4XIsoDateTime(
DateTime::from_minutes_since_local_unix_epoch(minutes),
))
}
/// Gets the date contained in this object
#[diplomat::rust_link(icu::calendar::DateTime::date, StructField)]
#[diplomat::attr(supports = accessors, getter)]
pub fn date(&self) -> Box<ICU4XIsoDate> {
Box::new(ICU4XIsoDate(self.0.date))
}
/// Gets the time contained in this object
#[diplomat::rust_link(icu::calendar::DateTime::time, StructField)]
#[diplomat::attr(supports = accessors, getter)]
pub fn time(&self) -> Box<ICU4XTime> {
Box::new(ICU4XTime(self.0.time))
}
/// Converts this to an [`ICU4XDateTime`] capable of being mixed with dates of
/// other calendars
#[diplomat::rust_link(icu::calendar::DateTime::to_any, FnInStruct)]
#[diplomat::rust_link(icu::calendar::DateTime::new_from_iso, FnInStruct, hidden)]
pub fn to_any(&self) -> Box<ICU4XDateTime> {
Box::new(ICU4XDateTime(self.0.to_any().wrap_calendar_in_arc()))
}
/// Gets the minutes since the local unix epoch for this date (Jan 1 1970, 00:00)
#[diplomat::rust_link(icu::calendar::DateTime::minutes_since_local_unix_epoch, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn minutes_since_local_unix_epoch(&self) -> i32 {
self.0.minutes_since_local_unix_epoch()
}
/// Convert this datetime to one in a different calendar
#[diplomat::rust_link(icu::calendar::DateTime::to_calendar, FnInStruct)]
pub fn to_calendar(&self, calendar: &ICU4XCalendar) -> Box<ICU4XDateTime> {
Box::new(ICU4XDateTime(self.0.to_calendar(calendar.0.clone())))
}
/// Returns the hour in this time
#[diplomat::rust_link(icu::calendar::Time::hour, StructField)]
#[diplomat::attr(supports = accessors, getter)]
pub fn hour(&self) -> u8 {
self.0.time.hour.into()
}
/// Returns the minute in this time
#[diplomat::rust_link(icu::calendar::Time::minute, StructField)]
#[diplomat::attr(supports = accessors, getter)]
pub fn minute(&self) -> u8 {
self.0.time.minute.into()
}
/// Returns the second in this time
#[diplomat::rust_link(icu::calendar::Time::second, StructField)]
#[diplomat::attr(supports = accessors, getter)]
pub fn second(&self) -> u8 {
self.0.time.second.into()
}
/// Returns the nanosecond in this time
#[diplomat::rust_link(icu::calendar::Time::nanosecond, StructField)]
#[diplomat::attr(supports = accessors, getter)]
pub fn nanosecond(&self) -> u32 {
self.0.time.nanosecond.into()
}
/// Returns the 1-indexed day in the year for this date
#[diplomat::rust_link(icu::calendar::Date::day_of_year_info, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn day_of_year(&self) -> u16 {
self.0.date.day_of_year_info().day_of_year
}
/// Returns the 1-indexed day in the month for this date
#[diplomat::rust_link(icu::calendar::Date::day_of_month, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn day_of_month(&self) -> u32 {
self.0.date.day_of_month().0
}
/// Returns the day in the week for this day
#[diplomat::rust_link(icu::calendar::Date::day_of_week, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn day_of_week(&self) -> ICU4XIsoWeekday {
self.0.date.day_of_week().into()
}
/// Returns the week number in this month, 1-indexed, based on what
/// is considered the first day of the week (often a locale preference).
///
/// `first_weekday` can be obtained via `first_weekday()` on [`ICU4XWeekCalculator`]
#[diplomat::rust_link(icu::calendar::Date::week_of_month, FnInStruct)]
#[diplomat::rust_link(
icu::calendar::week::WeekCalculator::week_of_month,
FnInStruct,
hidden
)]
pub fn week_of_month(&self, first_weekday: ICU4XIsoWeekday) -> u32 {
self.0.date.week_of_month(first_weekday.into()).0
}
/// Returns the week number in this year, using week data
#[diplomat::rust_link(icu::calendar::Date::week_of_year, FnInStruct)]
#[diplomat::rust_link(
icu::calendar::week::WeekCalculator::week_of_year,
FnInStruct,
hidden
)]
#[cfg(feature = "icu_calendar")]
pub fn week_of_year(
&self,
calculator: &ICU4XWeekCalculator,
) -> Result<crate::week::ffi::ICU4XWeekOf, ICU4XError> {
Ok(self.0.date.week_of_year(&calculator.0)?.into())
}
/// Returns 1-indexed number of the month of this date in its year
#[diplomat::rust_link(icu::calendar::Date::month, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn month(&self) -> u32 {
self.0.date.month().ordinal
}
/// Returns the year number for this date
#[diplomat::rust_link(icu::calendar::Date::year, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn year(&self) -> i32 {
self.0.date.year().number
}
/// Returns whether this date is in a leap year
#[diplomat::rust_link(icu::calendar::Date::is_in_leap_year, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn is_in_leap_year(&self) -> bool {
self.0.date.is_in_leap_year()
}
/// Returns the number of months in the year represented by this date
#[diplomat::rust_link(icu::calendar::Date::months_in_year, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn months_in_year(&self) -> u8 {
self.0.date.months_in_year()
}
/// Returns the number of days in the month represented by this date
#[diplomat::rust_link(icu::calendar::Date::days_in_month, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn days_in_month(&self) -> u8 {
self.0.date.days_in_month()
}
/// Returns the number of days in the year represented by this date
#[diplomat::rust_link(icu::calendar::Date::days_in_year, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn days_in_year(&self) -> u16 {
self.0.date.days_in_year()
}
}
#[diplomat::opaque]
/// An ICU4X DateTime object capable of containing a date and time for any calendar.
#[diplomat::rust_link(icu::calendar::DateTime, Struct)]
pub struct ICU4XDateTime(pub DateTime<Arc<AnyCalendar>>);
impl ICU4XDateTime {
/// Creates a new [`ICU4XDateTime`] representing the ISO date and time
/// given but in a given calendar
#[diplomat::rust_link(icu::DateTime::new_from_iso, FnInStruct)]
#[diplomat::attr(all(supports = constructors, supports = fallible_constructors, supports = named_constructors), named_constructor = "from_iso_in_calendar")]
#[allow(clippy::too_many_arguments)]
pub fn create_from_iso_in_calendar(
year: i32,
month: u8,
day: u8,
hour: u8,
minute: u8,
second: u8,
nanosecond: u32,
calendar: &ICU4XCalendar,
) -> Result<Box<ICU4XDateTime>, ICU4XError> {
let cal = calendar.0.clone();
let mut dt = DateTime::try_new_iso_datetime(year, month, day, hour, minute, second)?;
dt.time.nanosecond = nanosecond.try_into()?;
Ok(Box::new(ICU4XDateTime(dt.to_calendar(cal))))
}
/// Creates a new [`ICU4XDateTime`] from the given codes, which are interpreted in the given calendar system
#[diplomat::rust_link(icu::calendar::DateTime::try_new_from_codes, FnInStruct)]
#[diplomat::attr(all(supports = constructors, supports = fallible_constructors, supports = named_constructors), named_constructor = "from_codes_in_calendar")]
#[allow(clippy::too_many_arguments)]
pub fn create_from_codes_in_calendar(
era_code: &DiplomatStr,
year: i32,
month_code: &DiplomatStr,
day: u8,
hour: u8,
minute: u8,
second: u8,
nanosecond: u32,
calendar: &ICU4XCalendar,
) -> Result<Box<ICU4XDateTime>, ICU4XError> {
let era = TinyAsciiStr::from_bytes(era_code)
.map_err(|_| ICU4XError::CalendarUnknownEraError)?
.into();
let month = TinyAsciiStr::from_bytes(month_code)
.map_err(|_| ICU4XError::CalendarUnknownMonthCodeError)?
.into();
let cal = calendar.0.clone();
let hour = hour.try_into()?;
let minute = minute.try_into()?;
let second = second.try_into()?;
let nanosecond = nanosecond.try_into()?;
let time = Time {
hour,
minute,
second,
nanosecond,
};
Ok(Box::new(ICU4XDateTime(DateTime::try_new_from_codes(
era, year, month, day, time, cal,
)?)))
}
/// Creates a new [`ICU4XDateTime`] from an [`ICU4XDate`] and [`ICU4XTime`] object
#[diplomat::rust_link(icu::calendar::DateTime::new, FnInStruct)]
#[diplomat::attr(all(supports = constructors, supports = fallible_constructors, supports = named_constructors), named_constructor = "from_date_and_time")]
pub fn create_from_date_and_time(date: &ICU4XDate, time: &ICU4XTime) -> Box<ICU4XDateTime> {
let dt = DateTime::new(date.0.clone(), time.0);
Box::new(ICU4XDateTime(dt))
}
/// Gets a copy of the date contained in this object
#[diplomat::rust_link(icu::calendar::DateTime::date, StructField)]
#[diplomat::attr(supports = accessors, getter)]
pub fn date(&self) -> Box<ICU4XDate> {
Box::new(ICU4XDate(self.0.date.clone()))
}
/// Gets the time contained in this object
#[diplomat::rust_link(icu::calendar::DateTime::time, StructField)]
#[diplomat::attr(supports = accessors, getter)]
pub fn time(&self) -> Box<ICU4XTime> {
Box::new(ICU4XTime(self.0.time))
}
/// Converts this date to ISO
#[diplomat::rust_link(icu::calendar::DateTime::to_iso, FnInStruct)]
pub fn to_iso(&self) -> Box<ICU4XIsoDateTime> {
Box::new(ICU4XIsoDateTime(self.0.to_iso()))
}
/// Convert this datetime to one in a different calendar
#[diplomat::rust_link(icu::calendar::DateTime::to_calendar, FnInStruct)]
pub fn to_calendar(&self, calendar: &ICU4XCalendar) -> Box<ICU4XDateTime> {
Box::new(ICU4XDateTime(self.0.to_calendar(calendar.0.clone())))
}
/// Returns the hour in this time
#[diplomat::rust_link(icu::calendar::Time::hour, StructField)]
#[diplomat::attr(supports = accessors, getter)]
pub fn hour(&self) -> u8 {
self.0.time.hour.into()
}
/// Returns the minute in this time
#[diplomat::rust_link(icu::calendar::Time::minute, StructField)]
#[diplomat::attr(supports = accessors, getter)]
pub fn minute(&self) -> u8 {
self.0.time.minute.into()
}
/// Returns the second in this time
#[diplomat::rust_link(icu::calendar::Time::second, StructField)]
#[diplomat::attr(supports = accessors, getter)]
pub fn second(&self) -> u8 {
self.0.time.second.into()
}
/// Returns the nanosecond in this time
#[diplomat::rust_link(icu::calendar::Time::nanosecond, StructField)]
#[diplomat::attr(supports = accessors, getter)]
pub fn nanosecond(&self) -> u32 {
self.0.time.nanosecond.into()
}
/// Returns the 1-indexed day in the year for this date
#[diplomat::rust_link(icu::calendar::Date::day_of_year_info, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn day_of_year(&self) -> u16 {
self.0.date.day_of_year_info().day_of_year
}
/// Returns the 1-indexed day in the month for this date
#[diplomat::rust_link(icu::calendar::Date::day_of_month, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn day_of_month(&self) -> u32 {
self.0.date.day_of_month().0
}
/// Returns the day in the week for this day
#[diplomat::rust_link(icu::calendar::Date::day_of_week, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn day_of_week(&self) -> ICU4XIsoWeekday {
self.0.date.day_of_week().into()
}
/// Returns the week number in this month, 1-indexed, based on what
/// is considered the first day of the week (often a locale preference).
///
/// `first_weekday` can be obtained via `first_weekday()` on [`ICU4XWeekCalculator`]
#[diplomat::rust_link(icu::calendar::Date::week_of_month, FnInStruct)]
#[diplomat::rust_link(
icu::calendar::week::WeekCalculator::week_of_month,
FnInStruct,
hidden
)]
pub fn week_of_month(&self, first_weekday: ICU4XIsoWeekday) -> u32 {
self.0.date.week_of_month(first_weekday.into()).0
}
/// Returns the week number in this year, using week data
#[diplomat::rust_link(icu::calendar::Date::week_of_year, FnInStruct)]
#[diplomat::rust_link(
icu::calendar::week::WeekCalculator::week_of_year,
FnInStruct,
hidden
)]
#[cfg(feature = "icu_calendar")]
pub fn week_of_year(
&self,
calculator: &ICU4XWeekCalculator,
) -> Result<crate::week::ffi::ICU4XWeekOf, ICU4XError> {
Ok(self.0.date.week_of_year(&calculator.0)?.into())
}
/// Returns 1-indexed number of the month of this date in its year
///
/// Note that for lunar calendars this may not lead to the same month
/// having the same ordinal month across years; use month_code if you care
/// about month identity.
#[diplomat::rust_link(icu::calendar::Date::month, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn ordinal_month(&self) -> u32 {
self.0.date.month().ordinal
}
/// Returns the month code for this date. Typically something
/// like "M01", "M02", but can be more complicated for lunar calendars.
#[diplomat::rust_link(icu::calendar::Date::month, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn month_code(
&self,
write: &mut diplomat_runtime::DiplomatWriteable,
) -> Result<(), ICU4XError> {
let code = self.0.date.month().code;
write.write_str(&code.0)?;
Ok(())
}
/// Returns the year number in the current era for this date
#[diplomat::rust_link(icu::calendar::Date::year, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn year_in_era(&self) -> i32 {
self.0.date.year().number
}
/// Returns the era for this date,
#[diplomat::rust_link(icu::calendar::Date::year, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn era(
&self,
write: &mut diplomat_runtime::DiplomatWriteable,
) -> Result<(), ICU4XError> {
let era = self.0.date.year().era;
write.write_str(&era.0)?;
Ok(())
}
/// Returns the number of months in the year represented by this date
#[diplomat::rust_link(icu::calendar::Date::months_in_year, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn months_in_year(&self) -> u8 {
self.0.date.months_in_year()
}
/// Returns the number of days in the month represented by this date
#[diplomat::rust_link(icu::calendar::Date::days_in_month, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn days_in_month(&self) -> u8 {
self.0.date.days_in_month()
}
/// Returns the number of days in the year represented by this date
#[diplomat::rust_link(icu::calendar::Date::days_in_year, FnInStruct)]
#[diplomat::attr(supports = accessors, getter)]
pub fn days_in_year(&self) -> u16 {
self.0.date.days_in_year()
}
/// Returns the [`ICU4XCalendar`] object backing this date
#[diplomat::rust_link(icu::calendar::Date::calendar, FnInStruct)]
#[diplomat::rust_link(icu::calendar::Date::calendar_wrapper, FnInStruct, hidden)]
#[diplomat::attr(supports = accessors, getter)]
pub fn calendar(&self) -> Box<ICU4XCalendar> {
Box::new(ICU4XCalendar(self.0.date.calendar_wrapper().clone()))
}
}
}