공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
ee.Date.getRange
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 날짜가 포함된 지정된 유형의 단위를 포함하는 DateRange를 반환합니다(예: Date('2013-3-15').getRange('year')는 DateRange('2013-1-1', '2014-1-1')을 반환합니다.
사용 | 반환 값 |
---|
Date.getRange(unit, timeZone) | DateRange |
인수 | 유형 | 세부정보 |
---|
this: date | 날짜 | |
unit | 문자열 | 'year', 'month', 'week', 'day', 'hour', 'minute', 'second' 중 하나입니다. |
timeZone | 문자열, 기본값: null | 시간대 (예: 'America/Los_Angeles'); 기본값은 UTC입니다. |
예
코드 편집기 (JavaScript)
var date = ee.Date('2021-4-30T07:15:31.24');
print('1-year date range covering input date', date.getRange('year'));
print('1-month date range covering input date', date.getRange('month'));
print('1-week date range covering input date', date.getRange('week'));
print('1-day date range covering input date', date.getRange('day'));
print('1-hour date range covering input date', date.getRange('hour'));
print('1-minute date range covering input date', date.getRange('minute'));
print('1-second date range covering input date', date.getRange('second'));
Python 설정
Python API 및 대화형 개발을 위한 geemap
사용에 관한 자세한 내용은
Python 환경 페이지를 참고하세요.
import ee
import geemap.core as geemap
Colab (Python)
date = ee.Date('2021-4-30T07:15:31.24')
display('1-year date range covering input date:', date.getRange('year'))
display('1-month date range covering input date:', date.getRange('month'))
display('1-week date range covering input date:', date.getRange('week'))
display('1-day date range covering input date:', date.getRange('day'))
display('1-hour date range covering input date:', date.getRange('hour'))
display('1-minute date range covering input date:', date.getRange('minute'))
display('1-second date range covering input date:', date.getRange('second'))
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003e\u003ccode\u003eDate.getRange()\u003c/code\u003e returns a \u003ccode\u003eDateRange\u003c/code\u003e object representing the specified time unit (year, month, week, day, hour, minute, or second) that contains the input date.\u003c/p\u003e\n"],["\u003cp\u003eThe returned \u003ccode\u003eDateRange\u003c/code\u003e spans the entire unit of time, for example, if the input date is March 15, 2013, and the unit is 'year', the returned \u003ccode\u003eDateRange\u003c/code\u003e will be from January 1, 2013, to January 1, 2014.\u003c/p\u003e\n"],["\u003cp\u003eYou can optionally specify a time zone for the \u003ccode\u003eDateRange\u003c/code\u003e; if not provided, it defaults to UTC.\u003c/p\u003e\n"],["\u003cp\u003eThis function is useful for creating time-based filters or selecting data within specific time intervals.\u003c/p\u003e\n"]]],[],null,["# ee.Date.getRange\n\nReturns a DateRange covering the unit of the specified type that contains this date, e.g., Date('2013-3-15').getRange('year') returns DateRange('2013-1-1', '2014-1-1').\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-------------------------------------|-----------|\n| Date.getRange`(unit, `*timeZone*`)` | DateRange |\n\n| Argument | Type | Details |\n|--------------|-----------------------|-----------------------------------------------------------------------|\n| this: `date` | Date | |\n| `unit` | String | One of 'year', 'month', 'week', 'day', 'hour', 'minute', or 'second'. |\n| `timeZone` | String, default: null | The time zone (e.g., 'America/Los_Angeles'); defaults to UTC. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nvar date = ee.Date('2021-4-30T07:15:31.24');\n\nprint('1-year date range covering input date', date.getRange('year'));\nprint('1-month date range covering input date', date.getRange('month'));\nprint('1-week date range covering input date', date.getRange('week'));\nprint('1-day date range covering input date', date.getRange('day'));\nprint('1-hour date range covering input date', date.getRange('hour'));\nprint('1-minute date range covering input date', date.getRange('minute'));\nprint('1-second date range covering input date', date.getRange('second'));\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 = ee.Date('2021-4-30T07:15:31.24')\n\ndisplay('1-year date range covering input date:', date.getRange('year'))\ndisplay('1-month date range covering input date:', date.getRange('month'))\ndisplay('1-week date range covering input date:', date.getRange('week'))\ndisplay('1-day date range covering input date:', date.getRange('day'))\ndisplay('1-hour date range covering input date:', date.getRange('hour'))\ndisplay('1-minute date range covering input date:', date.getRange('minute'))\ndisplay('1-second date range covering input date:', date.getRange('second'))\n```"]]