Merge pull request #196838 from tfitzmac/0502epoch2

Add epoch functions for json

Author: Court72

articles/azure-resource-manager/templates/template-functions-date.md

@@ -2,7 +2,7 @@
 title: Template functions - date
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) to work with dates.
 ms.topic: conceptual
-ms.date: 03/10/2022
+ms.date: 05/02/2022
 ---
 
 # Date functions for ARM templates
@@ -53,6 +53,122 @@ The next example template shows how to set the start time for an Automation sche
 
 :::code language="json" source="~/resourcemanager-templates/azure-resource-manager/functions/date/datetimeadd-automation.json":::
 
+## dateTimeFromEpoch
+
+`dateTimeFromEpoch(epochTime)`
+
+Converts an epoch time integer value to an ISO 8601 datetime.
+
+In Bicep, use the [dateTimeFromEpoch](../bicep/bicep-functions-date.md#datetimefromepoch) function.
+
+### Parameters
+
+| Parameter | Required | Type | Description |
+|:--- |:--- |:--- |:--- |
+| epochTime | Yes | int | The epoch time to convert to a datetime string. |
+
+### Return value
+
+An ISO 8601 datetime string.
+
+### Example
+
+The following example shows output values for the epoch time functions.
+
+```json
+{
+  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
+  "contentVersion": "1.0.0.0",
+  "parameters": {
+    "convertedEpoch": {
+      "type": "int",
+      "defaultValue": "[dateTimeToEpoch(dateTimeAdd(utcNow(), 'P1Y'))]"
+    }
+  },
+  "variables": {
+    "convertedDatetime": "[dateTimeFromEpoch(parameters('convertedEpoch'))]"
+  },
+  "resources": [],
+  "outputs": {
+    "epochValue": {
+      "type": "int",
+      "value": "[parameters('convertedEpoch')]"
+    },
+    "datetimeValue": {
+      "type": "string",
+      "value": "[variables('convertedDatetime')]"
+    }
+  }
+}
+```
+
+The output is:
+
+| Name | Type | Value |
+| ---- | ---- | ----- |
+| datetimeValue | String | 2023-05-02T15:16:13Z |
+| epochValue | Int | 1683040573 |
+
+## dateTimeToEpoch
+
+`dateTimeToEpoch(dateTime)`
+
+Converts an ISO 8601 datetime string to an epoch time integer value.
+
+In Bicep, use the [dateTimeToEpoch](../bicep/bicep-functions-date.md#datetimetoepoch) function.
+
+### Parameters
+
+| Parameter | Required | Type | Description |
+|:--- |:--- |:--- |:--- |
+| dateTime | Yes | string | The datetime string to convert to an epoch time. |
+
+### Return value
+
+An integer that represents the number of seconds from midnight on January 1, 1970.
+
+### Examples
+
+The following example shows output values for the epoch time functions.
+
+```json
+{
+  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
+  "contentVersion": "1.0.0.0",
+  "parameters": {
+    "convertedEpoch": {
+      "type": "int",
+      "defaultValue": "[dateTimeToEpoch(dateTimeAdd(utcNow(), 'P1Y'))]"
+    }
+  },
+  "variables": {
+    "convertedDatetime": "[dateTimeFromEpoch(parameters('convertedEpoch'))]"
+  },
+  "resources": [],
+  "outputs": {
+    "epochValue": {
+      "type": "int",
+      "value": "[parameters('convertedEpoch')]"
+    },
+    "datetimeValue": {
+      "type": "string",
+      "value": "[variables('convertedDatetime')]"
+    }
+  }
+}
+```
+
+The output is:
+
+| Name | Type | Value |
+| ---- | ---- | ----- |
+| datetimeValue | String | 2023-05-02T15:16:13Z |
+| epochValue | Int | 1683040573 |
+
+The next example uses the epoch time value to set the expiration for a key in a key vault.
+
+:::code language="json" source="~/quickstart-templates/quickstarts/microsoft.storage/storage-blob-encryption-with-cmk/azuredeploy.json":::
+
 ## utcNow
 
 `utcNow(format)`

articles/azure-resource-manager/templates/template-functions.md

@@ -2,7 +2,7 @@
 title: Template functions
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) to retrieve values, work with strings and numerics, and retrieve deployment information.
 ms.topic: conceptual
-ms.date: 04/12/2022
+ms.date: 05/02/2022
 ---
 
 # ARM template functions
@@ -85,6 +85,8 @@ For Bicep files, use the [coalesce](../bicep/operators-logical.md) logical opera
 Resource Manager provides the following functions for working with dates.
 
 * [dateTimeAdd](template-functions-date.md#datetimeadd)
+* [dateTimeFromEpoch](template-functions-date.md#datetimefromepoch)
+* [dateTimeToEpoch](template-functions-date.md#datetimetoepoch)
 * [utcNow](template-functions-date.md#utcnow)
 
 For Bicep files, use the [date](../bicep/bicep-functions-date.md) functions.