Skip to content

Commit

Permalink
Merge pull request #12354 from MicrosoftDocs/main
Browse files Browse the repository at this point in the history
9/19/2024 PM Publish
  • Loading branch information
Emma-yxf authored Sep 19, 2024
2 parents 4562e9a + 4e869f9 commit 8f96257
Show file tree
Hide file tree
Showing 213 changed files with 966 additions and 410 deletions.
5 changes: 5 additions & 0 deletions .openpublishing.redirection.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
{
"redirections": [
{
"source_path": "powerbi-docs/visuals/power-bi-visualization-column-charts-format-settings.md",
"redirect_url": "/power-bi/visuals/power-bi-visualization-column-chart-format-settings",
"redirect_document_id": true
},
{
"source_path": "powerbi-docs/connect-data/service-aml-integrate.md",
"redirect_url": "/fabric/data-science/use-ai-samples",
Expand Down
18 changes: 12 additions & 6 deletions powerbi-docs/create-reports/TOC.yml
Original file line number Diff line number Diff line change
Expand Up @@ -322,20 +322,26 @@
href: service-reports-visual-interactions.md
- name: Customize x-axis and y-axis properties
href: ../visuals/power-bi-visualization-customize-x-axis-and-y-axis.md
- name: Card visuals
items:
- name: Create a card visual
href: ../visuals/power-bi-visualization-new-card.md
- name: Card visual format settings explained
href: ../visuals/power-bi-visualization-card-visual-new-format-settings.md
- name: Create card visuals with big number tiles
href: ../visuals/power-bi-visualization-card.md
- name: Create a new card visual with big number tiles
href: ../visuals/power-bi-visualization-new-card.md
- name: Column and bar charts
items:
- name: Create a column chart
href: ../visuals/power-bi-visualization-column-charts.md
- name: Column charts format settings
href: ../visuals/power-bi-visualization-column-charts-format-settings.md
- name: Column chart format settings explained
href: ../visuals/power-bi-visualization-column-chart-format-settings.md
- name: Format column and bar charts
href: ../visuals/power-bi-visualization-column-bar-format.md
- name: Basic area charts
href: ../visuals/power-bi-visualization-basic-area-chart.md
- name: Create card visuals with big number tiles
href: ../visuals/power-bi-visualization-card.md
- name: Create a new card visual with big number tiles
href: ../visuals/power-bi-visualization-new-card.md
- name: Combo charts
href: ../visuals/power-bi-visualization-combo-chart.md
- name: Doughnut charts
Expand Down
26 changes: 13 additions & 13 deletions powerbi-docs/create-reports/desktop-custom-format-strings.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ To create custom format strings in the model, select the field in the **Modeling

![Screenshot of the Properties pane, highlighting the Format menu.](media/desktop-custom-format-strings/custom-format-strings-02.png)

Once you've selected **Custom** from the **Format** dropdown menu, choose from a list of commonly used format strings.
Once you select **Custom** from the **Format** dropdown menu, choose from a list of commonly used format strings.

![Screenshot of the Formatting menu, highlighting Custom.](media/desktop-custom-format-strings/custom-format-strings-03.png)

Expand Down Expand Up @@ -103,7 +103,7 @@ The following tables define the syntax supported in Power BI.

You can see an [example](/office/vba/language/reference/user-interface-help/format-function-visual-basic-for-applications#example) of how to format custom value strings.

A user-defined format expression for numbers can have one to three sections separated by semicolons. If you include semicolons with nothing between them, the missing section won't display (it will be ""). If you don't specify the semicolon, it uses the positive format.
A user-defined format expression for numbers can have one to three sections separated by semicolons. If you include semicolons with nothing between them, the missing section doesn't display, instead you see "". If you don't specify the semicolon, it uses the positive format.

Here are examples of different formats for different value strings:

Expand Down Expand Up @@ -131,10 +131,10 @@ The following table identifies the predefined **named numeric formats**:
| **Format name** | **Description** |
| --- | --- |
| **General Number** | Display number with no thousand separator. |
| **Currency** | Display number with a thousand separator. Display two digits to the right of the decimal separator. Output is based on system locale settings. |
| **Fixed** | Display at least one digit to the left and two digits to the right of the decimal separator. |
| **Standard** | Display number with thousand separator, at least one digit to the left and two digits to the right of the decimal separator. |
| **Percent** | Display number multiplied by 100 with a percent sign ( **%** ) appended to the right. Always display two digits to the right of the decimal separator. |
| **Currency** | Display number with a thousand separator. Display two digits after the decimal separator. Output is based on system locale settings. |
| **Fixed** | Display at least one digit before and two digits after the decimal separator. |
| **Standard** | Display number with a thousand separator, at least one digit before and two digits after the decimal separator. |
| **Percent** | Display number multiplied by 100 with a percent sign ( **%** ). Always display two digits after the decimal separator. |
| **Scientific** | Use standard scientific notation. |

The following table identifies characters you can use to create **user-defined date/time formats**.
Expand Down Expand Up @@ -166,16 +166,16 @@ The following table identifies characters you can use to create **user-defined n
| **Character** | **Description** |
| --- | --- |
| None | Display the number with no formatting. |
| ( **0** ) | Digit placeholder. Display a digit or a zero. If the expression has a digit in the position where the 0 appears in the format string, display it. Otherwise, display a zero in that position. If the number has fewer digits than there are zeros (on either side of the decimal) in the format expression, display leading or trailing zeros. If the number has more digits to the right of the decimal separator than there are zeros to the right, round the number to as many decimal places as there are zeros. If the number has more digits to the left of the decimal separator than there are zeros to the left, display the extra digits without modification. |
| ( **#** ) | Digit placeholder. Display a digit or nothing. If the expression has a digit in the position where the # appears in the format string, display it; otherwise, display nothing in that position. This symbol works like the zero-digit placeholder, except that leading and trailing zeros aren't displayed if the number has the same or fewer digits than there are # characters on either side of the decimal separator in the format expression. |
| ( **.** ) | Decimal placeholder. In some locales, a comma is used as the decimal separator. The decimal placeholder determines how many digits are displayed to the left and right of the decimal separator. If the format expression contains only number signs to the left of this symbol, numbers smaller than 1 begin with a decimal separator. To display a leading zero displayed with fractional numbers, use 0 as the first-digit placeholder to the left of the decimal separator. The actual character used as a decimal placeholder in the formatted output depends on the Number Format recognized by your system. |
| ( **0** ) | Digit placeholder. Display a digit or a zero. If the expression has a digit in the position where the 0 appears in the format string, display it. Otherwise, display a zero in that position. If the number has fewer digits than there are zeros (on either side of the decimal) in the format expression, display leading or trailing zeros. If the number has more digits than there are zeros after the decimal separator, round the number to as many decimal places as there are zeros. If the number has more digits than there are zeros before the decimal separator, display the extra digits without modification. |
| ( **#** ) | Digit placeholder. Display a digit or nothing. If the expression has a digit in the position where the # appears in the format string, display it; otherwise, display nothing in that position. This symbol works like the zero-digit placeholder. However, leading and trailing zeros don't display if the number has the same or fewer digits than there are # characters on either side of the decimal separator in the format expression. |
| ( **.** ) | Decimal placeholder. In some locales, a comma is used as the decimal separator. The decimal placeholder determines how many digits are displayed before and after the decimal separator. If the format expression contains only number signs to the left of this symbol, numbers smaller than one begin with a decimal separator. To display a leading zero displayed with fractional numbers, use 0 as the first-digit placeholder to the left of the decimal separator. The actual character used as a decimal placeholder in the formatted output depends on the Number Format recognized by your system. |
| (**%)** | Percentage placeholder. The expression is multiplied by 100. The percent character ( **%** ) is inserted in the position where it appears in the format string. |
| ( **,** ) | Thousand separators. In some locales, a period is used as a thousand separator. The thousand separator separates thousands from hundreds within a number that has four or more places to the left of the decimal separator. Standard use of the thousand separator is specified if the format contains a thousand separator surrounded by digit placeholders ( **0** or **#** ). Two adjacent thousand separators or a thousand separator immediately to the left of the decimal separator (whether or not a decimal is specified) means "scale the number by dividing it by 1000, rounding as needed." For example, you can use the format string "##0,," to represent 100 million as 100. Numbers smaller than 1 million are displayed as 0. Two adjacent thousand separators in any position other than immediately to the left of the decimal separator are treated simply as specifying the use of a thousand separator. The actual character used as the thousand separator in the formatted output depends on the Number Format recognized by your system. |
| ( **,** ) | Thousand separators. In some locales, a period is used as a thousand separator. The thousand separator separates thousands from hundreds within a number that has four or more places to the left of the decimal separator. Standard use of the thousand separator is specified if the format contains a thousand separator surrounded by digit placeholders ( **0** or **#** ). Two adjacent thousand separators or a thousand separator immediately to the left of the decimal separator (whether or not a decimal is specified) means "scale the number by dividing it by 1000, rounding as needed." For example, you can use the format string "##0,," to represent 100 million as 100. Numbers smaller than one million are displayed as 0. Two adjacent thousand separators in any position other than immediately to the left of the decimal separator are treated simply as specifying the use of a thousand separator. The actual character used as the thousand separator in the formatted output depends on the Number Format recognized by your system. |
| ( **:** ) | Time separator. In some locales, other characters might be used to represent the time separator. The time separator separates hours, minutes, and seconds when time values are formatted. The actual character used as the time separator in formatted output is determined by your system settings. |
| ( **/** ) | Date separator. In some locales, other characters might be used to represent the date separator. The date separator separates the day, month, and year when date values are formatted. The actual character used as the date separator in formatted output is determined by your system settings. |
| ( **E- E+ e- e+** ) | Scientific format. If the format expression contains at least one digit placeholder ( **0** or **#** ) to the right of E-, E+, e-, or e+, the number is displayed in scientific format and E or e is inserted between the number and its exponent. The number of digit placeholders to the right determines the number of digits in the exponent. Use E- or e- to place a minus sign next to negative exponents. Use E+ or e+ to place a minus sign next to negative exponents and a plus sign next to positive exponents. |
| **- + $** ( ) | Display a literal character. To display a different character, precede it with a backslash (\\) or enclose it in double quotation marks (" "). |
| ( **\\** ) | Display the next character in the format string. To display a character that has special meaning as a literal character, precede it with a backslash (\\). The backslash itself isn't displayed. Using a backslash is the same as enclosing the next character in double quotation marks. To display a backslash, use two backslashes (\\\\). Date-formatting and time-formatting characters (a, c, d, h, m, n, p, q, s, t, w, /, and :) can't be displayed as literal characters, the numeric-formatting characters (#, 0, %, E, e, comma, and period), and the string-formatting characters (@, &, <, >, and !). |
| ( **E- E+ e- e+** ) | Scientific format. If the format expression contains at least one digit placeholder ( **0** or **#** ) after E-, E+, e-, or e+, the number is displayed in scientific format and E or e is inserted between the number and its exponent. The number of digit placeholders determines the number of digits in the exponent. Use E- or e- to place a minus sign next to negative exponents. Use E+ or e+ to place a minus sign next to negative exponents and a plus sign next to positive exponents. |
| - **+ $** ( ) | Display a literal character. To display a different character, precede it with a backslash (\\) or enclose it in double quotation marks (" "). |
| ( **\\** ) | Display the next character in the format string. To display a character that has special meaning as a literal character, precede it with a backslash (\\). The backslash itself isn't displayed. Using a backslash is the same as enclosing the next character in double quotation marks. To display a backslash, use two backslashes (\\\\). Date-formatting and time-formatting characters (a, c, d, h, m, n, p, q, s, t, w, /, and :) can't be displayed as literal characters, the numeric-formatting characters (#, 0, %, E, e, comma, and period), and the string-formatting characters (@, &, <, >, !). |
| ("ABC") | Display the string inside the double quotation marks (" "). |

## Considerations and limitations
Expand Down
1 change: 0 additions & 1 deletion powerbi-docs/includes/core-visuals/axis-range-maximum.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,5 +11,4 @@ ms.custom: include file - variant
LocalizationGroup: core-visuals
---
###### Maximum

This setting defines the final axis value. If no user-defined value is provided, the system automatically assigns a maximum value based on the data. Additionally, this value can be determined through conditional formatting.
7 changes: 4 additions & 3 deletions powerbi-docs/includes/core-visuals/axis-title-style.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ LocalizationGroup: core-visuals
###### Style

The menu provides options for configuring the axis title, but only when the axis value's Display units is set to display Thousands, Millions, Billions, or Trillions:
**- Shows title only:** This default option displays only the title. If the Display units are set to *None*, this remains the only available option.
**- Show unit only:** This exhibits solely the unit as determined in the display units control.
**- Show both:** This presents both the title and the unit as selected in the Display units control.

- **Shows title only:** This default option displays only the title. If the Display units are set to *None*, displaying the title remains the only available option.
- **Show unit only:** This exhibits solely the unit as determined in the display units control.
- **Show both:**: **Show both** presents both the title and the unit as selected in the Display units control.
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,9 @@ ms.date: 06/21/2024
ms.custom: include file - variant
LocalizationGroup: core-visuals
---
#### Border position
###### Border position

This setting offers four options to specify the position of the Border:
**- Top**
**- Bottom**
**- Top and bottom**
- **Top**
- **Bottom**
- **Top and bottom**
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,6 @@ ms.date: 06/26/2024
ms.custom: include file - variant
LocalizationGroup: core-visuals
---
#### Width
###### Width

This setting allows you to define the thickness in pixels, offering a range from 1 to 10 (widest).
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,9 @@ ms.date: 06/25/2024
ms.custom: include file - variant
LocalizationGroup: core-visuals
---
#### Line style
###### Line style

The menu provides three selections to customize the line style pattern:
**- Solid:** A continuous line without breaks.
**- Dashed:** A line consisting of a series of short segments.
**- Dotted:** A line made up of a sequence of dots.
- **Solid:** A continuous line without breaks.
- **Dashed:** A line consisting of a series of short segments.
- **Dotted:** A line made up of a sequence of dots.
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,6 @@ ms.date: 06/26/2024
ms.custom: include file - variant
LocalizationGroup: core-visuals
---
#### Width
###### Width

The border width setting allows you to define the thickness in pixels, offering a range from 0 (none) to 12 (widest).
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,6 @@ ms.date: 06/13/2024
ms.custom: include file - variant
LocalizationGroup: core-visuals
---
#### Align baselines
###### Align baselines

This toggle ensures the baselines of the labels are aligned when displaying multiple series in a chart to maintain a uniform look across all labels. This feature is only available when **All series** is selected in the **Apply settings to** option.
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,6 @@ ms.date: 06/18/2024
ms.custom: include file - variant
LocalizationGroup: core-visuals
---
#### Heading
###### Heading

The dropdown menu allows you to select the hierarchical level of the label, with options ranging from **Normal** to **Heading 2** through **Heading 6**, to organize content in a structured manner, providing a hierarchy for easy navigation and reading.
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,6 @@ ms.date: 06/13/2024
ms.custom: include file - variant
LocalizationGroup: core-visuals
---
#### Match value alignment
###### Match value alignment

When enabled, and the **Apply settings to** is set to **Series all**, this toggle ensures that the horizontal alignment of all labels matches the alignment of the data values. When the toggle *isn't* enabled, the horizontal alignment options are available, allowing you to align the text to the left, center, or right according to your liking.
When enabled, and the **Apply settings to** is set to **Series all**, this toggle ensures that the horizontal alignment of all labels matches the alignment of the data values. When the toggle *isn't* enabled, the horizontal alignment options are available, allowing you to align the text to your liking.
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,8 @@ ms.date: 06/21/2024
ms.custom: include file - variant
LocalizationGroup: core-visuals
---
#### Position
###### Position

With this dropdown menu, users have two options to specify the position of the label in relation to the data value:
**- Above Value:** Positions the label above the data value.
**- Below Value:** Positions the label below the data value.
- **Above Value:** Positions the label above the data value.
- **Below Value:** Positions the label below the data value.
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,6 @@ ms.date: 06/25/2024
ms.custom: include file - variant
LocalizationGroup: core-visuals
---
#### Space between label and value
###### Space between label and value

This setting adjusts the space between the label and the data value from 0 to 40 pixels.
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,6 @@ ms.date: 06/25/2024
ms.custom: include file - variant
LocalizationGroup: core-visuals
---
#### Text
###### Text

The default text for the Label title is automatically derived from the name of the data field used. However, you have the option to customize this title to a different text or you may decide to apply conditional formatting.
The default text for the Label title is automatically derived from the name of the data field used. However, you can customize this title to a different text or you might decide to apply conditional formatting.
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,6 @@ ms.date: 06/25/2024
ms.custom: include file - variant
LocalizationGroup: core-visuals
---
#### Callout size
###### Callout size

This setting allows you to establish the size, as a percentage of the card size, from 0% to 100%.
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,6 @@ ms.date: 06/25/2024
ms.custom: include file - variant
LocalizationGroup: core-visuals
---
#### Format code
###### Format code

Allows you to select one of seven possible date formats.
Loading

0 comments on commit 8f96257

Please sign in to comment.