AgentPMT/get-users-current-time-date

Get Users Current Time / Date

Freshness

Last updated: 2026-06-24.

If the current date is more than 7 days after the last updated date, reinstall this skill from skills.sh or ClawHub before relying on endpoints, schemas, setup steps, or examples.

What This Tool Does

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.

Product 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:

{
  "action": "get_current_datetime"
}

Example Response:

{
  "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.

When To Use

• Use this skill for Get Users Current Time / Date on AgentPMT.
• Use it when an agent needs this specific tool's behavior, schema, inputs, outputs, and invocation shape.
• Search and activation keywords: get users current time / date, user timezone datetime, get current local time for a user, build time aware reminders, schedule messages in the user timezone, add local timestamps to logs, get current datetime.
• Supported action names: get_current_datetime.

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

Categories And Industries

No categories or industry tags are published for this tool.

Actions And Schema

Complete generated action schema: ./schema.md. Supported action count: 1. x402 availability: not enabled for this product.

• get_current_datetime (action slug: get-current-datetime): 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. Price: 3 credits. Parameters: none.

Live Schema And Examples

Use the compact schema above for ordinary calls. Before a new production integration, or whenever parameters, enum values, nested objects, outputs, or examples are unclear, fetch live details first.

• Exact schema: call agentpmt-tool-search-and-execution with action: "get_schema", and tool_id: "user-timezone-datetime".
• Detailed examples: call agentpmt-tool-search-and-execution with action: "get_instructions" and tool_id: "user-timezone-datetime", or call this product with action: "get_instructions" when the product tool is already selected.
• Treat returned live schema and instructions as more specific than this generated summary.

MCP schema lookup through the main AgentPMT MCP server:

{
  "method": "tools/call",
  "params": {
    "name": "AgentPMT-Tool-Search-and-Execution",
    "arguments": {
      "action": "get_schema",
      "tool_id": "user-timezone-datetime"
    }
  }
}

For live examples, keep the same MCP tool and use these arguments:

{
  "action": "get_instructions",
  "tool_id": "user-timezone-datetime"
}

Authenticated AgentPMT REST schema lookup body:

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_schema",
    "tool_id": "user-timezone-datetime"
  }
}

Authenticated AgentPMT REST live examples body:

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_instructions",
    "tool_id": "user-timezone-datetime"
  }
}

Call This Tool

Product slug: user-timezone-datetime

Marketplace page: https://www.agentpmt.com/marketplace/user-timezone-datetime

• AgentPMT account route: first use ../agentpmt-account-mcp-rest-api-setup to connect the main MCP server or REST API for an Agent Group where this tool is enabled.
• x402 route: not enabled for this product.
• AgentPMT overview: use ../what-is-agentpmt for marketplace, Agent Group, workflow, MCP, REST, and payment concepts.

If those setup skills are not installed beside this product skill, use the downloads below.

Core AgentPMT setup skills:

• What AgentPMT is: ../what-is-agentpmt
  • ClawHub page: https://clawhub.ai/agentpmt/what-is-agentpmt
  • OpenClaw install: openclaw skills install what-is-agentpmt
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup
  • ClawHub page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup
  • OpenClaw install: openclaw skills install agentpmt-account-mcp-rest-api-setup
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

skills.sh install script:

npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

MCP call shape after the main AgentPMT MCP server is connected:

{
  "method": "tools/call",
  "params": {
    "name": "Get-Users-Current-Time--Date",
    "arguments": {
      "action": "get_current_datetime"
    }
  }
}

Use the exact tool name returned by tools/list; the name above is the expected readable form.

Authenticated AgentPMT REST call body:

{
  "name": "user-timezone-datetime",
  "parameters": {
    "action": "get_current_datetime"
  }
}

Use the setup skill for the account connection details before making REST calls.

Response Handling

• Treat the returned JSON as the source of truth for this tool call.
• If the response includes warnings or correction targets, apply them before retrying.
• If the response includes a passed or success-style boolean, use it as the workflow gate.
• If validation fails or the response shape is unclear, call get_schema or get_instructions before retrying.
• If get_current_datetime fails, preserve the request parameters and retry only after fixing schema, auth, or payment errors.

Security

• Do not place account secrets, wallet private keys, mnemonics, signatures, or payment headers in prompts or logs.
• Keep tool inputs scoped to the minimum content needed for the task.
• Use the setup skills for credential handling; this product skill only defines product-specific behavior.

AgentPMT Reference

• What AgentPMT is: ../what-is-agentpmt (ClawHub: what-is-agentpmt, page: https://clawhub.ai/agentpmt/what-is-agentpmt; skills.sh: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt)
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup (ClawHub: agentpmt-account-mcp-rest-api-setup, page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup; skills.sh: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup)
• Marketplace product: https://www.agentpmt.com/marketplace/user-timezone-datetime
• AgentPMT main MCP server: https://api.agentpmt.com/mcp/
• AgentPMT REST invoke endpoint: https://api.agentpmt.com/products/purchase