공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
ee.ImageCollection.filterDate
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
날짜 범위로 컬렉션을 필터링하는 바로가기입니다. 시작 및 종료는 날짜, 숫자 (1970-01-01T00:00:00Z 이후의 밀리초로 해석됨), 문자열 (예: '1996-01-01T08:00')일 수 있습니다. 'system:time_start'를 기반으로 합니다.
이는 this.filter(ee.Filter.date(...))와 동일합니다. 다른 날짜 필터링 옵션은 ee.Filter 유형을 참고하세요.
필터링된 컬렉션을 반환합니다.
| 사용 | 반환 값 |
|---|
ImageCollection.filterDate(start, end) | 컬렉션 |
| 인수 | 유형 | 세부정보 |
|---|
다음과 같은 경우: collection | 컬렉션 | 컬렉션 인스턴스입니다. |
start | 날짜|숫자|문자열 | 시작일 (해당 날짜 포함)입니다. |
end | 날짜|숫자|문자열(선택사항) | 종료일 (해당 날짜 제외)입니다. 선택사항입니다. 지정하지 않으면 'start'에서 시작하는 1밀리초 범위가 생성됩니다. |
예
코드 편집기 (JavaScript)
// A Landsat 8 TOA image collection intersecting a specific point.
var col = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA')
.filterBounds(ee.Geometry.Point(-90.70, 34.71));
// Filter the collection by date using date strings.
print('2020 images', col.filterDate('2020', '2021'));
print('July images, 2020', col.filterDate('2020-07', '2020-08'));
print('Early July images, 2020', col.filterDate('2020-07-01', '2020-07-10'));
print('Include time (13 hours, July 7, 2020)',
col.filterDate('2020-07-05T06:34:46', '2020-07-05T19:34:46'));
// Use milliseconds since Unix epoch.
print('Milliseconds inputs', col.filterDate(1593967014062, 1595349419611));
// Use ee.Date objects.
print('ee.Date inputs', col.filterDate(ee.Date('2020'), ee.Date('2021')));
// Use an ee.DateRange object.
var dateRange = ee.DateRange('2020-07-01', '2020-07-10');
print('ee.DateRange input', col.filterDate(dateRange));
Python 설정
Python API 및 geemap를 사용한 대화형 개발에 관한 자세한 내용은
Python 환경 페이지를 참고하세요.
import ee
import geemap.core as geemap
Colab (Python)
# A Landsat 8 TOA image collection intersecting a specific point.
col = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA').filterBounds(
ee.Geometry.Point(-90.70, 34.71))
# Filter the collection by date using date strings.
print('2020 images:', col.filterDate('2020', '2021').getInfo())
print('July images, 2020:', col.filterDate('2020-07', '2020-08').getInfo())
print('Early July images, 2020:',
col.filterDate('2020-07-01', '2020-07-10').getInfo())
print('Include time (13 hours, July 7, 2020):',
col.filterDate('2020-07-05T06:34:46', '2020-07-05T19:34:46').getInfo())
# Use milliseconds since Unix epoch.
print('Milliseconds inputs:',
col.filterDate(1593967014062, 1595349419611).getInfo())
# Use ee.Date objects.
print('ee.Date inputs',
col.filterDate(ee.Date('2020'), ee.Date('2021')).getInfo())
# Use an ee.DateRange object.
date_range = ee.DateRange('2020-07-01', '2020-07-10')
print('ee.DateRange input', col.filterDate(date_range).getInfo())
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003e\u003ccode\u003eImageCollection.filterDate()\u003c/code\u003e allows you to filter an image collection by a specific date range using start and end dates.\u003c/p\u003e\n"],["\u003cp\u003eStart and end dates can be specified as Dates, numbers (milliseconds since 1970-01-01T00:00:00Z), or date strings (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS).\u003c/p\u003e\n"],["\u003cp\u003eThe filter is based on the \u003ccode\u003esystem:time_start\u003c/code\u003e property of images within the collection.\u003c/p\u003e\n"],["\u003cp\u003eIf the end date is not provided, a 1-millisecond range starting at the start date is used for filtering.\u003c/p\u003e\n"],["\u003cp\u003eThis function is a shortcut to using \u003ccode\u003eee.Filter.date()\u003c/code\u003e and returns the filtered collection.\u003c/p\u003e\n"]]],["The `filterDate` method filters an ImageCollection by a date range, based on 'system:time_start'. It accepts start and optional end dates as Dates, numbers (milliseconds since 1970), or strings. If no end date is provided, a 1-millisecond range from the start is used. This function returns a filtered collection. Examples demonstrate usage with various input formats, including date strings, milliseconds, `ee.Date` objects, and `ee.DateRange` objects in both JavaScript and Python.\n"],null,["# ee.ImageCollection.filterDate\n\n\u003cbr /\u003e\n\nShortcut to filter a collection by a date range. The start and end may be Dates, numbers (interpreted as milliseconds since 1970-01-01T00:00:00Z), or strings (such as '1996-01-01T08:00'). Based on 'system:time_start'.\n\n\u003cbr /\u003e\n\nThis is equivalent to this.filter(ee.Filter.date(...)); see the ee.Filter type for other date filtering options.\n\nReturns the filtered collection.\n\n| Usage | Returns |\n|----------------------------------------------|------------|\n| ImageCollection.filterDate`(start, `*end*`)` | Collection |\n\n| Argument | Type | Details |\n|--------------------|--------------------------------|-------------------------------------------------------------------------------------------------------------|\n| this: `collection` | Collection | The Collection instance. |\n| `start` | Date\\|Number\\|String | The start date (inclusive). |\n| `end` | Date\\|Number\\|String, optional | The end date (exclusive). Optional. If not specified, a 1-millisecond range starting at 'start' is created. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A Landsat 8 TOA image collection intersecting a specific point.\nvar col = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA')\n .filterBounds(ee.Geometry.Point(-90.70, 34.71));\n\n// Filter the collection by date using date strings.\nprint('2020 images', col.filterDate('2020', '2021'));\nprint('July images, 2020', col.filterDate('2020-07', '2020-08'));\nprint('Early July images, 2020', col.filterDate('2020-07-01', '2020-07-10'));\nprint('Include time (13 hours, July 7, 2020)',\n col.filterDate('2020-07-05T06:34:46', '2020-07-05T19:34:46'));\n\n// Use milliseconds since Unix epoch.\nprint('Milliseconds inputs', col.filterDate(1593967014062, 1595349419611));\n\n// Use ee.Date objects.\nprint('ee.Date inputs', col.filterDate(ee.Date('2020'), ee.Date('2021')));\n\n// Use an ee.DateRange object.\nvar dateRange = ee.DateRange('2020-07-01', '2020-07-10');\nprint('ee.DateRange input', col.filterDate(dateRange));\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\n# A Landsat 8 TOA image collection intersecting a specific point.\ncol = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA').filterBounds(\n ee.Geometry.Point(-90.70, 34.71))\n\n# Filter the collection by date using date strings.\nprint('2020 images:', col.filterDate('2020', '2021').getInfo())\nprint('July images, 2020:', col.filterDate('2020-07', '2020-08').getInfo())\nprint('Early July images, 2020:',\n col.filterDate('2020-07-01', '2020-07-10').getInfo())\nprint('Include time (13 hours, July 7, 2020):',\n col.filterDate('2020-07-05T06:34:46', '2020-07-05T19:34:46').getInfo())\n\n# Use milliseconds since Unix epoch.\nprint('Milliseconds inputs:',\n col.filterDate(1593967014062, 1595349419611).getInfo())\n\n# Use ee.Date objects.\nprint('ee.Date inputs',\n col.filterDate(ee.Date('2020'), ee.Date('2021')).getInfo())\n\n# Use an ee.DateRange object.\ndate_range = ee.DateRange('2020-07-01', '2020-07-10')\nprint('ee.DateRange input', col.filterDate(date_range).getInfo())\n```"]]
