Skip to main content

LocalTime

Struct LocalTime 

Source
pub struct LocalTime { /* private fields */ }
Expand description

Shows a <time> in the browser locale and time zone.

The server writes UTC text. The browser replaces it with local text. If the element has no title, the runtime copies the server text to title. The locale is the nearest lang attribute, or the browser locale. The runtime sets the text one time, when it binds. The text does not update.

To format many <time datetime> elements, put data-vanilla=(Behavior::LocalTime) on a container.

The type uses chrono through autumn_web::reexports::chrono.

use autumn_plugin_vanilla::{LocalTime, TimeFormat};
use autumn_web::reexports::chrono::{TimeZone as _, Utc};

let at = Utc.with_ymd_and_hms(2026, 10, 5, 12, 0, 0).unwrap();
let html = LocalTime::new(&at).format(TimeFormat::Date).render().into_string();
assert!(html.starts_with(r#"<time datetime="2026-10-05T12:00:00Z""#), "{html}");

Implementations§

Source§

impl LocalTime

Source

pub fn new<Tz: TimeZone>(at: &DateTime<Tz>) -> Self

Shows at. It converts any time zone to UTC for datetime.

Source

pub const fn format(self, format: TimeFormat) -> Self

Sets the format.

Source

pub fn fallback(self, text: impl Into<String>) -> Self

Sets the text to show without JavaScript. The default is UTC text that matches the format, for example 2026-10-05 12:00 UTC.

Source

pub fn attributes(&self) -> Attributes

The attributes, in render order.

Source

pub fn render(&self) -> Markup

Renders the <time> element.

Source§

impl LocalTime

Source

pub fn attr(self, name: &'static str, value: impl Into<String>) -> Self

Adds an extra attribute, for example id, class or aria-label.

The name must start with an ASCII letter and contain only ASCII letters, digits, -, _ and :. The builder ignores (and logs) event handler names (on…), style, type and data-vanilla… names.

Trait Implementations§

Source§

impl Clone for LocalTime

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for LocalTime

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Eq for LocalTime

Source§

impl PartialEq for LocalTime

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl Render for LocalTime

Source§

fn render(&self) -> Markup

Renders self as a block of Markup.
Source§

fn render_to(&self, buffer: &mut String)

Appends a representation of self to the given buffer. Read more
Source§

impl StructuralPartialEq for LocalTime

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> FromRef<T> for T
where T: Clone,

Source§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> Scoped for T
where T: Send + Sync + 'static,

Source§

fn scope(ctx: &PolicyContext) -> ScopeQuery<'_, Self>

Open a deferred ScopeQuery for this type. Resolves the registered scope at .load() time, not here.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more