Epoch Calculator
Unix timestamps, DST-aware time zone conversion, durations, cron schedules, and holiday countdowns
我該用這個嗎
品質與安全性
A
根據工具定義與協定合規性的自動化分析。
上下文成本
~4,927Token（工具定義）
~6.5 KB典型回應大小
顯著的注意力影響（128k 上下文的 3.85%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"epochcalc": {
"url": "https://epochcalc.com/mcp"
}
}
}遠端端點
https://epochcalc.com/mcpstreamable-http它能做什麼
工具清單
工具（8）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢time_now(timezone)
The current time: Unix epoch in seconds and milliseconds, ISO 8601, and the local wall-clock time in a given IANA time zone with its current UTC offset and DST status. Use this before any relative date reasoning.
輸入結構描述
{
"type": "object",
"properties": {
"timezone": {
"type": "string",
"description": "IANA time zone, e.g. \"America/New_York\". Defaults to UTC."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"epoch_seconds": {
"type": "integer",
"description": "Unix time in seconds."
},
"epoch_millis": {
"type": "integer",
"description": "Unix time in milliseconds."
},
"iso": {
"type": "string",
"description": "ISO 8601 with the zone offset."
},
"utc_iso": {
"type": "string",
"description": "ISO 8601 in UTC (Z)."
},
"timezone": {
"type": "string",
"description": "IANA zone name."
},
"offset": {
"type": "string",
"description": "UTC offset, e.g. \"+09:00\"."
},
"offset_minutes": {
"type": "integer",
"description": "UTC offset in minutes."
},
"abbreviation": {
"type": "string",
"description": "Zone abbreviation at that instant, e.g. \"BST\"."
},
"is_dst": {
"type": "boolean",
"description": "Whether daylight-saving time is in effect."
},
"weekday": {
"type": "string",
"description": "Full weekday name in English."
},
"rfc2822": {
"type": "string",
"description": "RFC 2822 date string."
},
"human": {
"type": "string",
"description": "Readable sentence with weekday, date, time and zone."
}
},
"required": [
"epoch_seconds",
"epoch_millis",
"iso",
"utc_iso",
"timezone",
"offset",
"offset_minutes",
"abbreviation",
"is_dst",
"weekday",
"rfc2822",
"human"
],
"description": "One instant described in one IANA time zone."
}🟢convert_timestamp(timestamp, unit, timezone)
Convert a Unix timestamp (seconds or milliseconds; auto-detected unless unit is given) to a human-readable date in a time zone, with ISO 8601, RFC 2822, UTC offset, DST flag, weekday, and a relative phrase like "3 days ago".
輸入結構描述
{
"type": "object",
"properties": {
"timestamp": {
"type": "number",
"description": "Unix timestamp. Values >= 1e11 are treated as milliseconds unless unit is set."
},
"unit": {
"type": "string",
"enum": [
"auto",
"seconds",
"milliseconds"
],
"description": "Interpretation of timestamp. Default auto."
},
"timezone": {
"type": "string",
"description": "IANA time zone, e.g. \"America/New_York\". Defaults to UTC."
}
},
"required": [
"timestamp"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"epoch_seconds": {
"type": "integer",
"description": "Unix time in seconds."
},
"epoch_millis": {
"type": "integer",
"description": "Unix time in milliseconds."
},
"iso": {
"type": "string",
"description": "ISO 8601 with the zone offset."
},
"utc_iso": {
"type": "string",
"description": "ISO 8601 in UTC (Z)."
},
"timezone": {
"type": "string",
"description": "IANA zone name."
},
"offset": {
"type": "string",
"description": "UTC offset, e.g. \"+09:00\"."
},
"offset_minutes": {
"type": "integer",
"description": "UTC offset in minutes."
},
"abbreviation": {
"type": "string",
"description": "Zone abbreviation at that instant, e.g. \"BST\"."
},
"is_dst": {
"type": "boolean",
"description": "Whether daylight-saving time is in effect."
},
"weekday": {
"type": "string",
"description": "Full weekday name in English."
},
"rfc2822": {
"type": "string",
"description": "RFC 2822 date string."
},
"human": {
"type": "string",
"description": "Readable sentence with weekday, date, time and zone."
},
"relative": {
"type": "string",
"description": "Relative phrase such as \"3 days ago\"."
}
},
"required": [
"epoch_seconds",
"epoch_millis",
"iso",
"utc_iso",
"timezone",
"offset",
"offset_minutes",
"abbreviation",
"is_dst",
"weekday",
"rfc2822",
"human",
"relative"
],
"description": "One instant described in one IANA time zone."
}🟢parse_datetime(input, timezone)
Parse a date/time string (ISO 8601, RFC 2822, HTTP date, SQL "YYYY-MM-DD HH:mm:ss", or a Unix timestamp) into a Unix timestamp and a normalized description. Strings without an offset are interpreted in the given time zone.
輸入結構描述
{
"type": "object",
"properties": {
"input": {
"type": "string",
"description": "The date/time text to parse."
},
"timezone": {
"type": "string",
"description": "Zone to assume when the input carries no offset, and to report the result in. Defaults to UTC."
}
},
"required": [
"input"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"epoch_seconds": {
"type": "integer",
"description": "Unix time in seconds."
},
"epoch_millis": {
"type": "integer",
"description": "Unix time in milliseconds."
},
"iso": {
"type": "string",
"description": "ISO 8601 with the zone offset."
},
"utc_iso": {
"type": "string",
"description": "ISO 8601 in UTC (Z)."
},
"timezone": {
"type": "string",
"description": "IANA zone name."
},
"offset": {
"type": "string",
"description": "UTC offset, e.g. \"+09:00\"."
},
"offset_minutes": {
"type": "integer",
"description": "UTC offset in minutes."
},
"abbreviation": {
"type": "string",
"description": "Zone abbreviation at that instant, e.g. \"BST\"."
},
"is_dst": {
"type": "boolean",
"description": "Whether daylight-saving time is in effect."
},
"weekday": {
"type": "string",
"description": "Full weekday name in English."
},
"rfc2822": {
"type": "string",
"description": "RFC 2822 date string."
},
"human": {
"type": "string",
"description": "Readable sentence with weekday, date, time and zone."
},
"input": {
"type": "string",
"description": "The text that was parsed."
}
},
"required": [
"epoch_seconds",
"epoch_millis",
"iso",
"utc_iso",
"timezone",
"offset",
"offset_minutes",
"abbreviation",
"is_dst",
"weekday",
"rfc2822",
"human",
"input"
],
"description": "One instant described in one IANA time zone."
}🟢convert_timezone(datetime, from_timezone, to_timezone)
Convert a wall-clock date/time from one IANA time zone to another, correctly across daylight-saving transitions. Returns both sides with offsets, the hour difference at that instant, and whether either zone is on DST.
輸入結構描述
{
"type": "object",
"properties": {
"datetime": {
"type": "string",
"description": "ISO 8601 date/time, e.g. \"2026-09-06T09:30\". If it has no offset it is read as wall time in from_timezone."
},
"from_timezone": {
"type": "string",
"description": "Source IANA zone, e.g. \"Asia/Tokyo\"."
},
"to_timezone": {
"type": "string",
"description": "Target IANA zone, e.g. \"Europe/London\"."
}
},
"required": [
"datetime",
"from_timezone",
"to_timezone"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"source": {
"type": "object",
"description": "One instant described in one IANA time zone.",
"properties": {
"epoch_seconds": {
"type": "integer",
"description": "Unix time in seconds."
},
"epoch_millis": {
"type": "integer",
"description": "Unix time in milliseconds."
},
"iso": {
"type": "string",
"description": "ISO 8601 with the zone offset."
},
"utc_iso": {
"type": "string",
"description": "ISO 8601 in UTC (Z)."
},
"timezone": {
"type": "string",
"description": "IANA zone name."
},
"offset": {
"type": "string",
"description": "UTC offset, e.g. \"+09:00\"."
},
"offset_minutes": {
"type": "integer",
"description": "UTC offset in minutes."
},
"abbreviation": {
"type": "string",
"description": "Zone abbreviation at that instant, e.g. \"BST\"."
},
"is_dst": {
"type": "boolean",
"description": "Whether daylight-saving time is in effect."
},
"weekday": {
"type": "string",
"description": "Full weekday name in English."
},
"rfc2822": {
"type": "string",
"description": "RFC 2822 date string."
},
"human": {
"type": "string",
"description": "Readable sentence with weekday, date, time and zone."
}
},
"required": [
"epoch_seconds",
"epoch_millis",
"iso",
"utc_iso",
"timezone",
"offset",
"offset_minutes",
"abbreviation",
"is_dst",
"weekday",
"rfc2822",
"human"
]
},
"target": {
"type": "object",
"description": "One instant described in one IANA time zone.",
"properties": {
"epoch_seconds": {
"type": "integer",
"description": "Unix time in seconds."
},
"epoch_millis": {
"type": "integer",
"description": "Unix time in milliseconds."
},
"iso": {
"type": "string",
"description": "ISO 8601 with the zone offset."
},
"utc_iso": {
"type": "string",
"description": "ISO 8601 in UTC (Z)."
},
"timezone": {
"type": "string",
"description": "IANA zone name."
},
"offset": {
"type": "string",
"description": "UTC offset, e.g. \"+09:00\"."
},
"offset_minutes": {
"type": "integer",
"description": "UTC offset in minutes."
},
"abbreviation": {
"type": "string",
"description": "Zone abbreviation at that instant, e.g. \"BST\"."
},
"is_dst": {
"type": "boolean",
"description": "Whether daylight-saving time is in effect."
},
"weekday": {
"type": "string",
"description": "Full weekday name in English."
},
"rfc2822": {
"type": "string",
"description": "RFC 2822 date string."
},
"human": {
"type": "string",
"description": "Readable sentence with weekday, date, time and zone."
}
},
"required": [
"epoch_seconds",
"epoch_millis",
"iso",
"utc_iso",
"timezone",
"offset",
"offset_minutes",
"abbreviation",
"is_dst",
"weekday",
"rfc2822",
"human"
]
},
"difference_hours": {
"type": "number",
"description": "target offset minus source offset, in hours."
},
"same_instant_utc": {
"type": "string",
"description": "The shared instant as ISO 8601 UTC."
}
},
"required": [
"source",
"target",
"difference_hours",
"same_instant_utc"
]
}🟢date_duration(start, end, timezone, include_end)
The exact duration between two dates or date-times: calendar years/months/days, plus total days, hours, minutes and seconds, and the number of weekdays (Mon-Fri). Handles leap years and DST via the IANA database.
輸入結構描述
{
"type": "object",
"properties": {
"start": {
"type": "string",
"description": "Start date/time (ISO 8601 or Unix timestamp)."
},
"end": {
"type": "string",
"description": "End date/time (ISO 8601 or Unix timestamp)."
},
"timezone": {
"type": "string",
"description": "IANA time zone, e.g. \"America/New_York\". Defaults to UTC."
},
"include_end": {
"type": "boolean",
"description": "Count the end date as a full day (adds one day). Default false."
}
},
"required": [
"start",
"end"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"start": {
"type": "object",
"description": "One instant described in one IANA time zone.",
"properties": {
"epoch_seconds": {
"type": "integer",
"description": "Unix time in seconds."
},
"epoch_millis": {
"type": "integer",
"description": "Unix time in milliseconds."
},
"iso": {
"type": "string",
"description": "ISO 8601 with the zone offset."
},
"utc_iso": {
"type": "string",
"description": "ISO 8601 in UTC (Z)."
},
"timezone": {
"type": "string",
"description": "IANA zone name."
},
"offset": {
"type": "string",
"description": "UTC offset, e.g. \"+09:00\"."
},
"offset_minutes": {
"type": "integer",
"description": "UTC offset in minutes."
},
"abbreviation": {
"type": "string",
"description": "Zone abbreviation at that instant, e.g. \"BST\"."
},
"is_dst": {
"type": "boolean",
"description": "Whether daylight-saving time is in effect."
},
"weekday": {
"type": "string",
"description": "Full weekday name in English."
},
"rfc2822": {
"type": "string",
"description": "RFC 2822 date string."
},
"human": {
"type": "string",
"description": "Readable sentence with weekday, date, time and zone."
}
},
"required": [
"epoch_seconds",
"epoch_millis",
"iso",
"utc_iso",
"timezone",
"offset",
"offset_minutes",
"abbreviation",
"is_dst",
"weekday",
"rfc2822",
"human"
]
},
"end": {
"type": "object",
"description": "One instant described in one IANA time zone.",
"properties": {
"epoch_seconds": {
"type": "integer",
"description": "Unix time in seconds."
},
"epoch_millis": {
"type": "integer",
"description": "Unix time in milliseconds."
},
"iso": {
"type": "string",
"description": "ISO 8601 with the zone offset."
},
"utc_iso": {
"type": "string",
"description": "ISO 8601 in UTC (Z)."
},
"timezone": {
"type": "string",
"description": "IANA zone name."
},
"offset": {
"type": "string",
"description": "UTC offset, e.g. \"+09:00\"."
},
"offset_minutes": {
"type": "integer",
"description": "UTC offset in minutes."
},
"abbreviation": {
"type": "string",
"description": "Zone abbreviation at that instant, e.g. \"BST\"."
},
"is_dst": {
"type": "boolean",
"description": "Whether daylight-saving time is in effect."
},
"weekday": {
"type": "string",
"description": "Full weekday name in English."
},
"rfc2822": {
"type": "string",
"description": "RFC 2822 date string."
},
"human": {
"type": "string",
"description": "Readable sentence with weekday, date, time and zone."
}
},
"required": [
"epoch_seconds",
"epoch_millis",
"iso",
"utc_iso",
"timezone",
"offset",
"offset_minutes",
"abbreviation",
"is_dst",
"weekday",
"rfc2822",
"human"
]
},
"direction": {
"type": "string",
"enum": [
"forward",
"backward"
]
},
"years": {
"type": "integer"
},
"months": {
"type": "integer"
},
"days": {
"type": "integer"
},
"hours": {
"type": "integer"
},
"minutes": {
"type": "integer"
},
"seconds": {
"type": "integer"
},
"total_days": {
"type": "integer"
},
"total_hours": {
"type": "integer"
},
"total_minutes": {
"type": "integer"
},
"total_seconds": {
"type": "integer"
},
"weekdays": {
"type": "integer",
"description": "Monday to Friday days in the span."
},
"weekend_days": {
"type": "integer"
},
"human": {
"type": "string",
"description": "Calendar duration in words, e.g. \"1 year, 2 months, 3 days\"."
}
},
"required": [
"start",
"end",
"direction",
"years",
"months",
"days",
"hours",
"minutes",
"seconds",
"total_days",
"total_hours",
"total_minutes",
"total_seconds",
"weekdays",
"weekend_days",
"human"
]
}🟢epoch_math(timestamp, add, subtract, timezone)
Add to or subtract from a Unix timestamp in calendar-aware units (years, months, weeks, days, hours, minutes, seconds) in a time zone, e.g. "now + 30 days" or "1748736543 - 3 months". Returns the resulting timestamp in every format.
輸入結構描述
{
"type": "object",
"properties": {
"timestamp": {
"type": "number",
"description": "Base Unix timestamp (seconds or milliseconds, auto-detected). Omit for now."
},
"add": {
"type": "object",
"properties": {
"years": {
"type": "number"
},
"months": {
"type": "number"
},
"weeks": {
"type": "number"
},
"days": {
"type": "number"
},
"hours": {
"type": "number"
},
"minutes": {
"type": "number"
},
"seconds": {
"type": "number"
}
},
"additionalProperties": false,
"description": "Units to add."
},
"subtract": {
"type": "object",
"properties": {
"years": {
"type": "number"
},
"months": {
"type": "number"
},
"weeks": {
"type": "number"
},
"days": {
"type": "number"
},
"hours": {
"type": "number"
},
"minutes": {
"type": "number"
},
"seconds": {
"type": "number"
}
},
"additionalProperties": false,
"description": "Units to subtract."
},
"timezone": {
"type": "string",
"description": "Zone in which calendar units (months, days across DST) are applied. Defaults to UTC."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"base": {
"type": "object",
"description": "One instant described in one IANA time zone.",
"properties": {
"epoch_seconds": {
"type": "integer",
"description": "Unix time in seconds."
},
"epoch_millis": {
"type": "integer",
"description": "Unix time in milliseconds."
},
"iso": {
"type": "string",
"description": "ISO 8601 with the zone offset."
},
"utc_iso": {
"type": "string",
"description": "ISO 8601 in UTC (Z)."
},
"timezone": {
"type": "string",
"description": "IANA zone name."
},
"offset": {
"type": "string",
"description": "UTC offset, e.g. \"+09:00\"."
},
"offset_minutes": {
"type": "integer",
"description": "UTC offset in minutes."
},
"abbreviation": {
"type": "string",
"description": "Zone abbreviation at that instant, e.g. \"BST\"."
},
"is_dst": {
"type": "boolean",
"description": "Whether daylight-saving time is in effect."
},
"weekday": {
"type": "string",
"description": "Full weekday name in English."
},
"rfc2822": {
"type": "string",
"description": "RFC 2822 date string."
},
"human": {
"type": "string",
"description": "Readable sentence with weekday, date, time and zone."
}
},
"required": [
"epoch_seconds",
"epoch_millis",
"iso",
"utc_iso",
"timezone",
"offset",
"offset_minutes",
"abbreviation",
"is_dst",
"weekday",
"rfc2822",
"human"
]
},
"result": {
"type": "object",
"description": "One instant described in one IANA time zone.",
"properties": {
"epoch_seconds": {
"type": "integer",
"description": "Unix time in seconds."
},
"epoch_millis": {
"type": "integer",
"description": "Unix time in milliseconds."
},
"iso": {
"type": "string",
"description": "ISO 8601 with the zone offset."
},
"utc_iso": {
"type": "string",
"description": "ISO 8601 in UTC (Z)."
},
"timezone": {
"type": "string",
"description": "IANA zone name."
},
"offset": {
"type": "string",
"description": "UTC offset, e.g. \"+09:00\"."
},
"offset_minutes": {
"type": "integer",
"description": "UTC offset in minutes."
},
"abbreviation": {
"type": "string",
"description": "Zone abbreviation at that instant, e.g. \"BST\"."
},
"is_dst": {
"type": "boolean",
"description": "Whether daylight-saving time is in effect."
},
"weekday": {
"type": "string",
"description": "Full weekday name in English."
},
"rfc2822": {
"type": "string",
"description": "RFC 2822 date string."
},
"human": {
"type": "string",
"description": "Readable sentence with weekday, date, time and zone."
}
},
"required": [
"epoch_seconds",
"epoch_millis",
"iso",
"utc_iso",
"timezone",
"offset",
"offset_minutes",
"abbreviation",
"is_dst",
"weekday",
"rfc2822",
"human"
]
},
"delta_seconds": {
"type": "integer",
"description": "result minus base, in seconds."
}
},
"required": [
"base",
"result",
"delta_seconds"
]
}🟢cron_next_runs(expression, timezone, count, from)
Explain a 5- or 6-field cron expression in plain English and list its next run times in a time zone (as ISO 8601 and Unix timestamps). Use to answer "when does this cron job run next?" or to validate an expression.
輸入結構描述
{
"type": "object",
"properties": {
"expression": {
"type": "string",
"description": "Cron expression, e.g. \"0 9 * * 1-5\"."
},
"timezone": {
"type": "string",
"description": "Zone the schedule is evaluated in. Defaults to UTC."
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"description": "How many upcoming runs to return. Default 5."
},
"from": {
"type": "string",
"description": "Start evaluating after this date/time (ISO 8601). Defaults to now."
}
},
"required": [
"expression"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"expression": {
"type": "string"
},
"description": {
"type": "string",
"description": "Plain-English reading of the expression."
},
"timezone": {
"type": "string"
},
"next_runs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"iso": {
"type": "string"
},
"utc_iso": {
"type": "string"
},
"epoch_seconds": {
"type": "integer"
},
"weekday": {
"type": "string"
}
},
"required": [
"iso",
"utc_iso",
"epoch_seconds",
"weekday"
]
}
}
},
"required": [
"expression",
"description",
"timezone",
"next_runs"
]
}🟢days_until(event, date, timezone)
Countdown to a holiday or to a date: days, hours and minutes remaining, and the next occurrence date. Pass an event slug (e.g. "christmas", "thanksgiving", "easter", "super-bowl") or a date (YYYY-MM-DD). Call with no arguments to list the known events.
輸入結構描述
{
"type": "object",
"properties": {
"event": {
"type": "string",
"description": "Event slug from the known list, e.g. \"christmas\"."
},
"date": {
"type": "string",
"description": "A target date (YYYY-MM-DD) or date-time (ISO 8601) instead of an event."
},
"timezone": {
"type": "string",
"description": "Zone whose midnight starts the target day. Defaults to UTC."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"events": {
"type": "array",
"description": "Known events (only when called with no arguments).",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
}
},
"required": [
"slug",
"name"
]
}
},
"name": {
"type": "string"
},
"target": {
"type": "object",
"description": "One instant described in one IANA time zone.",
"properties": {
"epoch_seconds": {
"type": "integer",
"description": "Unix time in seconds."
},
"epoch_millis": {
"type": "integer",
"description": "Unix time in milliseconds."
},
"iso": {
"type": "string",
"description": "ISO 8601 with the zone offset."
},
"utc_iso": {
"type": "string",
"description": "ISO 8601 in UTC (Z)."
},
"timezone": {
"type": "string",
"description": "IANA zone name."
},
"offset": {
"type": "string",
"description": "UTC offset, e.g. \"+09:00\"."
},
"offset_minutes": {
"type": "integer",
"description": "UTC offset in minutes."
},
"abbreviation": {
"type": "string",
"description": "Zone abbreviation at that instant, e.g. \"BST\"."
},
"is_dst": {
"type": "boolean",
"description": "Whether daylight-saving time is in effect."
},
"weekday": {
"type": "string",
"description": "Full weekday name in English."
},
"rfc2822": {
"type": "string",
"description": "RFC 2822 date string."
},
"human": {
"type": "string",
"description": "Readable sentence with weekday, date, time and zone."
}
},
"required": [
"epoch_seconds",
"epoch_millis",
"iso",
"utc_iso",
"timezone",
"offset",
"offset_minutes",
"abbreviation",
"is_dst",
"weekday",
"rfc2822",
"human"
]
},
"is_past": {
"type": "boolean"
},
"days": {
"type": "integer"
},
"hours": {
"type": "integer"
},
"minutes": {
"type": "integer"
},
"total_seconds": {
"type": "integer"
},
"human": {
"type": "string",
"description": "e.g. \"in 12 days, 5 hours\"."
}
},
"description": "With an event or date: the countdown fields. With no arguments: only the events list."
}社群
證據
近期觀測
已驗證未記錄版本8 個工具
已驗證未記錄版本8 個工具