---
title: "series"
slug: "avatar-series"
updated: 2026-02-09T19:12:20Z
published: 2026-02-09T19:12:20Z
canonical: "docs.doc-know.com/avatar-series"
---

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

# series

### avatar.series

Converts an array of moments into a new array of JSON objects that represents a **data series**.

Data series arrays can be displayed in visual plots via [app.plot](http://docs.doc-know.com/v1/docs/app-plot) and [ai.insights.plot](http://docs.doc-know.com/v1/docs/ai-insights-plot).

### Input Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| **array** | Any | Yes | Array of moments |
| **[format]** | Text | No | DateTime format specifier for labels |

### Returns

Type: **Array** (of JSON objects)

Returns a new array of JSON objects. Each object in the returned array will have two properties: **label** and **value**.

### DateTime Formats

Below is a collection of popular DateTime **format** values. Additional formatters are supported and can be found [here](https://docs.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-format-strings).

| Format | Description |
| --- | --- |
| **MMMM** | December (**default**) |
| **MMM** | Dec |
| **MM** | 12 |
| **M** | December 25 |
| **dddd** | Tuesday |
| **ddd** | Tue |
| **dd** | 25 |
| **d** | 12/25/2019 |
| **yyyy** | 2019 |
| **yy** | 19 |
| **y** | December 2019 |
| **MM/dd/yyyy** | 12/25/2019 |

### Examples

```
// get last 5 moments of vital sign identified by 12345
var moments = avatar.get("12345", "Vitals", 5);

// convert moments to data series for plotting
var series = avatar.series(moments);

// render plot with locker token 'AAA' to insights panel
ai.insights.plot("plot1", true, "Testing", "AAA", series);
```

### Remarks

Use this function when you want plot moments returned from [avatar.get](http://docs.doc-know.com/v1/docs/avatar-get) via [app.plot](http://docs.doc-know.com/v1/docs/app-plot) and [ai.insights.plot](http://docs.doc-know.com/v1/docs/ai-insights-plot).