named_value_format

Usage

named_value_format: desired_name {
  value_format: "excel formatting string"
  strict_value_format: yes | no
}

היררכיה קובץ מודל named_value_format

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

הגדרה

הפרמטר named_value_format מאפשר ליצור ולשמור פורמט מותאם אישית שאפשר להחיל על כמה מאפיינים ומדדים.

פורמטים בהתאמה אישית ב-Looker נוצרים ומשמשים בכמה שלבים:

1. קודם משתמשים ב-named_value_format בקובץ המודל כדי להצהיר על שם לפורמט המותאם אישית החדש. השם הזה חייב להיות מחרוזת בלי רווחים.
2. לאחר מכן, משתמשים בפרמטר המשנה value_format מתחת לפרמטר named_value_format כדי להגדיר את העיצוב הרצוי באמצעות מחרוזת פורמט בסגנון Excel.
3. לבסוף, מחילים את הפורמט המותאם אישית הזה על מאפיינים ומדדים על ידי הפניה אליו בפרמטר value_format_name ברמת השדה.

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

מחרוזות פורמט נפוצות של value_format

הפורמט שמשמש עם הפרמטר 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)
                              #   Please 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)
                              #   Please note division by 1 million happens automatically
value_format: "0.000,\" K\""  # Number in thousands with 3 decimals (1.234 K)
                              #   Please 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%)

‫strict_value_format מחליף את מאפיין המשתמש number_format

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

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

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

דוגמאות

יוצרים פורמט מותאם אישית בשם euro_in_thousands שנראה כך: €1.23K:

named_value_format: euro_in_thousands {
  value_format: "\"€\"0.000,\" K\""
}

כדי למנוע מהמאפיין number_formatting של המשתמש להשפיע על הפורמט של euro_in_thousands:

named_value_format: euro_in_thousands {
  value_format: "\"€\"0.000,\" K\""
  strict_value_format: yes
}

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

יוצרים פורמט מותאם אישית בשם usd_in_millions שנראה כמו $1.23M ופורמט בשם phone_number שנראה כמו [phone]:

named_value_format: usd_in_millions {
  value_format: "$0.000,,\" M\""
}
named_value_format: phone_number {
  value_format: "(###) ###-####"
}