Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain Earth Engine access.
Stay organized with collections
Save and categorize content based on your preferences.
Returns the ratio of the length of one unit to the length of another, e.g., unitRatio('day', 'minute') returns 1440. Valid units are 'year', 'month', 'week', 'day', 'hour', 'minute', and 'second'.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-23 UTC."],[[["\u003cp\u003e\u003ccode\u003eee.Date.unitRatio()\u003c/code\u003e calculates the length ratio between two time units, such as days and minutes.\u003c/p\u003e\n"],["\u003cp\u003eValid time units for this function include 'year', 'month', 'week', 'day', 'hour', 'minute', and 'second'.\u003c/p\u003e\n"],["\u003cp\u003eThe function takes two string arguments: the numerator unit and the denominator unit, and returns a float representing the ratio.\u003c/p\u003e\n"],["\u003cp\u003eExample: \u003ccode\u003eee.Date.unitRatio('day', 'minute')\u003c/code\u003e would return 1440, indicating there are 1440 minutes in a day.\u003c/p\u003e\n"]]],["The `unitRatio` function calculates the ratio between two time units. It accepts two string arguments: `numerator` and `denominator`, representing the desired units. Valid time units include 'year', 'month', 'week', 'day', 'hour', 'minute', and 'second'. The function returns a float value representing the ratio of the numerator to the denominator (e.g., how many minutes are in a day). Examples are provided in JavaScript and Python demonstrating various unit conversions.\n"],null,["Returns the ratio of the length of one unit to the length of another, e.g., unitRatio('day', 'minute') returns 1440. Valid units are 'year', 'month', 'week', 'day', 'hour', 'minute', and 'second'.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------------------------|---------|\n| `ee.Date.unitRatio(numerator, denominator)` | Float |\n\n| Argument | Type | Details |\n|---------------|--------|---------|\n| `numerator` | String | |\n| `denominator` | String | |\n\nExamples\n\nCode Editor (JavaScript) \n\n```javascript\nprint('Minutes in a day', ee.Date.unitRatio('day', 'minute'));\nprint('Seconds in a year', ee.Date.unitRatio('year', 'second'));\nprint('Years in a month', ee.Date.unitRatio('month', 'year'));\nprint('Hours in a week', ee.Date.unitRatio('week', 'hour'));\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\nColab (Python) \n\n```python\ndisplay('Minutes in a day:', ee.Date.unitRatio('day', 'minute'))\ndisplay('Seconds in a year:', ee.Date.unitRatio('year', 'second'))\ndisplay('Years in a month:', ee.Date.unitRatio('month', 'year'))\ndisplay('Hours in a week:', ee.Date.unitRatio('week', 'hour'))\n```"]]