Add GetCurrentDateTime, GetCurrentTicks, and GetCurrentTimestamp

Author: seesharprun

articles/cosmos-db/nosql/query/getcurrentdatetime.md

@@ -1,68 +1,52 @@
 ---
-title: GetCurrentDateTime in Azure Cosmos DB query language
-description: Learn about SQL system function GetCurrentDateTime in Azure Cosmos DB.
-author: seesharprun
+title: GetCurrentDateTime
+titleSuffix: Azure Cosmos DB for NoSQL
+description: An Azure Cosmos DB for NoSQL system function that returns an ISO 8601 date and time value.
+author: jcodella
+ms.author: jacodel
+ms.reviewer: sidandrews
 ms.service: cosmos-db
 ms.subservice: nosql
-ms.topic: conceptual
-ms.date: 02/03/2021
-ms.author: sidandrews
-ms.reviewer: jucocchi
-ms.custom: query-reference, ignite-2022
+ms.topic: reference
+ms.date: 07/19/2023
+ms.custom: query-reference
 ---
-# GetCurrentDateTime (Azure Cosmos DB)
+
+# GetCurrentDateTime (NoSQL query)
+
 [!INCLUDE[NoSQL](../../includes/appliesto-nosql.md)]
 
 Returns the current UTC (Coordinated Universal Time) date and time as an ISO 8601 string.
-  
+
 ## Syntax
-  
+
 ```sql
-GetCurrentDateTime ()
+GetCurrentDateTime()
 ```
 
 ## Return types
