[comment]: # (terms: forecast, timeleft )

[comment]: # ({2e2a1a06-1910d8fa})
# 8 פונקציות חיזוי

כל הפונקציות שמופיעות כאן נתמכות על ידי:

-   [ביטויי הקפצות](/manual/config/triggers/expression)
-   [פריטים מחושבים](/manual/config/items/itemtypes/calculated)

כמה הערות כלליות על משתני פונקציות:

-   משתני פונקציות מופרדות בפסיקים
-   משתני פונקציות כרשות (או חלקים מהמשתנים) מסומנים על ידי
    `<` `>`
-   משתנים ייעודיים לפונקציה מתוארים בפונקציות עצמן
-   משתני ‎`/host/key`‎ ו־‎`(sec|#num)<:time shift>`‎ אסור לתחום בסוגריים

[comment]: # ({/2e2a1a06-1910d8fa})

[comment]: # ({4d343eb8-4d343eb8})
##### פרמטרים נפוצים

- `/host/key` הוא פרמטר ראשון חובה נפוץ עבור הפונקציות
     הפניה להיסטוריית הפריט המארח
- `(sec|#num)<:time shift>` הוא פרמטר שני נפוץ עבור
     פונקציות המתייחסות להיסטוריית פריט המארח, כאשר:
     - **שניה** - מקסימום [הערכה
         period](/manual/config/triggers#evaluation_period) בשניות
         (ניתן להשתמש בזמן [סיומות](/ידנית/נספח/סיומות), או
     - **\#num** - מקסימום [הערכה
         range](/manual/config/triggers#evaluation_period) לאחרונה
         ערכים שנאספו (אם לפניהם סימן גיבוב)
     - **משמרת זמן** (אופציונלית) מאפשרת להזיז את נקודת ההערכה
         אחורה בזמן. ראה עוד
         details](/manual/config/triggers/expression#time_shift) פועל
         ציון משמרת זמן.

[comment]: # ({/4d343eb8-4d343eb8})

[comment]: # ({82cd0adc-e6aa7a7c})
#### פונקציות חיזוי

|FUNCTION|<|<|
|--|--|--|
|**תיאור**|**פרמטרים ספציפיים לפונקציה**|**הערות**|
|**תחזית** (/host/key,(sec\|\#num)<:time shift>,time,<fit>,<mode>)|<|<|
|ערך עתידי, מקסימום, min, דלתא או ממוצע של הפריט.|ראה [פרמטרים נפוצים](#common-parameters).<br><br>**זמן** - חיזוי אופק בשניות (ניתן להשתמש בסיומת זמן ); ערכים שליליים נתמכים<br><br>**התאמה** (אופציונלי; חייב להיות במירכאות כפולות) - פונקציה המשמשת להתאמה לנתונים היסטוריים<br><br>'התאמה' נתמכת:<br>*לינארית* - ליניארית פונקציה<br>*פולינוםN* - פולינום של תואר N (1 <= N <= 6)<br>*מעריכי* - פונקציה מעריכית<br>*לוגריתמית* - פונקציה לוגריתמית<br>*כוח* - פונקציית חזקה<br ><br>שים לב ש:<br>*ליניארי* הוא ברירת מחדל, *פולינום1* שווה ערך ל*ליניארי*<br><br>**מצב** (אופציונלי; חייב להיות במירכאות כפולות) - פלט מבוקש<br <br>מצבים נתמכים:<br>*ערך* - ערך (ברירת מחדל)<br>*מקסימום* - מקסימום<br>*דקה* - מינימום<br>*דלתא* - *מקסימום*-*דקה* <br>*avg* - ממוצע<br><br>שים לב ש:<br>*value* מעריך את ערך הפריט כרגע 'עכשיו' + 'זמן'<br>*max*, *min*, *delta* ו-*avg* בודקים אומדן ערך פריט על המרווח שבין 'עכשיו' ל-'עכשיו' + 'זמן'|סוגי ערכים נתמכים: float, int<br><br>אם הערך להחזרה גדול מ-1.7976931348623157E+308 או פחות מ-1.7976931348623157E+308, ערך ההחזרה נחתך ל-1.7976931348623157E+308 או -1.7976931348623157E+308 בהתאמה.<br><br>נעשה פריט בשימוש שגוי בסוג החזרה אינו נתמך רק בביטוי 1. במקרה של שגיאות.<br><br>דוגמאות:<br>=> **תחזית**(/host/key,**\#10**,**1h**) → ערך תחזית פריט בעוד שעה אחת מבוסס על 10 הערכים האחרונים<br>=> **תחזית**(/host/key,**1h**,**30m**) → ערך תחזית פריט בעוד 30 דקות בהתבסס על נתוני השעה האחרונה<br> => **תחזית**(/host/key,**1h:now-1d**,**12h**) → תחזית ערך פריט בעוד 12 שעות בהתבסס על שעה אחת לפני יום אחד<br>=> ** תחזית**(/host/key,**1h**,**10m**,"אקספוננציאלי") → ערך פריט תחזית בעוד 10 דקות מבוסס על נתוני השעה האחרונה ופונקציה מעריכית<br>=> **תחזית* *(/host/key,**1h**,**2h**,"polynomial3","max") ← חזה את הערך המקסימלי שאליו הפריט יכול להגיע בשעתיים הקרובות בהתבסס על נתוני השעה האחרונה וקוביקה (שלישית תואר) פולינום<br>=> **תחזית**(/host/key,**\#2**,**-20m**) ← אומדן ערך הפריט לפני 20 דקות בהתבסס על שני הערכים האחרונים (זה יכול להיות מדויק יותר משימוש ב-last(), במיוחד אם הפריט מתעדכן לעתים רחוקות, למשל, פעם בשעה)<br><br>ראה גם מידע נוסף על [פונקציות טריגר חזוי](/manual/config/triggers/prediction). |
|**timeleft** (/host/key,(sec\|\#num)<:time shift>,threshold,<fit>)|<|<|
|הזמן בשניות הדרוש לפריט כדי להגיע לסף שצוין.|ראה [פרמטרים נפוצים](#common-parameters).<br><br>**threshold** - ערך להגיע אליו ([סיומת יחידה](/manual /appendix/suffixes) ניתן להשתמש)<br><br>**fit** (אופציונלי; חייב להיות במירכאות כפולות) - ראה forecast()|סוגי ערכים נתמכים: float, int<br><br>If value כדי להחזיר גדול מ-1.7976931348623157E+308, ערך ההחזרה נחתך ל-1.7976931348623157E+308.<br><br>מחזירה 1.7976931348623157E><br>לא ניתן להגיע רק ל-threshold in<br>אי אפשר להגיע. ביטוי (סוג פריט שגוי, פרמטרים לא חוקיים), אחרת מחזירה -1 במקרה של שגיאות.<br><br>דוגמאות:<br>=> **timeleft**(/host/key,**\#10** ,**0**) → זמן עד שערך הפריט מגיע לאפס בהתבסס על 10 הערכים האחרונים<br>=> **זמן שנותר**(/host/key,**1h**,**100**) → זמן עד שערך הפריט יגיע ל-100 בהתבסס על נתוני השעה האחרונה<br>=> **timeleft**(/host/key,**1h:now-1d**,**100**) → זמן עד לפריט הערך מגיע ל-100 בהתבסס על שעה אחת לפני יום אחד<br>=> **זמן שנותר**(/host/key,**1h**,**200**,"polynomial2") → זמן עד שערך הפריט מגיע ל-200 מבוסס על נתוני השעה האחרונה והנחה שהפריט מתנהג כמו פולינום ריבועי (דרגה שנייה)<br>ראה גם מידע נוסף על [פונקציות טריגר חזוי](/manual/config/triggers/prediction).|

[comment]: # ({/82cd0adc-e6aa7a7c})