Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain Earth Engine access.
[[["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\u003eDate.difference()\u003c/code\u003e calculates the difference between two dates, returning a floating-point number.\u003c/p\u003e\n"],["\u003cp\u003eThe difference is calculated based on the average length of the specified unit (e.g., 'year', 'month', 'week', 'day', 'hour', 'minute', or 'second').\u003c/p\u003e\n"],["\u003cp\u003eThe function takes two \u003ccode\u003eee.Date\u003c/code\u003e objects as input, representing the start and end points for the calculation.\u003c/p\u003e\n"],["\u003cp\u003eThe result is relative to the first date and can be positive or negative depending on the order of the dates.\u003c/p\u003e\n"]]],["`Date.difference` calculates the difference between two dates, returning a floating-point number based on the average length of the specified unit. The function takes a `start` date and a `unit` string ('year', 'month', 'week', 'day', 'hour', 'minute', or 'second') as arguments. The output represents the difference in the chosen unit. Examples show calculating differences in days and weeks between two dates, showcasing both JavaScript and Python implementations.\n"],null,["# ee.Date.difference\n\nReturns the difference between two Dates in the specified units; the result is floating-point and based on the average length of the unit.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|--------------------------------|---------|\n| Date.difference`(start, unit)` | Float |\n\n| Argument | Type | Details |\n|--------------|--------|-----------------------------------------------------------------------|\n| this: `date` | Date | |\n| `start` | Date | |\n| `unit` | String | One of 'year', 'month', 'week', 'day', 'hour', 'minute', or 'second'. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Demonstrates the ee.Date.difference method.\n\nvar DATE_1 = ee.Date('2020-01-01');\nvar DATE_2 = ee.Date('2020-01-15');\n\nvar diff_1 = DATE_2.difference(DATE_1, 'days');\nvar diff_2 = DATE_1.difference(DATE_2, 'weeks');\n\nprint('The difference between ',\n DATE_2,\n ' relative to ',\n DATE_1,\n ' is ',\n diff_1,\n ' days.');\n\nprint('The difference between ',\n DATE_1,\n ' relative to ',\n DATE_2,\n ' is ',\n diff_2,\n ' weeks.');\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\n### Colab (Python)\n\n```python\nDATE_1 = ee.Date('2020-01-01')\nDATE_2 = ee.Date('2020-01-15')\n\n# Format the dates as strings.\nt1 = DATE_1.format('YYYY-MM-DD').getInfo()\nt2 = DATE_2.format('YYYY-MM-DD').getInfo()\n\n# Calculate the differences between dates.\ndiff_1 = DATE_2.difference(DATE_1, 'days').getInfo()\ndiff_2 = DATE_1.difference(DATE_2, 'weeks').getInfo()\n\nprint(f'The difference between {t2} relative to {t1} is {diff_1} days.')\nprint(f'The difference between {t1} relative to {t2} is {diff_2} weeks.')\n```"]]