current_timestamp

Retrieve the current timestamp in the China time zone (GMT+8), formatted as datetime, date, time, Unix timestamp, or readable text for accurate time-based financial data processing.

Instructions

获取当前东八区（中国时区）的时间戳，包括年月日时分秒信息

Input Schema

TableJSON Schema

Name	Required	Description	Default
`format`	No	时间格式，可选值：datetime(完整日期时间，默认)、date(仅日期)、time(仅时间)、timestamp(Unix时间戳)、readable(可读格式)

Implementation Reference

src/index.ts:44-108 (handler)

The core handler function for the 'current_timestamp' tool. It computes the current time in China timezone (UTC+8), supports formatting options (datetime, date, time, timestamp, readable), includes Chinese weekday, returns structured MCP content with markdown, and handles errors.

async run(args?: { format?: string }) {
  try {
    // 获取当前UTC时间
    const now = new Date();
    
    // 转换为东八区时间（UTC+8）
    const chinaTime = new Date(now.getTime() + (8 * 60 * 60 * 1000));
    
    const format = args?.format || 'datetime';
    
    // 格式化时间函数
    const formatNumber = (num: number): string => num.toString().padStart(2, '0');
    
    const year = chinaTime.getUTCFullYear();
    const month = formatNumber(chinaTime.getUTCMonth() + 1);
    const day = formatNumber(chinaTime.getUTCDate());
    const hour = formatNumber(chinaTime.getUTCHours());
    const minute = formatNumber(chinaTime.getUTCMinutes());
    const second = formatNumber(chinaTime.getUTCSeconds());
    
    // 星期几
    const weekdays = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
    const weekday = weekdays[chinaTime.getUTCDay()];
    
    let result: string;
    
    switch (format) {
      case 'date':
        result = `${year}-${month}-${day}`;
        break;
      case 'time':
        result = `${hour}:${minute}:${second}`;
        break;
      case 'timestamp':
        result = Math.floor(chinaTime.getTime() / 1000).toString();
        break;
      case 'readable':
        result = `${year}年${month}月${day}日 ${weekday} ${hour}时${minute}分${second}秒`;
        break;
      case 'datetime':
      default:
        result = `${year}-${month}-${day} ${hour}:${minute}:${second}`;
        break;
    }
    
    return {
      content: [
        {
          type: "text",
          text: `## 🕐 当前东八区时间\n\n格式: ${format}\n时间: ${result}\n\n时区: 东八区 (UTC+8)\n星期: ${weekday}\n\n---\n\n*时间戳获取于: ${year}-${month}-${day} ${hour}:${minute}:${second}*`
        }
      ]
    };
  } catch (error) {
    return {
      content: [
        {
          type: "text", 
          text: `❌ 获取时间戳时发生错误: ${error instanceof Error ? error.message : String(error)}`
        }
      ],
      isError: true
    };
  }
}

src/index.ts:35-42 (schema)

Input schema for the current_timestamp tool, defining an optional 'format' parameter as string with description of supported formats.

parameters: {
  type: "object",
  properties: {
    format: {
      type: "string",
      description: "时间格式，可选值：datetime(完整日期时间，默认)、date(仅日期)、time(仅时间)、timestamp(Unix时间戳)、readable(可读格式)"
    }
  }

src/index.ts:228-231 (registration)

Registration/dispatch in the CallToolRequestSchema handler: extracts 'format' argument and calls the tool's run method.

case "current_timestamp": {
  const format = request.params.arguments?.format ? String(request.params.arguments.format) : undefined;
  return await timestampTool.run({ format });
}

src/httpServer.ts:39-57 (handler)

Compact version of the core handler function for HTTP server, identical logic to stdio version but simplified response without error handling or full weekday in output.

async run(args?: { format?: string }) {
  const now = new Date();
  const chinaTime = new Date(now.getTime() + (8 * 60 * 60 * 1000));
  const format = args?.format || 'datetime';
  const pad = (n: number) => n.toString().padStart(2, '0');
  const y = chinaTime.getUTCFullYear();
  const m = pad(chinaTime.getUTCMonth() + 1);
  const d = pad(chinaTime.getUTCDate());
  const hh = pad(chinaTime.getUTCHours());
  const mm = pad(chinaTime.getUTCMinutes());
  const ss = pad(chinaTime.getUTCSeconds());
  const weekdays = ['星期日','星期一','星期二','星期三','星期四','星期五','星期六'];
  const wd = weekdays[chinaTime.getUTCDay()];
  let result = `${y}-${m}-${d} ${hh}:${mm}:${ss}`;
  if (format === 'date') result = `${y}-${m}-${d}`;
  if (format === 'time') result = `${hh}:${mm}:${ss}`;
  if (format === 'timestamp') result = Math.floor(chinaTime.getTime()/1000).toString();
  if (format === 'readable') result = `${y}年${m}月${d}日 ${wd} ${hh}时${mm}分${ss}秒`;
  return { content: [{ type: 'text', text: `## 🕐 当前东八区时间\n\n格式: ${format}\n时间: ${result}\n星期: ${wd}` }] };

src/httpServer.ts:246-247 (registration)

Dispatch case in the HTTP /mcp POST tools/call handler for current_timestamp.

case 'current_timestamp':
  return await timestampTool.run({ format: args?.format ? String(args.format) : undefined });

FinanceMCP