{ "category": "Date and time functions", "display_name": "MINUTE", "entry_kind": "built_in_function", "eval_api": { "method": "POST", "url": "https://handbook.dnacalc.com/api/eval" }, "function_id": "FUNC.MINUTE", "implementation_state": { "answer_bank": { "excel_builds": [ "20430" ], "larger_numeric": 0, "last_bit": 0, "matched": 14631, "other_mismatch": 0, "refused": 0, "rows": 14631, "unread": 0, "worst_ulp": 0 }, "detail": "Recorded: 14,631 in the answer bank and 4 workbook cells.", "dnacalc_commit": "9e1884369a678158dd82d3d74188daf986995e87", "in_catalogue": true, "state": "matches", "state_label": "Matches every recorded Excel answer", "summary": "Matches all 14,635 recorded answers", "workbook_corpus": { "cells": 4, "matched": 4 } }, "implementations": [ { "commit": "9e1884369a678158dd82d3d74188daf986995e87", "flavour": "excel-compatibility-candidate", "language": "Rust", "name": "CalcFunc", "own_code": [ "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/dates.rs#L248-L250" ], "repository": "https://github.com/DnaCalc/DnaCalc", "shared_code": [ "catalogue/dates::environment", "catalogue/dates::system", "catalogue/dates::to_1900", "catalogue/dates::date_arg", "catalogue/dates::of_date", "ported/date_kernels::hms" ], "source": "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/dates.rs#L248-L250", "state": "matches", "suite": null, "summary": "Matches all 14,635 recorded answers" } ], "json_url": "https://handbook.dnacalc.com/api/functions/FUNC.MINUTE.json", "name": "MINUTE", "notes": [], "schema": "efh.function-reference/v1", "section_order": [ "what-it-does", "try-it", "quirks", "how-to-implement", "version-differences", "alternatives" ], "sections": { "alternatives": "\nUse [TIME](FUNC.TIME.md) to construct a clock value and [TIMEVALUE](FUNC.TIMEVALUE.md) to parse\ntext. For elapsed time, multiplying a duration by 24, 1440 or 86400 retains the full interval.\n[TEXT](FUNC.TEXT.md) or a cell format controls presentation without extracting a numeric component.\n\n\n", "how-to-implement": "\nSeparate argument coercion and range checks from the clock calculation. Preserve the numeric\nserial as binary64. OneCalc's compatibility candidate first adds `0.5/86400` to the serial,\nthen takes its fractional day. It multiplies by 24, takes the integer hour, multiplies the\nremaining fraction by 60, takes the integer minute, and multiplies the next remainder by 60 to\nobtain the integer second, reduced modulo 60.\n\nThat operation order matters near a boundary. Computing a single rounded total-second integer\nand splitting it is a sensible mathematical design, but is not established as interchangeable\nwith this sequence. Test a value and its adjacent binary64 neighbours around each second, minute,\nhour and midnight transition. Do not let date formatting decide the numeric result.\n\n\n", "quirks": "\nA day has 24 hours and each hour and minute has 60 subdivisions. The component wraps; for total\nelapsed hours, minutes or seconds, use arithmetic on the duration rather than this extractor.\n\nOn Excel 16.0.20527.20088 for Windows, `MINUTE(0.5+1/86400/2)` returns 0. The half-second input does not itself specify a tie-breaking policy for every boundary.\n\nThe documentation describes the returned component, but does not specify every binary64 boundary\nor intermediate rounding. A simple floor of a scaled fractional day is therefore an incomplete\ncompatibility specification. Invalid date/time input and negative serial handling also need the\ntarget workbook's date-system rules.\n\n\n", "sources": "\n- [Microsoft: MINUTE function](https://support.microsoft.com/en-us/excel/functions/minute-function).\n\n", "try-it": "\nStart with `=MINUTE(TIME(12,34,56))`. Compare `=HOUR(TIME(12,34,56))`, `=MINUTE(TIME(12,34,56))` and\n`=SECOND(TIME(12,34,56))` to see the three components of the same time.\n\n\n", "version-differences": "The recorded environments below distinguish a reading from a same-input comparison. Counts describe captured inputs in each environment; overlapping captures and comparisons are not totals of unique worksheet calls.\n\n| Excel 16.0 build | Platform and CPU | Captured inputs |\n|---|---|---:|\n| 20430 | Windows, 64-bit, CPU not recorded | 14,631 |\n\nThe record contains no same-input comparison between these environments. Reading different inputs on different builds does not establish either a version change or cross-build agreement.\n\n[Recorded environments and comparison details](https://github.com/DnaCalc/ExcelFunctionsHandbook/blob/5dc75391aa5125ccc5abdb095da85950980d6fd8/content/evidence/environments/FUNC.MINUTE.json).", "what-it-does": "\n`MINUTE(serial_number)` returns the minute within the hour, as an integer from 0 through 59.\nExcel represents a day by one unit, so 0.5 is noon. A full date-time serial can be supplied;\nthis function extracts a clock component rather than an elapsed duration.\n\nThe argument may be a serial number, a time produced by another formula, or time text that the\nlocale can parse. Text parsing and component extraction are separate operations.\n\n\n" }, "signature": { "display": "MINUTE(serial_number)", "parameters": [ { "description": null, "name": "serial_number", "optional": false, "repeats": false } ], "trailing_repeats": false }, "sources": { "metadata": { "admission": { "label": "implemented", "reason": null }, "arity": { "max": 1, "min": 1 }, "category": "Date and time functions", "classification": { "arg_preparation_profile": "ValuesOnlyPreAdapter", "coercion_lift_profile": "Custom", "determinism_class": "Deterministic", "error_collapse_profile": "None", "fec_dependency_profile": "None", "host_interaction_class": "None", "kernel_signature_class": "Custom", "rich_value_usage": "RichBlind", "surface_fec_dependency_profile": "RefOnly", "thread_safety_class": "SafePure", "volatility_class": "NonVolatile" }, "descriptions": { "long": null, "short": "Minute (0 to 59) of a time", "short_source": "dna-calc-own" }, "docs": { "english_description": "Converts a serial number to a minute", "microsoft_url": "https://support.microsoft.com/en-us/office/minute-function-af728df0-05c4-4b07-9eed-a84801a60589" }, "entry_kind": "built_in_function", "localized_family_names": null, "localized_names": [ { "locale": "ar-SA", "name": "MINUTE" }, { "locale": "bg-BG", "name": "MINUTE" }, { "locale": "cs-CZ", "name": "MINUTA" }, { "locale": "da-DK", "name": "MINUTE" }, { "locale": "de-DE", "name": "MINUTE" }, { "locale": "el-GR", "name": "MINUTE" }, { "locale": "en-AU", "name": "MINUTE" }, { "locale": "en-GB", "name": "MINUTE" }, { "locale": "en-US", "name": "MINUTE" }, { "locale": "es-ES", "name": "MINUTE" }, { "locale": "et-EE", "name": "MINUT" }, { "locale": "fi-FI", "name": "MINUUTTI" }, { "locale": "fr-FR", "name": "MINUTE" }, { "locale": "he-IL", "name": "MINUTE" }, { "locale": "hr-HR", "name": "MINUTE" }, { "locale": "hu-HU", "name": "MINUTE" }, { "locale": "id-ID", "name": "MINUTE" }, { "locale": "it-IT", "name": "MINUTE" }, { "locale": "ja-JP", "name": "MINUTE" }, { "locale": "ko-KR", "name": "MINUTE" }, { "locale": "lt-LT", "name": "MINUTE" }, { "locale": "lv-LV", "name": "MINUTE" }, { "locale": "nb-NO", "name": "MINUTT" }, { "locale": "nl-NL", "name": "MINUTE" }, { "locale": "pl-PL", "name": "MINUTE (minuta)" }, { "locale": "pt-BR", "name": "MINUTE" }, { "locale": "pt-PT", "name": "MINUTO" }, { "locale": "ro-RO", "name": "MINUTE" }, { "locale": "ru-RU", "name": "MINUTE" }, { "locale": "sk-SK", "name": "MINÚTA" }, { "locale": "sl-SI", "name": "MINUTA" }, { "locale": "sr-Latn-RS", "name": "MINUT" }, { "locale": "sv-SE", "name": "MINUTE" }, { "locale": "th-TH", "name": "นาที" }, { "locale": "tr-TR", "name": "DAKİKA" }, { "locale": "uk-UA", "name": "ХВИЛИНА" }, { "locale": "vi-VN", "name": "MINUTE" }, { "locale": "zh-CN", "name": "MINUTE" }, { "locale": "zh-HK", "name": "MINUTE" }, { "locale": "zh-TW", "name": "MINUTE" } ], "signature": { "display": "MINUTE(serial_number)", "parameters": [ { "description": null, "name": "serial_number", "optional": false, "repeats": false } ], "trailing_repeats": false }, "surface_name": "MINUTE", "version_marker": null, "xlcall": { "code": "72", "symbol": "xlfMinute" } }, "microsoft": "https://support.microsoft.com/en-us/office/minute-function-af728df0-05c4-4b07-9eed-a84801a60589" }, "try_it": { "formula": "=MINUTE(TIME(12,34,56))" }, "url": "https://handbook.dnacalc.com/functions/MINUTE.html", "variants": [], "versions": [ { "behaviour": "The formulas below were read directly from Excel in the named capture. These rows do not establish behaviour on other builds or on unmeasured inputs.", "capture": { "environment": { "channel": "current", "compatibility": "compat-1/calc-191029", "excel_build": "16.0.20527.20088", "numeric_environment": "excel-x86-64/cpu-x86-64", "settings": { "add_ins": "COM add-in Carousel.ExcelAddin connect=false;COM add-in Dna_78b015d8b23f56a68ecce694f11f8794_3 connect=false;COM add-in ExcelPlugInShell.PowerMapConnect connect=false;COM add-in ExcelVstoAddIn1 connect=false;COM add-in MicrosoftDataStreamerforExcel connect=false;COM add-in NativeShim.InquireConnector.1 connect=false;COM add-in OxVbaExcelAddin.ExcelAddin connect=false;COM add-in PDFMaker.OfficeAddin connect=false;COM add-in PowerPivotExcelClientAddIn.NativeEntry.1 connect=false;COM add-in TestComAddIn.ComAddIn connect=false;COM add-in TestRibbonRegistration.MyCustomRibbon connect=false;COM add-in VS15ExcelAdaptor connect=true;COM add-in xlPerf connect=false;add-in ANALYS32.XLL open=false installed=false;add-in ATPVBAEN.XLAM open=false installed=false;add-in CsTest160PR-AddIn64-packed.xll open=false installed=false;add-in EUROTOOL.XLAM open=false installed=false;add-in ExcelDna.IntelliSense.Tools-AddIn64.xll open=false installed=false;add-in ExcelDna.IntelliSense64.xll open=false installed=false;add-in ExcelDna64.xll open=false installed=false;add-in GENERIC.xll open=false installed=false;add-in McpExcel-AddIn64.xll open=false installed=true;add-in RibbonTest-AddIn64.xll open=false installed=false;add-in SOLVER.XLAM open=false installed=false;add-in Test160rc1Local-AddIn64.xll open=false installed=false;add-in TestCrashGuard-AddIn64.xll open=false installed=true;add-in TestCs170rc2-AddIn64.xll open=false installed=false;add-in TestDoc170-AddIn64.xll open=false installed=false;add-in TestIntelliEmbed-AddIn64.xll open=false installed=false;add-in TestOpen16-AddIn64-packed.xll open=false installed=false", "add_ins_installed": "McpExcel-AddIn64.xll;TestCrashGuard-AddIn64.xll", "ask_to_update_links": "false", "automation_security": "3", "calculation": "automatic", "calculation_clock": "40e69eae3dec29c9", "calculation_state": "done", "calculation_version": "191029", "channel_source": "http://officecdn.microsoft.com/pr/492350f6-3a01-4f97-b9c0-c7c6ddf67d60", "com_add_ins_connected": "VS15ExcelAdaptor|Visual Studio Tools for Office Design-Time Adaptor for Excel", "connections": "", "country_code": "1", "country_setting": "27", "cpu": "AMD Ryzen 7 4800H with Radeon Graphics ", "cpu_architecture": "AMD64", "date1904": "false", "date_order": "2", "date_separator": "/", "decimal_separator": ".", "display_alerts": "false", "enable_events": "false", "excel_build_number": "20527", "excel_machine": "x86-64", "excel_version": "16.0", "external_links": "", "has_vb_project": "false", "ignore_remote_requests": "false", "install_language_id": "7177", "interactive": "false", "iteration": "false", "list_separator": ",", "max_change": "3f50624dd2f1a9fc", "max_iterations": "100", "ole_dde_links": "", "opened_read_only": "true", "operating_system": "Windows (64-bit) NT 10.00", "os_version": "Microsoft Windows NT 10.0.26200.0", "precision_as_displayed": "false", "processor_count": "16", "thousands_separator": " ", "ui_language_id": "1033", "use_system_separators": "true", "user_culture": "en-ZA", "workbook_calculation_version": "191029", "workbook_compatibility_version": "1", "workbook_path": "C:\\Work\\DnaCalc\\corpus\\c96\\in\\oracle.xlsx" } }, "path": "crates/calc-func/tests/captures/catalogue/sections/f2_rows.capture.json", "repository_revision": "96fc6795f714b4530bdaa0a5276fe08059937869", "session": { "context": "excel-calc-context/1;date1904=false;iteration=false;max_iterations=100;max_change=3f50624dd2f1a9fc;precision_as_displayed=false", "failures": [], "operations": [], "packages": { "input": "sha256:b2fe0e4012c6f4cb05e52b6d7e8544d04b0105f60b7c3dfb561726d5b0717ec3", "output": "sha256:dc2a1fb4137180e3888ea561de6ea114368fe0a1442aacbf1a5f8280f67e6daa" }, "revision": 0, "tool": "calc-oracle-excel 0.1.0; worker sha256:599032d018da3b9889269e0ca46c2c1c7f2f21572fb378bc1781a73b9cd93d25; repository d4eb5358571cdf0cae51fe8560cf082a16219d9a+dirty" }, "sha256": "ff282f486483e0821221f9204eab6cc2ccd5ef96e16e05304f981e88e45bb371" }, "excel_build": "16.0.20527.20088", "observations": [ { "call": "=MINUTE(0.5+1/86400/2)", "excel": { "bits": "0x0000000000000000", "display": "0", "kind": "number" }, "input_route": "formula-literal", "inputs": [], "recorded_in": "Excel 16.0.20527.20088, Windows (64-bit) NT 10.00, AMD Ryzen 7 4800H with Radeon Graphics, en-ZA; workbook compatibility 1", "source_locator": { "column": 4, "row": 116, "sheet": "f2_rows" } } ], "platform": "Windows (64-bit) NT 10.00, AMD Ryzen 7 4800H with Radeon Graphics, en-ZA", "sources": [ "https://github.com/DnaCalc/DnaCalc/blob/96fc6795f714b4530bdaa0a5276fe08059937869/crates/calc-func/tests/captures/catalogue/sections/f2_rows.capture.json" ] }, { "behaviour": "The formulas below were read directly from Excel in the named capture. These rows do not establish behaviour on other builds or on unmeasured inputs.", "capture": { "environment": { "channel": "current", "compatibility": "compat-1/calc-191029", "excel_build": "16.0.20527.20088", "numeric_environment": "excel-x86-64/cpu-x86-64", "settings": { "add_ins": "COM add-in Carousel.ExcelAddin connect=false;COM add-in Dna_78b015d8b23f56a68ecce694f11f8794_3 connect=false;COM add-in ExcelPlugInShell.PowerMapConnect connect=false;COM add-in ExcelVstoAddIn1 connect=false;COM add-in MicrosoftDataStreamerforExcel connect=false;COM add-in MsoTDAddin.Connect.1 connect=false;COM add-in NativeShim.InquireConnector.1 connect=false;COM add-in OxVbaExcelAddin.ExcelAddin connect=false;COM add-in PDFMaker.OfficeAddin connect=false;COM add-in PowerPivotExcelClientAddIn.NativeEntry.1 connect=false;COM add-in TestComAddIn.ComAddIn connect=false;COM add-in TestRibbonRegistration.MyCustomRibbon connect=false;COM add-in VS15ExcelAdaptor connect=true;COM add-in xlPerf connect=false;add-in ANALYS32.XLL open=false installed=false;add-in ATPVBAEN.XLAM open=false installed=false;add-in CsTest160PR-AddIn64-packed.xll open=false installed=false;add-in CsTest160PR-AddIn64-packed.xll open=false installed=false;add-in EUROTOOL.XLAM open=false installed=false;add-in ExcelDna.IntelliSense.Tools-AddIn64.xll open=false installed=false;add-in ExcelDna.IntelliSense64.xll open=false installed=false;add-in GENERIC.xll open=false installed=false;add-in McpExcel-AddIn64.xll open=false installed=true;add-in TestIntelliEmbed-AddIn64.xll open=false installed=false;add-in ExcelDna64.xll open=false installed=false;add-in RibbonTest-AddIn64.xll open=false installed=false;add-in SOLVER.XLAM open=false installed=false;add-in Test160rc1Local-AddIn64.xll open=false installed=false;add-in TestCrashGuard-AddIn64.xll open=false installed=true;add-in TestCs170rc2-AddIn64.xll open=false installed=false;add-in TestDoc170-AddIn64.xll open=false installed=false;add-in TestOpen16-AddIn64-packed.xll open=false installed=false", "add_ins_installed": "McpExcel-AddIn64.xll;TestCrashGuard-AddIn64.xll", "ask_to_update_links": "false", "automation_security": "3", "calculation": "automatic", "calculation_clock": "40e69f3576e7e4f0", "calculation_state": "done", "calculation_version": "191029", "channel_source": "http://officecdn.microsoft.com/pr/492350f6-3a01-4f97-b9c0-c7c6ddf67d60", "com_add_ins_connected": "VS15ExcelAdaptor|Visual Studio Tools for Office Design-Time Adaptor for Excel", "connections": "", "country_code": "1", "country_setting": "27", "cpu": "AMD Ryzen 7 4800H with Radeon Graphics ", "cpu_architecture": "AMD64", "date1904": "false", "date_order": "2", "date_separator": "/", "decimal_separator": ".", "display_alerts": "false", "enable_events": "false", "excel_build_number": "20527", "excel_machine": "x86-64", "excel_version": "16.0", "external_links": "", "has_vb_project": "false", "ignore_remote_requests": "false", "install_language_id": "7177", "interactive": "false", "iteration": "false", "list_separator": ",", "max_change": "3f50624dd2f1a9fc", "max_iterations": "100", "ole_dde_links": "", "opened_read_only": "true", "operating_system": "Windows (64-bit) NT 10.00", "os_version": "Microsoft Windows NT 10.0.26200.0", "precision_as_displayed": "false", "processor_count": "16", "thousands_separator": " ", "ui_language_id": "1033", "use_system_separators": "true", "user_culture": "en-ZA", "workbook_calculation_version": "191029", "workbook_compatibility_version": "1", "workbook_path": "C:\\Work\\DnaCalc\\DnaCalc-win\\target\\c\\20261103140553-2\\in\\oracle.xlsx" } }, "path": "crates/calc-func/tests/captures/catalogue/sections/prefix_metadata.capture.json", "repository_revision": "96fc6795f714b4530bdaa0a5276fe08059937869", "session": { "context": "excel-calc-context/1;date1904=false;iteration=false;max_iterations=100;max_change=3f50624dd2f1a9fc;precision_as_displayed=false", "failures": [], "operations": [], "packages": { "input": "sha256:2839ad05d9e4d79e442cd2f90b8482aeef01da61cd2c3df5d82cd0143cec94b1", "output": "sha256:25d6375bb2d782db496d854e3db6744b6e201edb8c514adebc3af822a53f6e72" }, "revision": 0, "tool": "calc-oracle-excel 0.1.0; worker results 1; worker sha256:b8c1c482f73b050effc0a22e2a70b34e13ae71ea8a073e5e209d7e6dc0666439; repository 5050897870296b3b3a8dc45d8c8ded97c4c764d6+dirty" }, "sha256": "006596fd685a89215ef4bd4f9e64e6a8da5e314e6711305be51a0ff8a0700b18" }, "excel_build": "16.0.20527.20088", "observations": [ { "call": "=MINUTE(0.51)", "excel": { "bits": "0x402c000000000000", "display": "14", "kind": "number" }, "input_route": "formula-literal", "inputs": [], "recorded_in": "Excel 16.0.20527.20088, Windows (64-bit) NT 10.00, AMD Ryzen 7 4800H with Radeon Graphics, en-ZA; workbook compatibility 1", "source_locator": { "column": 1, "row": 299, "sheet": "prefix_metadata" } }, { "call": "=MINUTE(0.51)", "excel": { "bits": "0x402c000000000000", "display": "14", "kind": "number" }, "input_route": "formula-literal", "inputs": [], "recorded_in": "Excel 16.0.20527.20088, Windows (64-bit) NT 10.00, AMD Ryzen 7 4800H with Radeon Graphics, en-ZA; workbook compatibility 1", "source_locator": { "column": 2, "row": 299, "sheet": "prefix_metadata" } } ], "platform": "Windows (64-bit) NT 10.00, AMD Ryzen 7 4800H with Radeon Graphics, en-ZA", "sources": [ "https://github.com/DnaCalc/DnaCalc/blob/96fc6795f714b4530bdaa0a5276fe08059937869/crates/calc-func/tests/captures/catalogue/sections/prefix_metadata.capture.json" ] }, { "behaviour": "14,631 captured inputs are indexed for this environment. Capture dates: 2026-09-29 to 2026-09-29. This is a reading count, not a comparison with another build.", "excel_build": "16.0 build 20430", "platform": "Windows, 64-bit, CPU not recorded", "sources": [ "https://github.com/DnaCalc/ExcelFunctionsHandbook/blob/5dc75391aa5125ccc5abdb095da85950980d6fd8/content/evidence/environments/FUNC.MINUTE.json" ] } ] }