ee.Date.getRange
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הפונקציה מחזירה טווח תאריכים שכולל את היחידה מהסוג שצוין שמכילה את התאריך הזה, למשל: פונקציית Date('2013-3-15').getRange('year') מחזירה את DateRange('2013-1-1', '2014-1-1').
שימוש | החזרות |
---|
Date.getRange(unit, timeZone) | DateRange |
ארגומנט | סוג | פרטים |
---|
זה: date | תאריך | |
unit | מחרוזת | אחת מהאפשרויות הבאות: 'שנה', 'חודש', 'שבוע', 'יום', 'שעה', 'דקה' או 'שנייה'. |
timeZone | מחרוזת, ברירת המחדל: null | אזור הזמן (למשל, 'America/Los_Angeles'); ברירת המחדל היא UTC. |
דוגמאות
Code Editor (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 מפורט מידע על Python API ועל השימוש ב-geemap
לפיתוח אינטראקטיבי.
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. Java הוא סימן מסחרי רשום של חברת 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```"]]