> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/time.md).

# Time

Time utilities for workflows: get the current time, calculate weekdays, and schedule workflow runs.

> **Deprecated or unavailable:** The Time provider is deprecated and will be removed on 2025-11-01. Please migrate to the StackAI provider which includes the same actions.

## Connectors

This provider has no standalone connector in the StackAI catalog. Configure any access or service settings in the selected action or feature, using its field reference below.

## Use an action

1. Add the required **Time** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

## Actions

### Task Scheduler

Schedule tasks to run Tools at specific times.

#### Inputs

| Field                   | Type            | Required | Description                                                                                                                                                                                                                    |
| ----------------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Timezone                | select (string) | No       | Timezone for the task scheduler. Available values: PACIFIC TIME, MOUNTAIN TIME, CENTRAL TIME, EASTERN TIME, ATLANTIC TIME, UTC, LONDON, PARIS, BERLIN, MOSCOW, DUBAI, INDIA, SINGAPORE, TOKYO, SYDNEY, AUCKLAND. Default: UTC. |
| Cron Expression         | string          | Yes      | Cron expression for scheduling (e.g. '0 0 \* \* \*' for daily at midnight).                                                                                                                                                    |
| Title                   | string          | Yes      | Title for the scheduled task.                                                                                                                                                                                                  |
| Human Readable Schedule | string          | Yes      | Schedule in human readable format (e.g. 'every day at midnight', 'every Monday at 9am').                                                                                                                                       |
| Task Instructions       | textarea        | Yes      | Instructions or description for this scheduled task.                                                                                                                                                                           |

#### Outputs

| Field   | Type   | Description                    |
| ------- | ------ | ------------------------------ |
| ID      | string | ID of the scheduled task.      |
| Cron ID | string | Cron ID of the scheduled task. |
| Result  | string | Result of the task scheduler.  |

### Current Time

A tool for getting the current time.

#### Inputs

| Field    | Type            | Required | Description                                                                                                                                                                                                                            |
| -------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Timezone | select (string) | No       | The timezone to get the current time in. Available values: PACIFIC TIME, MOUNTAIN TIME, CENTRAL TIME, EASTERN TIME, ATLANTIC TIME, UTC, LONDON, PARIS, BERLIN, MOSCOW, DUBAI, INDIA, SINGAPORE, TOKYO, SYDNEY, AUCKLAND. Default: UTC. |
| Format   | string          | No       | The format of the current time. Default: %Y-%m-%d %H:%M:%S.                                                                                                                                                                            |

#### Outputs

| Field        | Type   | Description                                            |
| ------------ | ------ | ------------------------------------------------------ |
| Current Time | string | The current time in the specified timezone and format. |

### Weekday Calculator

A tool for calculating the weekday of a given date.

#### Inputs

| Field | Type    | Required | Description                                        |
| ----- | ------- | -------- | -------------------------------------------------- |
| Year  | integer | Yes      | The year of the date to calculate the weekday of.  |
| Month | integer | Yes      | The month of the date to calculate the weekday of. |
| Day   | integer | Yes      | The day of the date to calculate the weekday of.   |

#### Outputs

| Field   | Type   | Description                    |
| ------- | ------ | ------------------------------ |
| Weekday | string | The weekday of the given date. |

## Triggers

A trigger starts a workflow when its configured event occurs. Configure the event and filters before enabling the trigger.

### Scheduled Execution

Trigger a workflow execution at a specific time.

#### Configuration

| Field            | Type                     | Required | Description                                                                                                                                                                                                                                                                                                                                      |
| ---------------- | ------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Frequency        | select (string)          | Yes      | How often the scheduled execution should run. Available values: Every day, Every week, Every month, Custom. Default: every\_day.                                                                                                                                                                                                                 |
| Day of the week  | select (string)          | No       | Day of the week when the scheduled execution should run (for weekly frequency). Available values: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.                                                                                                                                                                                |
| Days of the week | multiple\_select (array) | No       | Days of the week when the scheduled execution should run (for custom frequency). Available values: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.                                                                                                                                                                               |
| Hour             | select (string)          | Yes      | Hour of the day when the scheduled execution should run (0-23). Available values: 00, 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23. Default: 0.                                                                                                                                                    |
| Minute           | select (string)          | Yes      | Minute of the hour when the scheduled execution should run (0-59). Available values: 00, 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59. Default: 0. |
| Timezone         | select (string)          | Yes      | Timezone for the scheduled execution. Available values: PACIFIC TIME, MOUNTAIN TIME, CENTRAL TIME, EASTERN TIME, ATLANTIC TIME, UTC, LONDON, PARIS, BERLIN, MOSCOW, DUBAI, INDIA, SINGAPORE, TOKYO, SYDNEY, AUCKLAND. Default: UTC.                                                                                                              |

## Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# 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.stackai.com/integrations/catalog/time.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.
