# Get Users Current Time / Date

## Links

- Product page URL: https://www.agentpmt.com/marketplace/user-timezone-datetime
- Product markdown URL: https://www.agentpmt.com/marketplace/user-timezone-datetime?format=agent-md
- Product JSON URL: https://www.agentpmt.com/marketplace/user-timezone-datetime?format=agent-json

## Overview

- Product ID: 6987b3363a2127a981e41238
- Vendor: Apoth3osis
- Type: core utility
- Unit type: request
- Price: 300 credits
- Categories: Automation, Date & Time Utilities, Meeting & Calendar Scheduling, Time Tracking & Resource Planning, Appointment & Scheduling
- Generated at: 2026-05-21T08:23:08.867Z

### Page Description

Agents running in the cloud don't know what timezone their users are in. This tool returns the current date and time in the user's configured timezone so agents can schedule, format, and reason about time using the user's local context. The tool returns both local and UTC timestamps, the timezone name, and useful derived fields such as local date, local time, and UTC offset. This enables time aware workflows like reminders, deadlines, and calendar or messaging logic without repeatedly asking the user what time zone they are in.

### Agent Description

Get the user's current date and time in their configured timezone.

## Details

### Details

Agents running in the cloud don't know what timezone their users are in. This tool returns the current date and time in the user's configured timezone so agents can schedule, format, and reason about time using the user's local context. The tool returns both local and UTC timestamps, the timezone name, and useful derived fields such as local date, local time, and UTC offset. This enables time aware workflows like reminders, deadlines, and calendar or messaging logic without repeatedly asking the user what time zone they are in.

### Actions

- `get_current_datetime` (3 credits): Returns the current local datetime, UTC datetime, and derived fields (local date, local time, UTC offset, DST status) based on the user's configured timezone.

### Use Cases

Get current local time for a user, Build time aware reminders, Schedule messages in the user timezone, Add local timestamps to logs, Convert between UTC and user local time, Validate timezone configuration, Generate date strings for reports

### Workflows Using This Tool

#### Appointment Scheduling and Route Planner

Takes a CSV or spreadsheet file with addresses, asks for a starting drive time, time per stop, and starting address, then parses the addresses, optimizes the driving route, calculates estimated arrival and departure times for each location, and generates a CSV with the full schedule. Returns the optimized route map, Google Maps directions link, and the schedule CSV both locally and via notification. Ideal for field sales, service technicians, delivery planning, or any multi-stop appointment scheduling.

- Page URL: https://www.agentpmt.com/agent-workflow-skills/appointment-scheduling-and-route-planner
- Markdown URL: https://www.agentpmt.com/agent-workflow-skills/appointment-scheduling-and-route-planner?format=agent-md
- Published: 2026-04-19T18:29:42.593Z

### Related Content

No related content is currently linked to this product.

## Integration Details

### DynamicMCP

- Setup page URL: https://www.agentpmt.com/dynamic-mcp
- Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos
- ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos
- Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos
- Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to `https://api.agentpmt.com/mcp`. All tool execution happens in the cloud and the server cannot edit any files on your computer.

```bash
npm install -g @agentpmt/mcp-router
agentpmt-setup
```

### REST API

The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials.

- Purchase endpoint: https://api.agentpmt.com/products/purchase
- Authorization format: `Bearer <base64(apiKey:budgetKey)>`

```bash
curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \
  -d '{
    "product_id": "6987b3363a2127a981e41238",
    "parameters": {
      "action": "get_current_datetime"
    }
  }'
```

### Autonomous Agents

Do not use the abbreviated instructions in this product markdown for wallet-based invocation. Retrieve the full External Agent API markdown document instead.

- External Agent API page URL: https://www.agentpmt.com/external-agent-api
- External Agent API markdown URL: https://www.agentpmt.com/external-agent-api?format=agent-md

### Schema

#### Credentials

These runtime credentials should be provided under `parameters._credentials` when required.

- User Timezone (`user_timezone`, other, required)
  Help: Select your IANA timezone (e.g. US/Eastern, Europe/London, Asia/Tokyo).
  Connection ID: 698d297d2b32918aa8fe5590

#### Parameters

- Schema type: actions

```json
{
  "actions": {
    "get_current_datetime": {
      "description": "Returns the current local datetime, UTC datetime, and derived fields (local date, local time, UTC offset, DST status) based on the user's configured timezone."
    }
  }
}
```

### Usage Instructions

# User Timezone DateTime

Returns the current date and time based on the user's configured timezone setting. Uses IANA timezone names (e.g., "America/New_York", "Europe/London") to provide accurate local time with UTC offset, DST detection, and formatted date/time components.

## Actions

### get_current_datetime

Returns the current local datetime, UTC datetime, and derived fields for the user's configured timezone.

**Required Parameters:** None (timezone is automatically injected from the user's account settings)

**Response Fields:**
- `timezone` (string) -- IANA timezone name used (e.g., "America/Chicago")
- `utc_datetime` (string) -- Current UTC datetime in ISO 8601 format
- `local_datetime` (string) -- Current local datetime in ISO 8601 format
- `local_date` (string) -- Local date in YYYY-MM-DD format
- `local_time` (string) -- Local time in HH:MM:SS format
- `utc_offset` (string) -- UTC offset formatted as "+HH:MM" or "-HH:MM"
- `utc_offset_minutes` (integer) -- UTC offset in total minutes
- `is_dst` (boolean or null) -- Whether daylight saving time is currently active

**Example Request:**
```json
{
  "action": "get_current_datetime"
}
```

**Example Response:**
```json
{
  "action": "get_current_datetime",
  "timezone": "America/New_York",
  "utc_datetime": "2026-03-10T18:30:00+00:00",
  "local_datetime": "2026-03-10T14:30:00-04:00",
  "local_date": "2026-03-10",
  "local_time": "14:30:00",
  "utc_offset": "-04:00",
  "utc_offset_minutes": -240,
  "is_dst": true
}
```

## Workflows

1. **Check current time before scheduling** -- Call `get_current_datetime` to determine the user's current local time before creating calendar events or setting reminders.
2. **Time-aware greetings** -- Use `local_time` to provide contextual greetings (good morning/afternoon/evening) based on the user's actual local time.
3. **Cross-timezone coordination** -- Use `utc_datetime` and `utc_offset` together to help users coordinate meetings across different timezones.
4. **DST awareness** -- Check the `is_dst` field to inform users about daylight saving time status when scheduling recurring events.

## Notes

- The user's timezone is automatically provided from their account settings; no manual timezone input is needed.
- If the user has not configured a timezone, the request will fail with a validation error ("User timezone is required").
- All IANA timezone names are supported (e.g., "US/Eastern", "Asia/Tokyo", "Pacific/Auckland").
- The `is_dst` field may return `null` for timezones that do not observe daylight saving time.
- UTC offset is provided in both human-readable string format and numeric minutes for programmatic use.

### Frequently Asked Questions

No linked FAQs are currently available.

### Dependencies

This product has no public dependency products.