Skip to content

Time - Web Component

...

  • Absolute time: prints the given time in a localized way.
  • Relative time: prints the relative time between the current time (when the component is rendered) and the given one in a short sentence. Works for past and future.

Parameters

The Web component uses a <z-time> tag.

The parametrization of the component can be done with the following custom HTML params:

NameTypeDescription
value
(optional)
string

The time to be printed. It can be a string or a timestamp. If none is provided, it will use the current one.

format-24
(optional)
boolean

Whether to use 24h format or not. Default: false.

with-seconds
(optional)
boolean

Whether to print the seconds or not. Default: false.

format
(optional)
string

The format to be used. Possible values: long, short, narrow.

as-relative
(optional)
string

Whether to print the time as relative to current time or not. Possible values:year, quarter, month, week, day, hour, minute, second.

Playground

Customization

HTML Examples

Imports
html
<link rel="stylesheet" href="/0.3.7/@zurich/web-components/styles.css" />
<script type="module" src="/0.3.7/@zurich/web-components/time.js"></script>
Code
html
<z-time value="2024-03-01T04:20"></z-time>
<z-time value="04:20"></z-time>
<z-time value="2024-03-01T04:20:55.000Z" format-24 with-seconds></z-time>
<z-time value="04:20:55" with-seconds locale="zh"></z-time>
<z-time value="1991-09-21" as-relative="year"></z-time>
<z-time value="2030-09-21" as-relative="week" locale="es"></z-time>