רשימת הפונקציות

ב-Data Studio יש כמה פונקציות יעילות שאפשר להשתמש בהן בנוסחאות של שדות מחושבים.

שם סוג תיאור תחביר
ABS חשבון מחזירה את הערך המוחלט של מספר. מידע נוסף ABS(X)
ACOS חשבון מחזירה את הקוסינוס ההפוך של X. מידע נוסף ACOS(X)
APPROX_COUNT_DISTINCT צבירה הפונקציה מחזירה את המספר המשוער של הערכים הייחודיים של X. מידע נוסף APPROX_COUNT_DISTINCT(X)
ASIN חשבון הפונקציה מחזירה את הערך ההפוך של הסינוס של X. מידע נוסף ASIN(X)
ATAN חשבון הפונקציה מחזירה את הערך ההפוך של הטנגנס של X. מידע נוסף ATAN(X)
AVG צבירה מחזירה את הממוצע של כל הערכים של X. מידע נוסף AVG(X)
CASE (Simple) מותנה הפונקציה משווה בין input_expression לבין expression_to_match של כל סעיף WHEN עוקב, ומחזירה את הערך הראשון של result שההשוואה הזו מחזירה לגביו את הערך True. מידע נוסף

CASE input_expression
    WHEN expression_to_match THEN result
    [WHEN expression_to_match THEN result]
    [...]
    [ELSE result]
END
CASE מותנה הפונקציה בוחנת את ה-condition של כל סעיף WHEN עוקב ומחזירה את ה-result הראשון שבו ה-condition נכון. כל סעיפי ה-WHEN וה-ELSE שנותרו לא נבחנים. אם כל התנאים הם FALSE או NULL, הפונקציה מחזירה את הערך של else_result אם הוא קיים. אם הוא לא קיים, הפונקציה מחזירה NULL. מידע נוסף

CASE
    WHEN condition THEN result
    [WHEN condition THEN result]
    [...]
    [ELSE else_result]
