Struct Timecode

pub struct Timecode;

Available on crate feature time only.

Timecode splitting and formatting.

Examples

#[cfg(feature = "_str_u8")]
#[cfg(any(feature = "std", feature = "_float_f64"))]
assert_eq!(Timecode::secs_f64(3661.5), "01:01:01.500");

#[cfg(feature = "_str_u8")]
assert_eq!(Timecode::nanos_u64(1_002_003_004), "001s 002ms 003µs 004ns");

Implementations

impl Timecode

pub fn split_secs_f64( seconds: f64, ) -> TimeSplitHourNano<u32, u8, u8, u16, NoTime, NoTime>

Available on crate features std or _float_f64 only.

Decomposes a number of seconds in { h, m, s, ms }.

The maximum decomposition for u64::MAX is { h: 5_124_095_576_030_431, .. } (more than 584_942_417 millenia).

pub const fn split_nanos_u64( nanos: u64, ) -> TimeSplitHourNano<NoTime, NoTime, u32, u16, u16, u16>

Splits a number of nanoseconds in { s, ms, µs, ns }.

The maximum decomposition for u64::MAX is { s: 1_266_874_889, .. } (more than 40 years).

pub const fn split_nanos_u32( nanos: u32, ) -> TimeSplitHourNano<NoTime, NoTime, u8, u16, u16, u16>

Splits a number of nanoseconds in { s, ms, µs, ns }.

The maximum decomposition for u32::MAX is { ns: 295, µs: 967, ms: 294, s: 4 } (more than 4 seconds).

pub fn secs_f64(seconds: f64) -> StringU8<12>

Available on (crate features std or _float_f64) and crate feature _str_u8 only.

Returns the time code as HH:MM:SS:MIL or MM:SS:MIL.

The hours are clamped to 99 (more than 4 days).

Features

Makes use of the unsafe_str feature if enabled.

pub fn nanos_u64_alloc(ns: u64) -> String

Available on crate feature alloc only.

Returns the time code, up to seconds, as 001s 012ms 012µs 012ns.

The seconds are clamped to 999 (more than 16 minutes).

pub fn nanos_u64(nanos: u64) -> StringU8<23>

Available on crate feature _str_u8 only.

Returns the time code, up to seconds, as 001s 012ms 012µs 012345ns.

The seconds are clamped to 999 (more than 16 minutes).