value_format

Usage

view: view_name {
  dimension: field_name {
    value_format:"$#.00;($#.00)"
  }
}

היררכיה הצגת הקובץ view סוג השדה value_format

סוגי שדות אפשריים מאפיין, מדד אישור מחרוזת שמכילה עיצוב בסגנון Excel

הגדרה

הפרמטר value_format מאפשר לכם לעצב ערכי נתונים ב-Looker באמצעות פורמטים בסגנון Excel. אפשר להשתמש ב-value_format בדרכים הבאות:

• בנפרד, ברמת השדה, כדי להחיל עיצוב בסגנון Excel ישירות על מאפיין או מדד ספציפיים
• כפרמטר משנה של הפרמטר named_value_format, ברמת המודל, כדי ליצור פורמט מותאם אישית לשימוש חוזר שאפשר להחיל על כמה שדות

הערה: value_format משפיע רק על האופן שבו ערכי השדות מוצגים בתוכן של Looker. ‫value_format לא משנה או משפיע על הערך במסד הנתונים.

החלת value_format ישירות על מאפיינים ומדדים

אפשר להשתמש בפרמטר value_format גם במאפיינים וגם במדדים. כדי להחיל על מאפיינים עיצוב בסגנון Excel באמצעות value_format, סוג המאפיין צריך להיות number. כדי להחיל עיצוב בסגנון Excel על מדדים באמצעות value_format, צריך לוודא שהמדד הוא מספרי ולא מסוג type: string. לדוגמה:

dimension: order_amount {
  type: number
  sql: ${TABLE}.order_amount ;;
  value_format: "$#.00;($#.00)"
}
measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format: "$#.00;($#.00)"
}

שימוש ב-value_format כדי להגדיר פורמט מותאם אישית לשימוש חוזר

מידע על שימוש ב-value_format עם named_value_format כדי להגדיר פורמטים שאפשר לעשות בהם שימוש חוזר מופיע בדף התיעוד של הפרמטר named_value_format.

אפשרויות עיצוב שמוגדרות כברירת מחדל

אם אתם מעדיפים להחיל אחד מפורמטי הערכים המובנים של Looker, תוכלו לבחור מבין הפורמטים שמפורטים בקטע Default Format Names בדף התיעוד של הפרמטר value_format_name. הוראות לשימוש ב-value_format_name כדי להחיל פורמטים מובנים מופיעות בדף הזה.

מחרוזות פורמט נפוצות

‫value_format מקבלת מחרוזת פורמט בסגנון Excel.

הפורמט שמשמש עם הפרמטר value_format זהה לפורמט שמשמש בשדה Value Format בתרשימים, אלא שבפרמטר value_format מחרוזת הפורמט צריכה להיות מוקפת במירכאות כפולות. במאמר אפשרויות לתרשימי עמודות אנכיים מוסבר על פורמטים של ערכים בהדמיות.

במסמכים של Excel אפשר לקרוא את המדריך המלא בנושא ציון הפורמטים האלה. עם זאת, בשלב הזה, אין תמיכה ב-Looker בעיצוב תאריכים, בעיצוב צבעים ובהמרה הקסדצימלית.

כאן מוצגות כמה מאפשרויות העיצוב הנפוצות ביותר. שימו לב שחלק מהתווים המיוחדים, כמו סמלי מטבע בינלאומיים, צריכים להיות מוקפים במרכאות כפולות.

value_format: "0"             # Integer (123)
value_format: "*00#"          # Integer zero-padded to 3 places (001)
value_format: "0 \" String\"" # Integer followed by a string (123 String)
                              #   Note \"String\" can be replaced with any other word

value_format: "0.##"          # Number up to 2 decimals (1. or 1.2 or 1.23)
value_format: "0.00"          # Number with exactly 2 decimals (1.23)
value_format: "*00#.00"       # Number zero-padded to 3 places and exactly 2 decimals (001.23)
value_format: "#,##0"         # Number with comma between thousands (1,234)
value_format: "#,##0.00"      # Number with comma between thousands and 2 decimals (1,234.00)
value_format: "0.000,,\" M\"" # Number in millions with 3 decimals (1.234 M)
                              #   Note division by 1 million happens automatically
value_format: "0.000,\" K\""  # Number in thousands with 3 decimals (1.234 K)
                              #   Note division by 1 thousand happens automatically

value_format: "$0"            # Dollars with 0 decimals ($123)
value_format: "$0.00"         # Dollars with 2 decimals ($123.00)
value_format: "\"€\"0"        # Euros with 0 decimals (€123)
value_format: "$#,##0.00"     # Dollars with comma btwn thousands and 2 decimals ($1,234.00)
value_format: "$#.00;($#.00)" # Dollars with 2 decimals, positive values displayed
                              #   normally, negative values wrapped in parenthesis

value_format: "0\%"           # Display as percent with 0 decimals (1 becomes 1%)
value_format: "0.00\%"        # Display as percent with 2 decimals (1 becomes 1.00%)
value_format: "0%"            # Convert to percent with 0 decimals (.01 becomes 1%)
value_format: "0.00%"         # Convert to percent with 2 decimals (.01 becomes 1.00%)

דוגמה לעיצוב מותנה מתקדם יותר עם הפרמטר value_format מופיעה בדף שיטות מומלצות לעיצוב מותנה באמצעות value_format.

אתגרים נפוצים

איבוד ספרות עשרוניות בחילוק

אחת מהתכונות המוזרות הנפוצות של SQL שמתגלות כשמשתמשים ב-value_format היא האופן שבו SQL מטפל במתמטיקה של מספרים שלמים. אם מחלקים 5 ב-2, רוב האנשים מצפים שהתוצאה תהיה 2.5. עם זאת, בהרבה ניבי SQL התוצאה תהיה רק 2, כי כשמחלקים שני מספרים שלמים, התוצאה היא גם מספר שלם. כדי לפתור את הבעיה הזו, אפשר להכפיל את המונה במספר עשרוני (כמו 1.0 או 100.0) כדי לחייב את SQL להחזיר תוצאה עשרונית. לדוגמה:

measure: active_users_percent {
  type: number
  sql: 100.000 * ${active_users} / ${users} ;;
  value_format: "0.000"
}

שימוש במאפיין value_format עם מאפיין המשתמש number_format

אם משתמשים ב-value_format כדי לעצב שדות במודלים, פורמט המספר שנבחר במאפיין המשתמש number_format מוחל על הפורמט שמוחל באמצעות value_format. לדוגמה ומידע נוסף, אפשר לעיין בדף התיעוד בנושא התאמה לשוק המקומי של פורמט מספרים.