{
  "category": "External data functions",
  "display_name": "IMPORTCSV",
  "entry_kind": "built_in_function",
  "eval_api": {
    "method": "POST",
    "url": "https://handbook.dnacalc.com/api/eval"
  },
  "function_id": "FUNC.IMPORTCSV",
  "implementation_state": {
    "answer_bank": null,
    "detail": "The answer is a file the host reads. Microsoft's page lists it for Insiders on Windows; DNA Calc does not know the name yet.",
    "dnacalc_commit": "9e1884369a678158dd82d3d74188daf986995e87",
    "in_catalogue": false,
    "state": "host",
    "state_label": "Needs a host",
    "summary": "Needs a host that can read files",
    "workbook_corpus": null
  },
  "implementations": [],
  "json_url": "https://handbook.dnacalc.com/api/functions/FUNC.IMPORTCSV.json",
  "name": "IMPORTCSV",
  "notes": [],
  "schema": "efh.function-reference/v1",
  "section_order": [
    "what-it-does",
    "try-it",
    "quirks",
    "how-to-implement",
    "version-differences",
    "alternatives"
  ],
  "sections": {
    "alternatives": "\n- `IMPORTTEXT` for other delimiters, fixed-width files and encodings.\n- Power Query, for transformations and repeatable loads.\n\n\n",
    "how-to-implement": "\nDNA Calc does not know this name yet. An implementation needs file and URL access from the host, a parser with the\npage's delimiter, encoding and locale rules, an array result, and a refresh step separate from recalculation. Web sources\nalso need the host's sign-in handling.\n\n\n",
    "quirks": "\nIt does not update by itself: use Refresh All on the Data tab. The default locale belongs to the machine. Microsoft's page does not list errors, and none are recorded here.\n\n\n",
    "sources": "\n- [IMPORTCSV function](https://support.microsoft.com/en-us/excel/functions/importcsv-function)\n- [IMPORTTEXT function](https://support.microsoft.com/en-us/excel/functions/importtext-function)\n\n",
    "version-differences": "\nMicrosoft's page lists it for Microsoft 365 Insiders in the Beta channel on Windows, version 2502 (build 18604.20002) or\nlater. No Excel answers for this function are recorded here, so no comparison between Excel builds exists.\n\n\n",
    "what-it-does": "\n`IMPORTCSV` loads a CSV file into a dynamic array with one formula. It is a shorter form of `IMPORTTEXT` for this one format.\n\n`IMPORTCSV(path, [skip_rows], [take_rows], [locale])`\n\n`path` and the optional arguments mean what they mean in [IMPORTTEXT](FUNC.IMPORTTEXT.md).\n\n\n"
  },
  "signature": {
    "display": "IMPORTCSV(path, [skip_rows], [take_rows], [locale])",
    "parameters": [
      {
        "description": null,
        "name": "path",
        "optional": false,
        "repeats": false
      },
      {
        "description": null,
        "name": "skip_rows",
        "optional": true,
        "repeats": false
      },
      {
        "description": null,
        "name": "take_rows",
        "optional": true,
        "repeats": false
      },
      {
        "description": null,
        "name": "locale",
        "optional": true,
        "repeats": false
      }
    ],
    "trailing_repeats": false
  },
  "sources": {
    "metadata": {
      "admission": {
        "label": "host",
        "reason": "The answer is a file the host reads. Microsoft's page lists it for Insiders on Windows; DNA Calc does not know the name yet."
      },
      "arity": {
        "max": 4,
        "min": 1
      },
      "category": "External data functions",
      "classification": {},
      "descriptions": {
        "long": null,
        "short": "Loads a CSV file into a refreshable array",
        "short_source": "dna-calc-own"
      },
      "docs": {
        "english_description": null,
        "microsoft_url": "https://support.microsoft.com/en-us/excel/functions/importcsv-function"
      },
      "entry_kind": "built_in_function",
      "localized_family_names": null,
      "localized_names": [],
      "signature": {
        "display": "IMPORTCSV(path, [skip_rows], [take_rows], [locale])",
        "parameters": [
          {
            "description": null,
            "name": "path",
            "optional": false,
            "repeats": false
          },
          {
            "description": null,
            "name": "skip_rows",
            "optional": true,
            "repeats": false
          },
          {
            "description": null,
            "name": "take_rows",
            "optional": true,
            "repeats": false
          },
          {
            "description": null,
            "name": "locale",
            "optional": true,
            "repeats": false
          }
        ],
        "trailing_repeats": false
      },
      "surface_name": "IMPORTCSV",
      "version_marker": null,
      "xlcall": null
    },
    "microsoft": "https://support.microsoft.com/en-us/excel/functions/importcsv-function"
  },
  "try_it": {
    "formula": "=IMPORTCSV(\"data.csv\")",
    "note": "The OneCalc preview has no answer for this function: see the state above.",
    "preview_status": "worksheet-error"
  },
  "url": "https://handbook.dnacalc.com/functions/IMPORTCSV.html",
  "variants": [],
  "versions": []
}