-  
-Returns the current UTC date and time ISO 8601 string value in the format `YYYY-MM-DDThh:mm:ss.fffffffZ` where:
-  
-|Format|Description|
-|-|-|
-|YYYY|four-digit year|
-|MM|two-digit month (01 = January, etc.)|
-|DD|two-digit day of month (01 through 31)|
-|T|signifier for beginning of time elements|
-|hh|two-digit hour (00 through 23)|
-|mm|two-digit minutes (00 through 59)|
-|ss|two-digit seconds (00 through 59)|
-|.fffffff|seven-digit fractional seconds|
-|Z|UTC (Coordinated Universal Time) designator|
-  
-  For more information on the ISO 8601 format, see [ISO_8601](https://en.wikipedia.org/wiki/ISO_8601)
 
-## Remarks
-
-GetCurrentDateTime() is a nondeterministic function. The result returned is UTC. Precision is 7 digits, with an accuracy of 100 nanoseconds.
+Returns the current UTC date and time string value in the **round-trip** (ISO 8601) format.
 
 > [!NOTE]
-> This system function will not utilize the index. If you need to compare values to the current time, obtain the current time before query execution and use that constant string value in the `WHERE` clause.
+> For more information on the round-trip format, see [.NET round-trip format](/dotnet/standard/base-types/standard-date-and-time-format-strings#the-round-trip-o-o-format-specifier). For more information on the ISO 8601 format, see [ISO 8601](https://wikipedia.org/wiki/ISO_8601).
 
 ## Examples
-  
-The following example shows how to get the current UTC Date Time using the GetCurrentDateTime() built-in function.
-  
-```sql
-SELECT GetCurrentDateTime() AS currentUtcDateTime
-```  
-  
- Here is an example result set.
-  
-```json
-[{
-  "currentUtcDateTime": "2019-05-03T20:36:17.1234567Z"
-}]  
-```  
+
+The following example shows how to get the current UTC date and time string.
+
+:::code language="sql" source="~/cosmos-db-nosql-query-samples/scripts/getcurrentdatetime/query.novalidate.sql" highlight="2":::  
+
+:::code language="json" source="~/cosmos-db-nosql-query-samples/scripts/getcurrentdatetime/result.novalidate.json":::
+
+## Remarks
+
+- This function is nondeterministic.
+- The result returned is UTC (Coordinated Universal Time) with precision of seven digits and an accuracy of 100 nanoseconds.
+- This function doesn't use the index.
+- If you need to compare values to the current time, obtain the current time before query execution and use that constant string value in the `WHERE` clause.
 
 ## Next steps
 
 - [System functions Azure Cosmos DB](system-functions.yml)
-- [Introduction to Azure Cosmos DB](../../introduction.md)
+- [`GetCurrentDateTimeStatic`](getcurrentdatetimestatic.md)

articles/cosmos-db/nosql/query/getcurrentdatetimestatic.md

@@ -29,7 +29,10 @@ GetCurrentDateTimeStatic()
 
 ## Return types
 
-Returns the current UTC date and time string value in the **round-trip** (ISO 8601) format. For more information on the round-trip format, see [.NET round-trip format](/dotnet/standard/base-types/standard-date-and-time-format-strings#the-round-trip-o-o-format-specifier). For more information on the ISO 8601 format, see [ISO 8601](https://wikipedia.org/wiki/ISO_8601).
+Returns the current UTC date and time string value in the **round-trip** (ISO 8601) format.
+
+> [!NOTE]
+> For more information on the round-trip format, see [.NET round-trip format](/dotnet/standard/base-types/standard-date-and-time-format-strings#the-round-trip-o-o-format-specifier). For more information on the ISO 8601 format, see [ISO 8601](https://wikipedia.org/wiki/ISO_8601).
 
 ## Examples
 
@@ -54,4 +57,4 @@ This function returns the same static date and time for items within the same pa
 ## See also
 
 - [System functions](system-functions.yml)
-- [`GetCurrentDateTime` (nonstatic)](getcurrentdatetime.md)
+- [`GetCurrentDateTime`](getcurrentdatetime.md)

articles/cosmos-db/nosql/query/getcurrentticks.md

@@ -1,54 +1,49 @@
 ---
-title: GetCurrentTicks in Azure Cosmos DB query language
-description: Learn about SQL system function GetCurrentTicks in Azure Cosmos DB.
-author: seesharprun
+title: GetCurrentTicks
+titleSuffix: Azure Cosmos DB for NoSQL
+description: An Azure Cosmos DB for NoSQL system function that returns a nanosecond ticks value.
+author: jcodella
+ms.author: jacodel
+ms.reviewer: sidandrews
 ms.service: cosmos-db
 ms.subservice: nosql
-ms.topic: conceptual
-ms.date: 02/03/2021
-ms.author: sidandrews
-ms.reviewer: jucocchi
-ms.custom: query-reference, ignite-2022
+ms.topic: reference
+ms.date: 07/19/2023
+ms.custom: query-reference
 ---
-# GetCurrentTicks (Azure Cosmos DB)
+
+# GetCurrentTicks (NoSQL query)
+
 [!INCLUDE[NoSQL](../../includes/appliesto-nosql.md)]
 
-Returns the number of 100-nanosecond ticks that have elapsed since 00:00:00 Thursday, 1 January 1970.
+Returns the number of 100-nanosecond ticks that have elapsed since `00:00:00 Thursday, 1 January 1970`.
 
 ## Syntax
 
 ```sql
-GetCurrentTicks ()
+GetCurrentTicks()
 ```
 
 ## Return types
 
-Returns a signed numeric value, the current number of 100-nanosecond ticks that have elapsed since the Unix epoch. In other words, GetCurrentTicks returns the number of 100 nanosecond ticks that have elapsed since 00:00:00 Thursday, 1 January 1970.
+Returns a signed numeric value that represents the current number of 100-nanosecond ticks that have elapsed since the Unix epoch (`00:00:00 Thursday, 1 January 1970`).
 
-## Remarks
-
-GetCurrentTicks() is a nondeterministic function. The result returned is UTC (Coordinated Universal Time).
+## Examples
 
-> [!NOTE]
-> This system function will not utilize the index. If you need to compare values to the current time, obtain the current time before query execution and use that constant string value in the `WHERE` clause.
+The following example returns the current time measured in ticks:
 
-## Examples
+:::code language="sql" source="~/cosmos-db-nosql-query-samples/scripts/getcurrentticks/query.novalidate.sql" highlight="2":::  
 
-Here's an example that returns the current time, measured in ticks:
+:::code language="json" source="~/cosmos-db-nosql-query-samples/scripts/getcurrentticks/result.novalidate.json":::
 
-```sql
-SELECT GetCurrentTicks() AS CurrentTimeInTicks
-```
+## Remarks
 
-```json
-[
-    {
-        "CurrentTimeInTicks": 15973607943002652
-    }
-]
-```
+- This function is nondeterministic.
+- The result returned is UTC (Coordinated Universal Time).
+- This function doesn't use the index.
+- If you need to compare values to the current time, obtain the current time before query execution and use that constant string value in the `WHERE` clause.
 
 ## Next steps
 
 - [System functions Azure Cosmos DB](system-functions.yml)
-- [Introduction to Azure Cosmos DB](../../introduction.md)
+- [`GetCurrentTicksStatic`](getcurrentticksstatic.md)

articles/cosmos-db/nosql/query/getcurrentticksstatic.md

@@ -54,4 +54,4 @@ This function returns the same static nanosecond ticks for items within the same
 ## See also
 
 - [System functions](system-functions.yml)
-- [`GetCurrentTicks` (nonstatic)](getcurrentticks.md)
+- [`GetCurrentTicks`](getcurrentticks.md)

articles/cosmos-db/nosql/query/getcurrenttimestamp.md

@@ -1,54 +1,49 @@
 ---
-title: GetCurrentTimestamp in Azure Cosmos DB query language
-description: Learn about SQL system function GetCurrentTimestamp in Azure Cosmos DB.
-author: seesharprun
+title: GetCurrentTimestamp
+titleSuffix: Azure Cosmos DB for NoSQL
+description: An Azure Cosmos DB for NoSQL system function that returns a timestamp value.
+author: jcodella
+ms.author: jacodel
+ms.reviewer: sidandrews
 ms.service: cosmos-db
 ms.subservice: nosql
-ms.topic: conceptual
-ms.date: 02/03/2021
-ms.author: sidandrews
-ms.reviewer: jucocchi
-ms.custom: query-reference, ignite-2022
+ms.topic: reference
+ms.date: 07/19/2023
+ms.custom: query-reference
 ---
-# GetCurrentTimestamp (Azure Cosmos DB)
+
+# GetCurrentTimestamp (NoSQL query)
+
 [!INCLUDE[NoSQL](../../includes/appliesto-nosql.md)]
 
- Returns the number of milliseconds that have elapsed since 00:00:00 Thursday, 1 January 1970.
-  
+Returns the number of milliseconds that have elapsed since `00:00:00 Thursday, 1 January 1970`.
+
 ## Syntax
-  
+
 ```sql
-GetCurrentTimestamp ()  
-```  
-  
+GetCurrentTimestamp()  
+```
+
 ## Return types
-  
-Returns a signed numeric value, the current number of milliseconds that have elapsed since the Unix epoch i.e. the number of milliseconds that have elapsed since 00:00:00 Thursday, 1 January 1970.
 
-## Remarks
+Returns a signed numeric value that represents the current number of milliseconds that have elapsed since the Unix epoch (`00:00:00 Thursday, 1 January 1970`).
 
-GetCurrentTimestamp() is a nondeterministic function. The result returned is UTC (Coordinated Universal Time).
+## Examples
 
-> [!NOTE]
-> This system function will not utilize the index. If you need to compare values to the current time, obtain the current time before query execution and use that constant string value in the `WHERE` clause.
+The following example shows how to get the current timestamp.
 
-## Examples
-  
-  The following example shows how to get the current timestamp using the GetCurrentTimestamp() built-in function.
-  
-```sql
-SELECT GetCurrentTimestamp() AS currentUtcTimestamp
-```  
-  
- Here is an example result set.
-  
-```json
-[{
-  "currentUtcTimestamp": 1556916469065
-}]  
-```
+:::code language="sql" source="~/cosmos-db-nosql-query-samples/scripts/getcurrenttimestamp/query.novalidate.sql" highlight="2":::  
+
+:::code language="json" source="~/cosmos-db-nosql-query-samples/scripts/getcurrenttimestamp/result.novalidate.json":::
+
+## Remarks
+
+- This function is nondeterministic.
+- The result returned is UTC (Coordinated Universal Time).
+- This function doesn't use the index.
+- If you need to compare values to the current time, obtain the current time before query execution and use that constant string value in the `WHERE` clause.
 
 ## Next steps
 
 - [System functions Azure Cosmos DB](system-functions.yml)
-- [Introduction to Azure Cosmos DB](../../introduction.md)
+- [`GetCurrentTimestampStatic`](getcurrenttimestampstatic.md)

articles/cosmos-db/nosql/query/getcurrenttimestampstatic.md

@@ -54,4 +54,4 @@ This function returns the same static timestamp for items within the same partit
 ## See also
 
 - [System functions](system-functions.yml)
-- [`GetCurrentTimestamp` (nonstatic)](getcurrenttimestamp.md)
+- [`GetCurrentTimestamp`](getcurrenttimestamp.md)