diff --git a/data-explorer/kusto/query/array-sum-function.md b/data-explorer/kusto/query/array-sum-function.md index 27757123f3..70410c9226 100644 --- a/data-explorer/kusto/query/array-sum-function.md +++ b/data-explorer/kusto/query/array-sum-function.md @@ -33,7 +33,7 @@ Returns a double type value with the sum of the elements of the array. ## Examples -This following example shows the sum of an array. +The following example shows the sum of an array. :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/asin-function.md b/data-explorer/kusto/query/asin-function.md index f153bed14d..df9e11aedd 100644 --- a/data-explorer/kusto/query/asin-function.md +++ b/data-explorer/kusto/query/asin-function.md @@ -27,7 +27,7 @@ Calculates the angle whose sine is the specified number, or the arc sine. This i Returns the value of the arc sine of `x`. Returns `null` if `x` < -1 or `x` > 1. -## Example +## Examples :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/atan-function.md b/data-explorer/kusto/query/atan-function.md index d83173d7b8..4661cf0ed5 100644 --- a/data-explorer/kusto/query/atan-function.md +++ b/data-explorer/kusto/query/atan-function.md @@ -27,7 +27,7 @@ Returns the angle whose tangent is the specified number. This is the inverse ope The value of the arc tangent of `x`. -## Example +## Examples :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/avg-aggregation-function.md b/data-explorer/kusto/query/avg-aggregation-function.md index 877e5ab925..a14828ce4c 100644 --- a/data-explorer/kusto/query/avg-aggregation-function.md +++ b/data-explorer/kusto/query/avg-aggregation-function.md @@ -29,7 +29,7 @@ Calculates the average (arithmetic mean) of *expr* across the group. Returns the average value of *expr* across the group. -## Example +## Examples The following example returns the average number of damaged crops per state. diff --git a/data-explorer/kusto/query/avgif-aggregation-function.md b/data-explorer/kusto/query/avgif-aggregation-function.md index 93f9b6293a..b327d38b59 100644 --- a/data-explorer/kusto/query/avgif-aggregation-function.md +++ b/data-explorer/kusto/query/avgif-aggregation-function.md @@ -30,7 +30,7 @@ Calculates the [average](avg-aggregation-function.md) of *expr* in records for w Returns the average value of *expr* in records where *predicate* evaluates to `true`. -## Example +## Examples The following example calculates the average damage by state in cases where there was any damage. diff --git a/data-explorer/kusto/query/azure-digital-twins-query-request-plugin.md b/data-explorer/kusto/query/azure-digital-twins-query-request-plugin.md index 0d3d379354..64cc2eba55 100644 --- a/data-explorer/kusto/query/azure-digital-twins-query-request-plugin.md +++ b/data-explorer/kusto/query/azure-digital-twins-query-request-plugin.md @@ -34,10 +34,6 @@ The `azure_digital_twins_query_request` plugin uses the Microsoft Entra account ## Examples -The following examples show how you can run various Azure Digital Twins queries, including queries that use additional Kusto expressions. - -### Retrieval of all twins within an Azure Digital Twins instance - The following example returns all digital twins within an Azure Digital Twins instance. ```kusto @@ -48,7 +44,6 @@ evaluate azure_digital_twins_query_request( :::image type="content" source="media/azure-digital-twins-query-request-plugin/adt-twins.png" alt-text="Screenshot of the twins present in the Azure Digital Twins instance."::: -### Projection of twin properties as columns along with additional Kusto expressions The following example returns the result from the plugin as separate columns, and then performs additional operations using Kusto expressions. diff --git a/data-explorer/kusto/query/bag-has-key-function.md b/data-explorer/kusto/query/bag-has-key-function.md index 3cf9d96f3b..fb745b96a4 100644 --- a/data-explorer/kusto/query/bag-has-key-function.md +++ b/data-explorer/kusto/query/bag-has-key-function.md @@ -51,7 +51,7 @@ datatable(input: dynamic) |{
"key1": 123,
"key2": "abc"
}|true
| |{
"key1": 123,
"key3": "abc"
}|false
| -### Search using a JSONPath key +The following example searches using a JSONPath key. :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/bag-keys-function.md b/data-explorer/kusto/query/bag-keys-function.md index aa55b34a83..fec507ea78 100644 --- a/data-explorer/kusto/query/bag-keys-function.md +++ b/data-explorer/kusto/query/bag-keys-function.md @@ -27,7 +27,7 @@ Enumerates all the root keys in a dynamic property bag object. An array of keys, order is undetermined. -## Example +## Examples :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/bag-merge-function.md b/data-explorer/kusto/query/bag-merge-function.md index 6e10b15f52..6fb2ba683b 100644 --- a/data-explorer/kusto/query/bag-merge-function.md +++ b/data-explorer/kusto/query/bag-merge-function.md @@ -27,7 +27,7 @@ The function merges multiple `dynamic` property bags into a single `dynamic` pro A `dynamic` property bag containing the merged results of all input property bags. If a key is present in multiple input bags, the value associated with the key from the leftmost argument takes precedence. -## Example +## Examples :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/bag-remove-keys-function.md b/data-explorer/kusto/query/bag-remove-keys-function.md index 24f9e80c4d..e82c77bb27 100644 --- a/data-explorer/kusto/query/bag-remove-keys-function.md +++ b/data-explorer/kusto/query/bag-remove-keys-function.md @@ -51,7 +51,7 @@ datatable(input:dynamic) |{
"key1": 123,
"key2": "abc"
}|{
"key1": 123
}| |{
"key1": "value",
"key3": 42.0
}|{
"key1": "value",
"key3": 42.0
}| -### Remove inner properties of dynamic values using JSONPath notation +The following example removes inner properties of dynamic values using JSONPath notation. :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/datetime-local-to-utc-function.md b/data-explorer/kusto/query/datetime-local-to-utc-function.md index 706bee7aac..bb45513c5b 100644 --- a/data-explorer/kusto/query/datetime-local-to-utc-function.md +++ b/data-explorer/kusto/query/datetime-local-to-utc-function.md @@ -26,9 +26,11 @@ Converts local datetime to UTC datetime using [a time-zone specification](timezo ## Returns -A UTC [datetime](scalar-data-types/datetime.md) that corresponds the local [datetime](scalar-data-types/datetime.md) in the specified `timezone`. +Returns a UTC [datetime](scalar-data-types/datetime.md) that corresponds the local [datetime](scalar-data-types/datetime.md) in the specified `timezone`. -## Example +## Examples + +The following example shows how to convert a local datetime to UTC datetime. :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] @@ -56,14 +58,13 @@ datatable(local_dt: datetime, tz: string) > Normally there is a 1:1 mapping between UTC and local time, however there is a time ambiguity near the DST transition. > Translating from local to UTC and then back to local may produce an hour offset between two local datetime values if the clocks were advanced due to DST. - ```kusto range Local from datetime(2022-03-27 01:00:00.0000000) to datetime(2022-03-27 04:00:00.0000000) step 1h | extend UTC=datetime_local_to_utc(Local, 'Europe/Brussels') | extend BackToLocal=datetime_utc_to_local(UTC, 'Europe/Brussels') | extend diff=Local-BackToLocal ``` - + |Local|UTC|BackToLocal|diff| |---|---|---|---| |2022-03-27 02:00:00.0000000|2022-03-27 00:00:00.0000000|2022-03-27 01:00:00.0000000|01:00:00| diff --git a/data-explorer/kusto/query/datetime-part-function.md b/data-explorer/kusto/query/datetime-part-function.md index ca1a9da909..0bbde7ce95 100644 --- a/data-explorer/kusto/query/datetime-part-function.md +++ b/data-explorer/kusto/query/datetime-part-function.md @@ -43,12 +43,14 @@ Extracts the requested date part as an integer value. ## Returns -An integer representing the extracted part. +Returns an integer representing the extracted part. > [!NOTE] > `week_of_year` returns an integer which represents the week number. The week number is calculated from the first week of a year, which is the one that includes the first Thursday. -## Example +## Examples + +The following example extracts the year, quarter, month, week of year, day, day of year, hour, minute, second, millisecond, microsecond, and nanosecond from a specified datetime value. :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/datetime-timespan-arithmetic.md b/data-explorer/kusto/query/datetime-timespan-arithmetic.md index d1f25e4576..60b124cf70 100644 --- a/data-explorer/kusto/query/datetime-timespan-arithmetic.md +++ b/data-explorer/kusto/query/datetime-timespan-arithmetic.md @@ -46,7 +46,7 @@ is a system for describing a point in time as the number of seconds that have el If your data includes representation of Unix time as an integer, or you require converting to it, the following functions are available. -### From Unix time +The following example converts Unix time to UTC datetime. :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] @@ -66,7 +66,7 @@ print result = fromUnixTime(1546897531) |---| | 2019-01-07 21:45:31.0000000 | -### To Unix time +The following example converts UTC datetime to Unix time. :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/datetime-utc-to-local-function.md b/data-explorer/kusto/query/datetime-utc-to-local-function.md index 0d298d7ba5..31080ce53d 100644 --- a/data-explorer/kusto/query/datetime-utc-to-local-function.md +++ b/data-explorer/kusto/query/datetime-utc-to-local-function.md @@ -26,9 +26,11 @@ Converts UTC [datetime](scalar-data-types/datetime.md) to local datetime using a ## Returns -A local datetime in the *timezone* that corresponds the UTC datetime. +Returns a local datetime in the *timezone* that corresponds the UTC datetime. -## Example +## Examples + +The following example shows how to convert a UTC datetime to local datetime. :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/day-of-month-function.md b/data-explorer/kusto/query/day-of-month-function.md index 4ff326bf77..cad8888348 100644 --- a/data-explorer/kusto/query/day-of-month-function.md +++ b/data-explorer/kusto/query/day-of-month-function.md @@ -9,7 +9,7 @@ ms.date: 08/11/2024 > [!INCLUDE [applies](../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../includes/applies-to-version/azure-data-explorer.md)] [!INCLUDE [monitor](../includes/applies-to-version/monitor.md)] [!INCLUDE [sentinel](../includes/applies-to-version/sentinel.md)] -Returns an integer representing the day number of the given datetime. +Provides the day of the month as an integer from a specified datetime value. ## Syntax @@ -25,9 +25,11 @@ Returns an integer representing the day number of the given datetime. ## Returns -An integer representing the day number of the given datetime. +Returns an integer representing the day number of the given datetime. + +## Examples -## Example +The following example shows how to extract the day of the month from a specified datetime value. :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/day-of-week-function.md b/data-explorer/kusto/query/day-of-week-function.md index aaaee95c2b..b4c1f50c95 100644 --- a/data-explorer/kusto/query/day-of-week-function.md +++ b/data-explorer/kusto/query/day-of-week-function.md @@ -9,7 +9,7 @@ ms.date: 08/11/2024 > [!INCLUDE [applies](../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../includes/applies-to-version/azure-data-explorer.md)] [!INCLUDE [monitor](../includes/applies-to-version/monitor.md)] [!INCLUDE [sentinel](../includes/applies-to-version/sentinel.md)] -Returns the number of days since the preceding Sunday, as a `timespan`. +Provides the number of days since the preceding Sunday, as a `timespan`. To convert `timespan` to `int`, see [Convert timespan to integer](#convert-timespan-to-integer). @@ -27,11 +27,11 @@ To convert `timespan` to `int`, see [Convert timespan to integer](#convert-times ## Returns -The `timespan` since midnight at the beginning of the preceding Sunday, rounded down to an integer number of days. +Returns the `timespan` since midnight at the beginning of the preceding Sunday, rounded down to an integer number of days. ## Examples -The following example returns 0, indicating that the specified datetime is a Sunday. +The follow example shows how to extract the day of the week from a specified datetime value. :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/day-of-year-function.md b/data-explorer/kusto/query/day-of-year-function.md index 8de64ca742..e535e274db 100644 --- a/data-explorer/kusto/query/day-of-year-function.md +++ b/data-explorer/kusto/query/day-of-year-function.md @@ -9,7 +9,7 @@ ms.date: 08/11/2024 > [!INCLUDE [applies](../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../includes/applies-to-version/azure-data-explorer.md)] [!INCLUDE [monitor](../includes/applies-to-version/monitor.md)] [!INCLUDE [sentinel](../includes/applies-to-version/sentinel.md)] -Returns the integer number represents the day number of the given year. +Provides the integer that represents the day of the year for a specified datetime value. ## Syntax @@ -27,7 +27,9 @@ Returns the integer number represents the day number of the given year. The day number of the given year. -## Example +## Examples + +The following example shows how to extract the day of the year from a specified datetime value. :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/dcount-aggregation-function.md b/data-explorer/kusto/query/dcount-aggregation-function.md index e650ff22f2..e877093042 100644 --- a/data-explorer/kusto/query/dcount-aggregation-function.md +++ b/data-explorer/kusto/query/dcount-aggregation-function.md @@ -35,9 +35,9 @@ Calculates an estimate of the number of distinct values that are taken by a scal Returns an estimate of the number of distinct values of *expr* in the group. -## Example +## Examples -This example shows how many types of storm events happened in each state. +The following example shows how many types of storm events happened in each state. :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/dcountif-aggregation-function.md b/data-explorer/kusto/query/dcountif-aggregation-function.md index a08b7c15f0..0cbc06a554 100644 --- a/data-explorer/kusto/query/dcountif-aggregation-function.md +++ b/data-explorer/kusto/query/dcountif-aggregation-function.md @@ -36,9 +36,9 @@ Returns an estimate of the number of distinct values of *expr* for rows in which > [!TIP] > `dcountif()` might return an error in cases where all, or none of the rows pass the `Predicate` expression. -## Example +## Examples -This example shows how many types of fatal storm events happened in each state. +The following example shows how many types of fatal storm events happened in each state. :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] diff --git a/data-explorer/kusto/query/degrees-function.md b/data-explorer/kusto/query/degrees-function.md index e84cc3de44..d28778f60e 100644 --- a/data-explorer/kusto/query/degrees-function.md +++ b/data-explorer/kusto/query/degrees-function.md @@ -25,10 +25,12 @@ Converts angle value in radians into value in degrees, using the formula `degree ## Returns -The corresponding angle in degrees for an angle specified in radians. +Returns the corresponding angle in degrees for an angle specified in radians. ## Examples +The following example shows how to convert radians to degrees. + :::moniker range="azure-data-explorer" > [!div class="nextstepaction"] > Run the query