Package org.apache.juneau.bean.html5

Class Time

java.lang.Object

org.apache.juneau.bean.html5.HtmlElement<SELF>

org.apache.juneau.bean.html5.HtmlElementMixed<Time>

org.apache.juneau.bean.html5.Time

@Marshalled(typeName="time")
public class Time
extends HtmlElementMixed<Time>

DTO for an HTML <time> element.

The time element represents a specific point in time or a duration. It provides a machine-readable way to mark up dates and times in HTML, making it easier for search engines, screen readers, and other tools to understand and process temporal information. The element can contain human-readable text while providing a machine-readable datetime attribute.

Examples:

import static org.apache.juneau.bean.html5.HtmlBuilder.*; // Simple date Time date = time("January 15, 2024") .datetime("2024-01-15"); // Date and time Time datetime = time("2:30 PM on January 15, 2024") .datetime("2024-01-15T14:30:00Z"); // Relative time Time relative = time("yesterday") .datetime("2024-01-15"); // Duration Time duration = time("2 hours and 30 minutes") .datetime("PT2H30M"); // Time with styling Time styled = time("Event Date: January 15, 2024") .datetime("2024-01-15") .class_("event-date"); // Time with timezone Time timezone = time("2:30 PM EST on January 15, 2024") .datetime("2024-01-15T14:30:00-05:00");

The following convenience methods are provided for constructing instances of this bean:

• HtmlBuilder
  • time()
  • time(Object...)

See Also:

• juneau-bean-html5

Constructor Summary

Constructors

Constructor	Description
Time()	Creates an empty Time element.
Time(Object... children)	Creates a Time element with the specified HtmlElementMixed.children(Object[]) nodes.

Method Summary

Modifier and Type	Method	Description
Time	datetime(String value)	datetime attribute.

Methods inherited from class org.apache.juneau.bean.html5.HtmlElementMixed

child, children, getChild, getChild, getChild, getChildren, setChildren

Methods inherited from class org.apache.juneau.bean.html5.HtmlElement

accesskey, attr, attrUri, class_, contenteditable, deminimize, dir, getAttr, getAttr, getAttrs, hidden, id, lang, onabort, onblur, oncancel, oncanplay, oncanplaythrough, onchange, onclick, oncuechange, ondblclick, ondurationchange, onemptied, onended, onerror, onfocus, oninput, oninvalid, onkeydown, onkeypress, onkeyup, onload, onloadeddata, onloadedmetadata, onloadstart, onmousedown, onmouseenter, onmouseleave, onmousemove, onmouseout, onmouseover, onmouseup, onmousewheel, onpause, onplay, onplaying, onprogress, onratechange, onreset, onresize, onscroll, onseeked, onseeking, onselect, onshow, onstalled, onsubmit, onsuspend, ontimeupdate, ontoggle, onvolumechange, onwaiting, self, setAttrs, spellcheck, style, tabindex, title, toString, translate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

Time

public Time()

Creates an empty Time element.

Time

public Time(Object... children)

Creates a Time element with the specified HtmlElementMixed.children(Object[]) nodes.

Parameters:

children - The HtmlElementMixed.children(Object[]) nodes. Must not be null.

Method Details

datetime

public Time datetime(String value)

datetime attribute.

Specifies the machine-readable value of the time element. This provides a standardized format for the date and time that can be processed by computers.

The value should be a valid date-time string in ISO 8601 format.

Parameters:

value - The machine-readable date and time value. Can be null to unset the attribute.

Returns:

This object.