get_timestamp
Convert human-readable date and time strings into Unix timestamps for programming and data processing applications.
Instructions
Get the timestamp for the time.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_timestamp"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| time | No | The time to get the timestamp. Format: YYYY-MM-DD HH:mm:ss |
Implementation Reference
- src/index.ts:175-177 (handler)The core handler function that computes the Unix timestamp (milliseconds) for the given time string (parsed as UTC) or the current time.
function getTimestamp(time?: string) { return time ? dayjs.utc(time).valueOf() : dayjs().valueOf(); } - src/tools.ts:64-76 (schema)Defines the Tool object for 'get_timestamp' including name, description, and input schema allowing optional 'time' parameter.
export const GET_TIMESTAMP: Tool = { name: 'get_timestamp', description: 'Get the timestamp for the time.', inputSchema: { type: 'object', properties: { time: { type: 'string', description: 'The time to get the timestamp. Format: YYYY-MM-DD HH:mm:ss', }, }, }, }; - src/index.ts:30-34 (registration)Registers the GET_TIMESTAMP tool in the list of available tools returned by ListToolsRequest.
server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools: [CURRENT_TIME, RELATIVE_TIME, DAYS_IN_MONTH, GET_TIMESTAMP, CONVERT_TIME, GET_WEEK_YEAR], }; }); - src/index.ts:91-108 (handler)Dispatches the get_timestamp tool call: validates arguments, invokes getTimestamp handler, and formats the response content.
case 'get_timestamp': { if (!checkTimestampArgs(args)) { throw new Error(`Invalid arguments for tool: [${name}]`); } const time = args.time; const result = getTimestamp(time); return { success: true, content: [ { type: 'text', text: time ? `The timestamp of ${time} (parsed as UTC) is ${result} ms.` : `The current timestamp is ${result} ms.`, }, ], }; } - src/index.ts:231-238 (helper)Helper function to validate input arguments for the get_timestamp tool.
function checkTimestampArgs(args: unknown): args is { time?: string } { return ( typeof args === 'object' && args !== null && 'time' in args && (typeof args.time === 'string' || args.time === undefined) ); }