END
CAST שונות המרת שדה או ביטוי ל-TYPE. אי אפשר להשתמש בשדות נצברים בתוך CAST. הערך של TYPE יכול להיות NUMBER,‏ TEXT או DATETIME. מידע נוסף CAST(field_expression AS TYPE)
CEIL חשבון הפונקציה מחזירה את המספר השלם הקרוב ביותר שגדול מ-X. לדוגמה, אם הערך של X הוא v, אז (CEIL(X גדול מ-v או שווה לו. מידע נוסף CEIL(X)
COALESCE מותנה הפונקציה מחזירה את הערך הראשון שאינו חסר שנמצא ברשימת שדות. מידע נוסף COALESCE(field_expression[,field_expression, ...])
CONCAT טקסט הפונקציה מחזירה טקסט שהוא שרשור של X ו-Y. מידע נוסף. CONCAT(X, Y)
CONTAINS_TEXT טקסט הפונקציה מחזירה את הערך True אם X מכיל טקסט, אחרת היא מחזירה את הערך False. תלוי אותיות רישיות. מידע נוסף. CONTAINS_TEXT(X, text)
COS חשבון מחזירה את הקוסינוס של X. מידע נוסף COS(X)
COUNT צבירה מחזירה את מספר הערכים של X. מידע נוסף COUNT(X)
COUNT_DISTINCT צבירה מחזירה את מספר הערכים הייחודיים של X. מידע נוסף COUNT_DISTINCT(X)
CURRENT_DATE תאריך הפונקציה מחזירה את התאריך הנוכחי לפי אזור הזמן שצוין או לפי אזור הזמן שמוגדר כברירת מחדל. מידע נוסף CURRENT_DATE([time_zone])
CURRENT_DATETIME תאריך הפונקציה מחזירה את התאריך והשעה הנוכחיים לפי אזור הזמן שצוין או אזור הזמן שמוגדר כברירת מחדל. מידע נוסף CURRENT_DATETIME([time_zone])
DATE תאריך יוצרת שדה או ערך של תאריך ממספרים או משדה או ביטוי של תאריך ושעה. מידע נוסף DATE(year, month, day)
DATE_DIFF תאריך הפונקציה מחזירה את ההפרש בימים בין X ל-Y ‏(X - Y). מידע נוסף DATE_DIFF(X, Y)
DATE_FROM_UNIX_DATE תאריך מפרש מספר שלם כמספר הימים שחלפו מאז 1970-01-01. מידע נוסף DATE_FROM_UNIX_DATE(integer)
DATETIME תאריך יצירת שדה או ערך של תאריך ושעה ממספרים. מידע נוסף DATETIME(year, month, day, hour, minute, second)
DATETIME_ADD תאריך הוספת מרווח זמן מסוים לתאריך. מידע נוסף DATETIME_ADD(datetime_expression, INTERVAL integer part)
DATETIME_DIFF תאריך הפונקציה מחזירה את מספר הגבולות של החלקים בין שני תאריכים. מידע נוסף DATETIME_DIFF(date_expression, date_expression, part)
DATETIME_SUB תאריך הפונקציה מחסירה מרווח זמן מסוים מתאריך. מידע נוסף DATETIME_SUB(datetime_expression, INTERVAL integer part)
DATETIME_TRUNC תאריך מקצרת תאריך לרמת הפירוט שצוינה. מידע נוסף DATETIME_TRUNC(date_expression, part)
DAY תאריך הפונקציה מחזירה את היום של תאריך או של תאריך ושעה. מידע נוסף Day(date_expression)
ENDS_WITH  טקסט הפונקציה מחזירה את הערך True אם X מסתיים בטקסט, אחרת היא מחזירה את הערך False. תלוי אותיות רישיות. מידע נוסף. ENDS_WITH(X, text)
EXTRACT תאריך הפונקציה מחזירה חלק מתאריך או מתאריך ושעה. מידע נוסף EXTRACT(part FROM date_expression)
FLOOR חשבון הפונקציה מחזירה את המספר השלם הקרוב ביותר שקטן מ-X. לדוגמה, אם הערך של X הוא v, אז (FLOOR(X שווה ל-v או קטן ממנו. מידע נוסף FLOOR(X)
FORMAT_DATETIME תאריך מחזירה מחרוזת תאריך בפורמט מסוים. מידע נוסף FORMAT_DATETIME(format_string, datetime_expression)
HOUR תאריך מחזירה את השעה של תאריך ושעה. מידע נוסף HOUR(datetime_expression)
HYPERLINK שונות הפונקציה מחזירה היפר-קישור לכתובת ה-URL, עם תווית הקישור. מידע נוסף HYPERLINK(URL, link label)
IF מותנה אם condition נכון, הפונקציה מחזירה את true_result, אחרת היא מחזירה את false_result. הפונקציה false_result לא נבדקת אם הפונקציה condition מחזירה את הערך True. הערך של true_result לא מחושב אם הערך של condition הוא false או NULL. למידע נוסף IF(condition, true_result, false_result)
IFNULL מותנה הפונקציה מחזירה תוצאה אם הקלט הוא null, אחרת היא מחזירה את הקלט. מידע נוסף IFNULL(input_expression, null_result)
IMAGE שונות יוצר שדות תמונה במקור הנתונים מידע נוסף. IMAGE(Image URL, [Alternative Text])
LEFT_TEXT  טקסט הפונקציה מחזירה מספר תווים מתחילת X. מספר התווים מצוין באמצעות length. מידע נוסף. LEFT_TEXT(X, length)
LENGTH טקסט הפונקציה מחזירה את מספר התווים ב-X. מידע נוסף. LENGTH(X)
LOG חשבון הפונקציה מחזירה את הלוגריתם של X לפי בסיס e או בסיס 2, בהתאם למחבר שבו משתמשים. מידע נוסף. LOG(X)
LOG10 חשבון מחזירה את הלוגריתם של X לפי בסיס 10. מידע נוסף LOG10(X)
LOWER טקסט הפונקציה ממירה את X לאותיות קטנות. מידע נוסף. LOWER(X)
MAX צבירה הפונקציה מחזירה את הערך המקסימלי של X. מידע נוסף MAX(X)
MEDIAN צבירה מחזירה את החציון של כל הערכים של X. מידע נוסף MEDIAN(X)
MIN צבירה הפונקציה מחזירה את הערך המינימלי של X. מידע נוסף MIN(X)
MINUTE תאריך הפונקציה מחזירה את רכיב הדקות של תאריך ושעה נתונים. מידע נוסף MINUTE(datetime_expression)
MONTH תאריך הפונקציה מחזירה את החודש מתוך ערך של תאריך ושעה. מידע נוסף MONTH(date_expression)
NARY_MAX חשבון הפונקציה מחזירה את הערך המקסימלי של X, ‏ Y,‏ ‎[,Z]*‎. כל הארגומנטים של הקלט חייבים להיות מאותו סוג: כולם מספרים. לפחות אחד מהארגומנטים של הקלט חייב להיות שדה או ביטוי שמכיל שדה. מידע נוסף NARY_MAX(X, Y [,Z]*)
NARY_MIN חשבון הפונקציה מחזירה את הערך המינימלי של X, ‏ Y,‏ ‎[,Z]*‎. כל הארגומנטים של הקלט חייבים להיות מאותו סוג, כולם מספרים. לפחות אחד מהארגומנטים של הקלט חייב להיות שדה או ביטוי שמכיל שדה. מידע נוסף NARY_MIN(X, Y [,Z]*)
NATIVE_DIMENSION שונות הפונקציה מחזירה את התוצאה של ביטוי SQL כפי שהיא מחושבת על ידי מערך הנתונים הבסיסי. הביטוי לא יכול לכלול צבירות. מידע נוסף NATIVE_DIMENSION("JSON_VALUE('{"name": "Dana"}', '$.name')","STRING")
NULLIF מותנה אם הקלט תואם לביטוי, הפונקציה מחזירה ערך null. אחרת, היא מחזירה את הקלט. מידע נוסף NULLIF(input_expression, expression_to_match)
PARSE_DATE תאריך הפונקציה ממירה טקסט לתאריך. מידע נוסף PARSE_DATE(format_string, text)
PARSE_DATETIME תאריך הפונקציה ממירה טקסט לתאריך עם שעה. מידע נוסף PARSE_DATETIME(format_string, text)
PERCENTILE צבירה מחזירה את דירוג האחוזון N של שדה X. מידע נוסף PERCENTILE(X,N)
POWER חשבון הפונקציה מחזירה את התוצאה של העלאת X בחזקת Y. מידע נוסף POWER(X, Y)
QUARTER תאריך הפונקציה מחזירה את הרבעון בשנה של תאריך נתון. מידע נוסף QUARTER(date_expression)
REGEXP_CONTAINS טקסט הפונקציה מחזירה את הערך True אם X מכיל את תבנית הביטוי הרגולרי, אחרת היא מחזירה את הערך False. מידע נוסף. REGEXP_CONTAINS(X, regular_expression)
REGEXP_EXTRACT טקסט הפונקציה מחזירה את תת-המחרוזת הראשונה ב-X שתואמת לתבנית של הביטוי הרגולרי. מידע נוסף. REGEXP_EXTRACT(X, regular_expression)
REGEXP_MATCH טקסט הפונקציה מחזירה את הערך True אם X תואם לתבנית הביטוי הרגולרי, אחרת היא מחזירה את הערך False. מידע נוסף. REGEXP_MATCH(X, regular_expression)
REGEXP_REPLACE טקסט הפונקציה מחליפה את כל המופעים של טקסט שתואמים לתבנית הביטוי הרגולרי ב-X במחרוזת replacement. מידע נוסף. REGEXP_REPLACE(X, regular_expression, replacement)
REPLACE טקסט הפונקציה מחזירה עותק של X שבו כל המופעים של Y ב-X מוחלפים ב-Z. מידע נוסף REPLACE(X, Y, Z)
RIGHT_TEXT  טקסט הפונקציה מחזירה מספר תווים מסוף המחרוזת X. מספר התווים מצוין באמצעות length. מידע נוסף. RIGHT_TEXT(X, length)
ROUND חשבון הפונקציה מחזירה את X מעוגל ל-Y ספרות דיוק. מידע נוסף ROUND(X, Y)
SECOND תאריך הפונקציה מחזירה את רכיב השניות של תאריך ושעה נתונים. מידע נוסף SECOND(datetime_expression)
SIN חשבון מחזירה את הסינוס של X. מידע נוסף SIN(X)
SQRT חשבון מחזירה את השורש הריבועי של X. חשוב לזכור ש-X לא יכול להיות שלילי. מידע נוסף SQRT(X)
STARTS_WITH  טקסט הפונקציה מחזירה את הערך True אם X מתחיל בטקסט. אחרת, יוחזר הערך false. תלוי אותיות רישיות. מידע נוסף. STARTS_WITH(X, text)
STDDEV צבירה מחזירה את סטיית התקן של X. מידע נוסף STDDEV(X)
SUBSTR טקסט הפונקציה מחזירה טקסט שהוא תת-מחרוזת של X. מחרוזת המשנה מתחילה ב-start index והאורך שלה הוא length תווים. למידע נוסף. SUBSTR(X, start index, length)
SUM צבירה מחזירה את הסכום של כל הערכים של X. מידע נוסף SUM(X)
TAN חשבון הפונקציה מחזירה את הטנגנס של X. מידע נוסף TAN(X)
TOCITY Geo מחזירה את שם העיר של X. TOCITY(X [,Input Format])
TOCONTINENT Geo מחזירה את שם היבשת של X. מידע נוסף TOCONTINENT(X [,Input Format])
TOCOUNTRY Geo מחזירה את שם המדינה של X. מידע נוסף TOCOUNTRY(X [,Input Format])
TODATE תאריך מחזירה תאריך בפורמט של מצב תאימות. מידע נוסף TODATE(X, Input Format, Output Format)
TODAY תאריך הפונקציה מחזירה את התאריך הנוכחי לפי אזור הזמן שצוין או לפי אזור הזמן שמוגדר כברירת מחדל. מידע נוסף TODAY([time_zone])
TOREGION Geo מחזירה את שם האזור של X. מידע נוסף TOREGION(X [,Input Format])
TOSUBCONTINENT Geo הפונקציה מחזירה את שם תת-היבשת של X. מידע נוסף TOSUBCONTINENT(X [,Input Format])
TRIM טקסט הפונקציה מחזירה את X בלי רווחים בתחילת הטקסט ובסופו. מידע נוסף. TRIM(X)
UNIX_DATE תאריך הפונקציה מחזירה את מספר הימים שחלפו מאז 1970-01-01. מידע נוסף UNIX_DATE(date_expression)
UPPER טקסט הפונקציה ממירה את X לאותיות רישיות. מידע נוסף. UPPER(X)
VARIANCE צבירה מחזירה את השונות של X. מידע נוסף VARIANCE(X)
WEEK תאריך הפונקציה מחזירה את מספר השבוע של תאריך נתון. מידע נוסף WEEK(Date)
WEEKDAY תאריך הפונקציה מחזירה מספר שמייצג את היום בשבוע של תאריך נתון. מידע נוסף WEEKDAY(Date)
YEAR תאריך הפונקציה מחזירה את השנה של תאריך נתון. מידע נוסף YEAR(Date)
YEARWEEK תאריך הפונקציה מחזירה את השנה ואת מספר השבוע של תאריך נתון. מידע נוסף YEARWEEK(Date)