> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/flow/tutorials/components/calendar/how-to-customize-time-spans.md).

# How to Customize Time Spans

## Introduction

[Avonni Calendar](/flow/flow-components/calendar.md)'s enhanced Time Span settings enable detailed customization, allowing you to adjust views from a single day to multiple weeks. View 2-4 consecutive days, weeks, or a custom number of weeks in the 'Month' view, optimizing project tracking and event planning. :

## **Finding Time Span Settings**

{% @arcade/embed url="<https://app.arcade.software/share/hXiWQGnNR6Rzn9GiL4LM>" flowId="hXiWQGnNR6Rzn9GiL4LM" %}

## **Understanding Time Span Options**

Tailor each Time Span you create with these settings:

* **Label:** Give your view a descriptive name for easy reference.
* **Icon Name:** Select an icon for quick visual identification.
* **Unit:** Choose whether this view will focus on 'days', 'weeks', or 'months'.
* **Span:** Determine the number of units to display (e.g., a 'Week' unit with a span of 2 will show a two-week view).
* **Timeline Headers (Timeline View Only for the Selected Display):** Control how dates are displayed at the top of your Timeline view.

## **Specific Use Cases**

Avonni Calendar's Time Span settings offer unparalleled flexibility when visualizing your Salesforce data. Whether focused on closing deals, managing renewals, or tracking campaign performance, Time Spans helps you create tailored views that boost productivity and inform decision-making.

**See it in action**: The examples below demonstrate configuring Time Spans for common Salesforce use cases. Adapt these settings to gain valuable insights from your data and streamline your processes.

### **Sales Rep**

**Closing Week**: Unit: Week, Span: 1 (Focus on closing deals within the current week)

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-811d7706865b9286ecad27b1dba5e24d881e3b08%2F2024-04-12_09-47-58.png?alt=media" alt=""><figcaption></figcaption></figure>

**Pipeline Review**: Unit: Month, Span: 1 (Track opportunities progressing through the sales funnel)

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-f2671c5ef3d09b7a969924bbbabf5a49309b6ad6%2F2024-04-12_09-46-37.png?alt=media" alt=""><figcaption></figcaption></figure>

### **Sales Manager**

**Team Forecast**: Unit: Month, Span: 3, Timeline Headers: Week and Month

* **View Description:** See your team's sales performance across three months, with each month broken down into weekly segments for granular tracking

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-13e36fee8ac452aec1d694a7005a05e58080aac9%2F2024-04-12_10-08-25.png?alt=media" alt=""><figcaption></figcaption></figure>

**Coaching Calendar**: Unit: Day, Span: 2 (Schedule 1-on-1s and team meetings over two days)

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-983b16b753c52a16bed8f07ac336c8b3f17c9c72%2F2024-04-12_10-14-41.png?alt=media" alt=""><figcaption></figcaption></figure>

### **Customer Success Manager**

**Renewal Timeline**: Unit: Month, Span: 2, Timeline Headers: Week and Month

* **View Description:** See upcoming renewals across two months, broken down into weekly segments to plan outreach strategies easily.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-8b87002edc193423ea1f0995b6cc2d4a5312a2c5%2F2024-04-12_10-41-30.png?alt=media" alt=""><figcaption></figcaption></figure>

**Onboarding Schedule**: Display: Calendar, Time Span: Week, Span: 2

* **View Description:** Visualize a two-week onboarding timeline in a calendar format, ensuring a smooth start for new clients.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-b7d85354d65637bd2b4a05cefc1cdbc84363cbfc%2F2024-04-12_10-45-18.png?alt=media" alt=""><figcaption></figcaption></figure>

### **Sales Operations**

**Campaign Performance:** Unit: Week, Span: 3

* **View Description:** Track the effectiveness of your campaign over the next three weeks with a weekly calendar view. Monitor key metrics and lead generation for informed adjustments and optimizations.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-1d112e435ccbc25369892c3c30b8b815981b4c65%2F2024-04-12_17-30-49%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

### Other

**Timeline Headers** (specific to the 'Timeline' view): Customize the header details for your timeline. This is especially useful in the 'Timeline' view. For instance, to show week numbers, set your calendar to 'Timeline', choose 'Week' as your time span, and then configure the timeline headers to display 'Week' and 'Month'.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fgit-blob-8208c17d9ebb4b06359cd09bead1a76bda38d2c1%2FConfiguring%20Time%20spans.webp?alt=media" alt=""><figcaption></figcaption></figure>

## **Key Takeaway**

Think about the Salesforce data you interact with most. Time Spans can help you visualize that data in ways that optimize your flow.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/flow/tutorials/components/calendar/how-to-customize-time-spans.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.