{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"download-time"},"result":{"entity_type":"calculator","id":"download-time","calculator_id":"download-time","canonical_url":"https://tttkmbb.com/everyday/download-time","name":"Download Time Calculator","title":"Download Time Calculator – Transfer Time from File Size and Connection Speed","category":"everyday","category_name":"Everyday Life","tool_name":"estimate_download_time","featured_mcp_tool":false,"description":"Computes how long a file transfer takes from the file size (MB, GB, TB) and the connection speed (Mbit/s, MB/s or Gbit/s), converting bytes to bits at 8 bits per byte with decimal (SI) prefixes.","use_when":"You want to estimate how long a download, upload or backup will take at a given bandwidth, or compare connection speeds.","do_not_use_when":"You need to convert between data-storage units themselves (use data-storage); real transfers are also slowed by protocol overhead, server limits and Wi-Fi conditions.","inputs":[{"name":"file_size","label":"File size","type":"number","required":true,"max":1000000000,"exclusive_min":0,"description":"Size of the file in the chosen unit.","example":4.7},{"name":"size_unit","label":"Size unit","type":"enum","required":false,"default":"gb","values":[{"value":"mb","label":"MB (megabytes, 10⁶ bytes)","aliases":["megabyte","megabytes"]},{"value":"gb","label":"GB (gigabytes, 10⁹ bytes)","aliases":["gigabyte","gigabytes"]},{"value":"tb","label":"TB (terabytes, 10¹² bytes)","aliases":["terabyte","terabytes"]}],"description":"Unit of file_size (decimal SI prefixes).","example":"gb"},{"name":"speed","label":"Connection speed","type":"number","required":true,"max":1000000000,"exclusive_min":0,"description":"Transfer rate in the chosen unit.","example":100},{"name":"speed_unit","label":"Speed unit","type":"enum","required":false,"default":"mbit_per_s","values":[{"value":"mbit_per_s","label":"Mbit/s (Mbps, megabits per second)","aliases":["mbit/s","megabit","megabits","megabits per second"]},{"value":"mbyte_per_s","label":"MB/s (MBps, megabytes per second)","aliases":["mb/s","megabyte","megabytes","megabytes per second"]},{"value":"gbit_per_s","label":"Gbit/s (Gbps, gigabits per second)","aliases":["gbit/s","gigabit","gigabits","gigabits per second"]}],"description":"Unit of speed. Internet plans are quoted in megabits per second (Mbps); browsers show megabytes per second (MB/s), which is 8 times larger per unit.","example":"mbit_per_s"}],"outputs":[{"name":"seconds","label":"Transfer time","type":"number","unit":"s","decimals":1,"description":"file_size in bits / speed in bits per second."},{"name":"time_formatted","label":"Transfer time","type":"string","decimals":4,"description":"Same time as h:mm:ss."},{"name":"minutes","label":"Transfer time","type":"number","unit":"min","decimals":2,"description":"seconds / 60."},{"name":"hours","label":"Transfer time","type":"number","unit":"h","decimals":3,"description":"seconds / 3600."},{"name":"speed_mb_per_s","label":"Speed in MB/s","type":"number","unit":"MB/s","decimals":3,"description":"Connection speed expressed in megabytes per second."}],"input_schema":{"type":"object","properties":{"file_size":{"description":"Size of the file in the chosen unit.","type":"number","maximum":1000000000,"exclusiveMinimum":0,"examples":[4.7]},"size_unit":{"description":"Unit of file_size (decimal SI prefixes).","type":"string","enum":["mb","gb","tb"],"default":"gb","examples":["gb"]},"speed":{"description":"Transfer rate in the chosen unit.","type":"number","maximum":1000000000,"exclusiveMinimum":0,"examples":[100]},"speed_unit":{"description":"Unit of speed. Internet plans are quoted in megabits per second (Mbps); browsers show megabytes per second (MB/s), which is 8 times larger per unit.","type":"string","enum":["mbit_per_s","mbyte_per_s","gbit_per_s"],"default":"mbit_per_s","examples":["mbit_per_s"]}},"additionalProperties":false,"required":["file_size","speed"]},"output_schema":{"type":"object","properties":{"seconds":{"description":"file_size in bits / speed in bits per second. Unit: s.","type":"number","x-unit":"s"},"time_formatted":{"description":"Same time as h:mm:ss.","type":"string"},"minutes":{"description":"seconds / 60. Unit: min.","type":"number","x-unit":"min"},"hours":{"description":"seconds / 3600. Unit: h.","type":"number","x-unit":"h"},"speed_mb_per_s":{"description":"Connection speed expressed in megabytes per second. Unit: MB/s.","type":"number","x-unit":"MB/s"}}},"formula":"bits = file_size × bytes_per_unit × 8 (MB 10⁶, GB 10⁹, TB 10¹² bytes); bits_per_second = speed × (Mbit/s 10⁶, MB/s 8×10⁶, Gbit/s 10⁹); seconds = bits / bits_per_second","method":"Uses decimal prefixes as network operators and drive makers do. Operating systems often report sizes in binary units (1 GiB = 1.074 GB), and real throughput is typically 5–15% below the nominal line speed.","sources":[{"name":"Data-rate units (Wikipedia)","url":"https://en.wikipedia.org/wiki/Data-rate_units","type":"reference","retrieved_at":"2026-09-23"},{"name":"NIST – Prefixes for binary multiples","url":"https://physics.nist.gov/cuu/Units/binary.html","type":"standard","retrieved_at":"2026-09-23"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output."},"examples":[{"name":"4.7 GB at 100 Mbit/s","inputs":{"file_size":4.7,"size_unit":"gb","speed":100,"speed_unit":"mbit_per_s"},"expected":{"seconds":376,"time_formatted":"0:06:16","minutes":6.27,"hours":0.104,"speed_mb_per_s":12.5},"url":"https://tttkmbb.com/api/v1/calculate/download-time?file_size=4.7&size_unit=gb&speed=100&speed_unit=mbit_per_s"},{"name":"1 TB at 1 Gbit/s","inputs":{"file_size":1,"size_unit":"tb","speed":1,"speed_unit":"gbit_per_s"},"expected":{"seconds":8000,"time_formatted":"2:13:20","minutes":133.33,"hours":2.222,"speed_mb_per_s":125},"url":"https://tttkmbb.com/api/v1/calculate/download-time?file_size=1&size_unit=tb&speed=1&speed_unit=gbit_per_s"}],"faq":[{"q":"Why is my download slower than the calculator says?","a":"The estimate uses the nominal link speed; protocol overhead, the server's upload limit, Wi-Fi signal and other traffic usually cut throughput by 10% or more."},{"q":"Mbps or MB/s – which one do I have?","a":"Internet plans quote megabits per second (Mbps); download managers show megabytes per second (MB/s). 100 Mbps equals 12.5 MB/s."}],"tags":["download time","transfer time","how long to download","mbps to mb/s","upload time"],"related":[{"calculator_id":"data-storage","reason":"Convert between MB, GiB, TB and other data units."},{"calculator_id":"time","reason":"Convert seconds to minutes, hours and days."}],"links":{"html":"https://tttkmbb.com/everyday/download-time","markdown":"https://tttkmbb.com/everyday/download-time.md","json":"https://tttkmbb.com/everyday/download-time.json","api":"https://tttkmbb.com/api/v1/calculate/download-time","schema":"https://tttkmbb.com/api/v1/calculators/download-time","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-23"},"timestamp":"2026-09-23T23:31:37Z","next_actions":[{"tool":"run_calculator","calculator_id":"download-time","reason":"Run Download Time Calculator with the inputs above."}],"links":{"markdown":"https://tttkmbb.com/everyday/download-time.md"}}