> ## Documentation Index
> Fetch the complete documentation index at: https://doc.lucidworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# series:time

export const LwTemplate = ({title = "Key questions to get you started", icon = "sparkles", cta = "Powered by Agent Studio", linkHref = "https://lucidworks.com/demo/?utm_source=docs&utm_medium=referral&utm_campaign=docs_cta_ai"}) => {
  const [isLoaded, setIsLoaded] = useState(false);
  useEffect(() => {
    const timer = setTimeout(() => {
      setIsLoaded(true);
    }, 500);
    return () => clearTimeout(timer);
  }, []);
  return <div className="lw-template-container">
      <Card title={title} icon={icon}>
        {isLoaded && <span dangerouslySetInnerHTML={{
    __html: `<lw-template id="a029c1a9-28be-427e-b0e1-5d918920246a"></lw-template
            >`
  }} />}
        <Link href={linkHref} className="agent-studio-link text-left text-gray-600 gap-2 dark:text-gray-400 text-sm font-medium flex flex-row items-center hover:text-primary dark:hover:text-primary-light group-hover:text-primary group-hover:dark:text-primary-light">Powered by Lucidworks Agent Studio</Link>
      </Card>
    </div>;
};

[localhost link]: http://localhost:3000/docs/4/app-studio/reference/tags/lightning.directive.seriesTime

[mintlify link]: https://doc.lucidworks.com/docs/4/app-studio/reference/tags/lightning.directive.seriesTime

[old doc.lw link]: https://doc.lucidworks.com/app-studio/4.2/1110

<LwTemplate />

## Description

The series time directive shows a time series on a chart, in order to
use this you must set type to 'time' on the
[chart display tag](/docs/4/app-studio/reference/tags/lightning.directive.chartDisplay).

For detail on how to change the color and background color see the demo
below, for more detail on what you can change and set using CSS see
[here.](http://www.highcharts.com/docs/chart-design-and-style/style-by-css)

## Usage

as element:

```xml wrap  theme={"dark"}
<series:time
       response="{object}"
       platform="{string}"
       name="{string}"
       value-field="{string|expression}"
       label-field="{string|expression}"
       [title="{string|expression}"]
       [show-marker="{string}"]
       [type="{string}"]
       [range-selector="{boolean}"]
       [navigator="{boolean}"]
       [query="{object}"]
       [measure="{string}"]
       [sort="{boolean}"]
       [number-to-show="{Number}"]
       [selected-by-default="{boolean}"]>
</series:time>
```

### Directive info

* This directive creates new scope.

#### Parameters

| Param                             | Type                         | Details                                                                                                       |
| --------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------- |
| response                          | **object**                   | A response object (please include either a response or a platform not both!).                                 |
| platform                          | **string**                   | The name of the platform to get the data from (please include either a response or a platform not both!).     |
| name                              | **string**                   | Name of facet. (Use either name or value-field and label-field not both!)                                     |
| value-field                       | **string]link:\[expression** | Field from the result containing the count. (Use either name or value-field and label-field not both!)        |
| label-field                       | **string]link:\[expression** | Field from the result containing the label. (Use either name or value-field and label-field not both!)        |
| title  *(optional)*               | **string]link:\[expression** | The title of the series that appears in the legend and tooltip.                                               |
| show-marker  *(optional)*         | **string**                   | Whether to show marker or not.                                                                                |
| type  *(optional)*                | **string**                   | Type of chart to render.                                                                                      |
| range-selector  *(optional)*      | **boolean**                  | Where the input boxes should be enabled (from and to) Default:true                                            |
| navigator  *(optional)*           | **boolean**                  | Whether to enable the navigator beneath the chart. Default:true                                               |
| query  *(optional)*               | **object**                   | The search query from which to build links.                                                                   |
| measure  *(optional)*             | **string**                   | What fact to use as an alternative to count as quantitative value for a filter.                               |
| sort  *(optional)*                | **boolean**                  | Whether the data should be sort by the directive. Defaults to true.                                           |
| number-to-show  *(optional)*      | **Number**                   | The number of points to show on the graph. Applies only when using the platform attribute. (Default:25)       |
| selected-by-default  *(optional)* | **boolean**                  | Whether this series should be shown when the chart:display is using select-series="true" mode. Default: true. |