[−][src]Struct datetime_string::rfc3339::PartialTimeString

#[repr(transparent)]pub struct PartialTimeString(_);

Owned string for a time in RFC 3339 partial-time format, such as 12:34:56.7890.

Available when alloc feature is enabled.

This is "partial", because it is not associated to a time offset.

To create a value of this type, use str::parse method or std::convert::TryFrom trait, or convert from &PartialTimeStr.

Examples

use datetime_string::rfc3339::PartialTimeStr;
use std::convert::TryFrom;

let try_from = PartialTimeString::try_from("12:34:56.7890")?;

let parse = "12:34:56.7890".parse::<PartialTimeString>()?;
let parse2: PartialTimeString = "12:34:56.7890".parse()?;

let to_owned = PartialTimeStr::from_str("12:34:56.7890")?.to_owned();
let into: PartialTimeString = PartialTimeStr::from_str("12:34:56.7890")?.into();

Implementations

Returns a &PartialTimeStr for the string.

Examples

use datetime_string::rfc3339::PartialTimeStr;

let time = "12:34:56.7890".parse::<PartialTimeString>()?;

// Usually you don't need to call `as_deref()` explicitly, because
// `Deref<Target = PartialTimeStr>` trait is implemented.
let _: &PartialTimeStr = time.as_deref();

Returns a &mut PartialTimeStr for the string.

Examples

use datetime_string::rfc3339::PartialTimeStr;

let mut time = "12:34:56.7890".parse::<PartialTimeString>()?;

// Usually you don't need to call `as_deref_mut()` explicitly, because
// `DerefMut` trait is implemented.
let _: &mut PartialTimeStr = time.as_deref_mut();

Methods from Deref<Target = PartialTimeStr>

Returns a string slice.

Examples

let time = PartialTimeStr::from_str("12:34:56.7890")?;

assert_eq!(time.as_str(), "12:34:56.7890");

Returns a byte slice.

If you want to use indexed access, prefer as_bytes_fixed_len.

Examples

let time = PartialTimeStr::from_str("12:34:56.7890")?;

assert_eq!(time.as_str(), "12:34:56.7890");

Returns a hh:mm:ss substring.

Examples

let time = PartialTimeStr::from_str("12:34:56.7890")?;

assert_eq!(time.hms(), "12:34:56");

Returns a mutable hh:mm:ss substring.

Examples

let mut buf = "12:34:56.7890".to_owned();
let time = PartialTimeStr::from_mut_str(&mut buf)?;
assert_eq!(time.as_str(), "12:34:56.7890");

time.hms_mut().set_time(23, 12, 1);
assert_eq!(time.as_str(), "23:12:01.7890");

Examples

let time = PartialTimeStr::from_str("12:34:56.7890")?;

assert_eq!(time.secfrac().unwrap(), ".7890");

Returns a mutable time-secfrac substring.

Examples

let mut buf = "12:34:56.7890".to_owned();
let time = PartialTimeStr::from_mut_str(&mut buf)?;
assert_eq!(time.as_str(), "12:34:56.7890");

time.hms_mut().set_time(23, 12, 1);
assert_eq!(time.as_str(), "23:12:01.7890");

Note that this truncates subnanosecond secfrac.

Enabled by chrono04 feature.

Examples

use chrono04::NaiveTime;

let time = PartialTimeStr::from_str("12:34:56.01234567899999")?;
assert_eq!(time.to_chrono_naive_time(), NaiveTime::from_hms_nano(12, 34, 56, 12_345_678));

let leap = PartialTimeStr::from_str("23:59:60.876543210999")?;
assert_eq!(leap.to_chrono_naive_time(), NaiveTime::from_hms_nano(23, 59, 59, 1_876_543_210));