nautilus_core/ffi/
datetime.rs

1// -------------------------------------------------------------------------------------------------
2//  Copyright (C) 2015-2025 Posei Systems Pty Ltd. All rights reserved.
3//  https://poseitrader.io
4//
5//  Licensed under the GNU Lesser General Public License Version 3.0 (the "License");
6//  You may not use this file except in compliance with the License.
7//  You may obtain a copy of the License at https://www.gnu.org/licenses/lgpl-3.0.en.html
8//
9//  Unless required by applicable law or agreed to in writing, software
10//  distributed under the License is distributed on an "AS IS" BASIS,
11//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12//  See the License for the specific language governing permissions and
13//  limitations under the License.
14// -------------------------------------------------------------------------------------------------
15
16//! Thin FFI wrappers around the date/time conversion utilities in `nautilus-core`.
17//!
18//! The Rust implementation already lives in `crate::datetime`; this module simply exposes the
19//! conversions to C (and, by extension, to Python via Cython) while keeping the behaviour and the
20//! documentation in one place.  Each exported function forwards directly to its Rust counterpart
21//! and therefore inherits the same semantics and safety guarantees.
22
23use std::ffi::c_char;
24
25use crate::{
26    datetime::{unix_nanos_to_iso8601, unix_nanos_to_iso8601_millis},
27    ffi::string::str_to_cstr,
28};
29
30/// Converts a UNIX nanoseconds timestamp to an ISO 8601 (RFC 3339) format C string pointer.
31#[cfg(feature = "ffi")]
32#[unsafe(no_mangle)]
33pub extern "C" fn unix_nanos_to_iso8601_cstr(timestamp_ns: u64) -> *const c_char {
34    str_to_cstr(&unix_nanos_to_iso8601(timestamp_ns.into()))
35}
36
37/// Converts a UNIX nanoseconds timestamp to an ISO 8601 (RFC 3339) format C string pointer
38/// with millisecond precision.
39#[cfg(feature = "ffi")]
40#[unsafe(no_mangle)]
41pub extern "C" fn unix_nanos_to_iso8601_millis_cstr(timestamp_ns: u64) -> *const c_char {
42    str_to_cstr(&unix_nanos_to_iso8601_millis(timestamp_ns.into()))
43}
44/// Converts seconds to nanoseconds (ns).
45#[cfg(feature = "ffi")]
46#[unsafe(no_mangle)]
47pub extern "C" fn secs_to_nanos(secs: f64) -> u64 {
48    crate::datetime::secs_to_nanos(secs)
49}
50
51/// Converts seconds to milliseconds (ms).
52#[cfg(feature = "ffi")]
53#[unsafe(no_mangle)]
54pub extern "C" fn secs_to_millis(secs: f64) -> u64 {
55    crate::datetime::secs_to_millis(secs)
56}
57
58/// Converts milliseconds (ms) to nanoseconds (ns).
59#[cfg(feature = "ffi")]
60#[unsafe(no_mangle)]
61pub extern "C" fn millis_to_nanos(millis: f64) -> u64 {
62    crate::datetime::millis_to_nanos(millis)
63}
64
65/// Converts microseconds (μs) to nanoseconds (ns).
66#[cfg(feature = "ffi")]
67#[unsafe(no_mangle)]
68pub extern "C" fn micros_to_nanos(micros: f64) -> u64 {
69    crate::datetime::micros_to_nanos(micros)
70}
71
72/// Converts nanoseconds (ns) to seconds.
73#[cfg(feature = "ffi")]
74#[unsafe(no_mangle)]
75pub extern "C" fn nanos_to_secs(nanos: u64) -> f64 {
76    crate::datetime::nanos_to_secs(nanos)
77}
78
79/// Converts nanoseconds (ns) to milliseconds (ms).
80#[cfg(feature = "ffi")]
81#[unsafe(no_mangle)]
82pub const extern "C" fn nanos_to_millis(nanos: u64) -> u64 {
83    crate::datetime::nanos_to_millis(nanos)
84}
85
86/// Converts nanoseconds (ns) to microseconds (μs).
87#[cfg(feature = "ffi")]
88#[unsafe(no_mangle)]
89pub const extern "C" fn nanos_to_micros(nanos: u64) -> u64 {
90    crate::datetime::nanos_to_micros(nanos)
91}
nautilus_core/ffi/datetime.rs

nautilus_core/ffi/
datetime.rs
