Time

Timestamps can be absolute or relative:

Absolute time: prints the given time in a localized way. (e.g. 9:27 PM)
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 (e.g. “25 minutes ago” or “in 10 hours”).

Implementations

The component Time is available in the following technologies:

Web Components

Native

Make sure you have read about the parameters in here.

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

Name	Type	Description
`time`	`string`	The time to be printed. It can be a string or a timestamp. If none is provided, it will use the current one.
`locale`	`string`	The `locale` parameter is used to set the locale of the component. The value must be part of the registered locales in ZDS. If not set, the default locale of the document will be used. Have a look to the localization mechanisms.
`format-24`	`boolean`	Whether to use 24h format or not. Default: `false`.
`with-seconds`	`boolean`	Whether to print the seconds or not. Default: `false`.
`format`	`string`	The format to be used. Possible values: `long`, `short`, `narrow`.
`as-relative`	`string`	Whether to print the time as relative to current time or not. Possible values:`year`, `quarter`, `month`, `week`, `day`, `hour`, `minute`, `second`.
`custom`	`object`	A record of key-value pairs to set the CSS custom tokens. It's a complex attribute set as an JS object in stringified JSON format. Example: html `<z-time custom='{"fill":"#06e7a3"}' />` Check the available values in the customization section.
`custom-str`	`string`	The stringified version of the `custom` property. It follows the pattern `key:value;key:value;`, with the possibility of setting multiple values and spaces between the punctuation characters. Example: html `<z-time custom-str="fill:#06e7a3" />`
`z-theme`	`string`	Sets the theme of the component. The possible values are `light` and `dark`. html `<z-time z-theme="dark" />`

...

INFO

Check everything about the customization mechanics in the "How it works" documentation.

No customization tokens yet implemented for this component

...