Dátumf függvények ARM-sablonokhoz

Resource Manager a következő függvényeket biztosítja a dátumok az Azure Resource Manager sablonban (ARM-sablonban) való éhez:

dateTimeAdd (dátum/idő)

dateTimeAdd(base, duration, [format])

Hozzáad egy időidőt egy alapértékhez. Iso 8601 formátum várható.

Paraméterek

Paraméter Kötelező Típus Description
base Yes sztring Az összeadás kezdő dátum/idő értéke. Iso 8601 időbélyeg formátumot használjon.
duration Yes sztring Az alaphoz hozzáadnia kell az időértéket. Negatív érték is lehet. Iso 8601 időtartamformátumot használjon.
Formátum No sztring A dátum és idő eredményének kimeneti formátuma. Ha nincs megtéve, az alapérték formátuma lesz használva. Használjon szabványos vagy egyéni formázási sztringeket.

Visszatérési érték

Az időtartam értékének az alapértékhez való hozzáadásából származó datetime érték.

Példák

Az alábbi példasablon az időértékek hozzáadásának különböző módjait mutatja be.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "baseTime": {
      "type": "string",
      "defaultValue": "[utcNow('u')]"
    }
  },
  "variables": {
    "add3Years": "[dateTimeAdd(parameters('baseTime'), 'P3Y')]",
    "subtract9Days": "[dateTimeAdd(parameters('baseTime'), '-P9D')]",
    "add1Hour": "[dateTimeAdd(parameters('baseTime'), 'PT1H')]"
  },
  "resources": [],
  "outputs": {
    "add3YearsOutput": {
      "value": "[variables('add3Years')]",
      "type": "string"
    },
    "subtract9DaysOutput": {
      "value": "[variables('subtract9Days')]",
      "type": "string"
    },
    "add1HourOutput": {
      "value": "[variables('add1Hour')]",
      "type": "string"
    }
  }
}

A fenti sablon alapidővel való üzembe helyezésekor a 2020-04-07 14:53:14Z kimenet a következő:

Név Típus Érték
add3YearsOutput Sztring 2023.04.7., 14:53:14
subtract9DaysOutput (kivonás9DaysOutput) Sztring 2020.03.29., 14:53:14
add1HourOutput (hozzáadás1HourOutput) Sztring 2020.04.7., 15:53:14

A következő példasablon bemutatja, hogyan állíthatja be az Automation-ütemezés kezdési idejét.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "omsAutomationAccountName": {
      "type": "string",
      "defaultValue": "demoAutomation",
      "metadata": {
        "description": "Use an existing Automation account."
      }
    },
    "scheduleName": {
      "type": "string",
      "defaultValue": "demoSchedule1",
      "metadata": {
        "description": "Name of the new schedule."
      }
    },
    "baseTime": {
      "type": "string",
      "defaultValue": "[utcNow('u')]",
      "metadata": {
        "description": "Schedule will start one hour from this time."
      }
    }
  },
  "variables": {
    "startTime": "[dateTimeAdd(parameters('baseTime'), 'PT1H')]"
  },
  "resources": [
    ...
    {
      "type": "Microsoft.Automation/automationAccounts/schedules",
      "apiVersion": "2020-01-13-preview",
      "name": "[concat(parameters('omsAutomationAccountName'), '/', parameters('scheduleName'))]",

      "properties": {
        "description": "Demo Scheduler",
        "startTime": "[variables('startTime')]",
        "interval": 1,
        "frequency": "Hour"
      }
    }
  ],
  "outputs": {
  }
}

utcNow (utcNow)

utcNow(format)

Az aktuális (UTC) dátum/idő értéket adja vissza a megadott formátumban. Ha nincs megtéve formátum, a rendszer az ISO 8601 ( yyyyMMddTHHmmssZ ) formátumot használja. Ez a függvény csak egy paraméter alapértelmezett értékében használható.

Paraméterek

Paraméter Kötelező Típus Description
Formátum No sztring Az URI-kódolású érték, amely sztringgé konvertálható. Használjon szabványos vagy egyéni formázási sztringeket.

Megjegyzések

Ezt a függvényt csak egy kifejezésen belül használhatja egy paraméter alapértelmezett értékében. Ennek a függvénynek a sablonban máshol való használata hibát ad vissza. A függvény nem engedélyezett a sablon más részeiben, mert minden hívatkor más értéket ad vissza. Ugyanazon sablon ugyanazokkal a paraméterekkel való üzembe helyezése nem ad megbízhatóan azonos eredményeket.

Ha a hiba egy korábbi, sikeres üzembe helyezésre való visszaállítási beállítását használja, és a korábbi üzembe helyezés tartalmaz egy utcNow paramétert, a paraméter nem lesz újra kiértékelve. Ehelyett a korábbi üzemelő példány paraméterértékét a rendszer automatikusan újra felhasználja a visszaállítási környezetben.

Ügyeljen arra, hogy az alapértelmezett értékhez a utcNow függvényre támaszkodó sablont újra üzembe kell ásni. Amikor újra üzembe áll, és nem ad meg értéket a paraméterhez, a függvény újra ki lesz értékelve. Ha új helyett egy meglévő erőforrást szeretne frissíteni, adja meg a korábbi üzemelő példány paraméterértékét.

Visszatérési érték

Az aktuális UTC dátum/idő érték.

Példák

Az alábbi példasablon a datetime érték különböző formátumait mutatja be.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "utcValue": {
      "type": "string",
      "defaultValue": "[utcNow()]"
    },
    "utcShortValue": {
      "type": "string",
      "defaultValue": "[utcNow('d')]"
    },
    "utcCustomValue": {
      "type": "string",
      "defaultValue": "[utcNow('M d')]"
    }
  },
  "resources": [
  ],
  "outputs": {
    "utcOutput": {
      "type": "string",
      "value": "[parameters('utcValue')]"
    },
    "utcShortOutput": {
      "type": "string",
      "value": "[parameters('utcShortValue')]"
    },
    "utcCustomOutput": {
      "type": "string",
      "value": "[parameters('utcCustomValue')]"
    }
  }
}

Az előző példában látható kimenet minden üzemelő példány esetén eltérő, de a következő hasonló lesz:

Név Típus Érték
utcOutput (utcoutput) sztring 20190305T175318Z
utcShortOutput sztring 03/05/2019
utcCustomOutput sztring 3 5

A következő példa bemutatja, hogyan használhat egy értéket a függvényből címkeérték beállításakor.

{
  "$schema": "https://schema.management.azure.com/schemas/2018-05-01/subscriptionDeploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "utcShort": {
      "type": "string",
      "defaultValue": "[utcNow('d')]"
    },
    "rgName": {
      "type": "string"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Resources/resourceGroups",
      "apiVersion": "2021-04-01",
      "name": "[parameters('rgName')]",
      "location": "westeurope",
      "tags": {
        "createdDate": "[parameters('utcShort')]"
      },
      "properties": {}
    }
  ],
  "outputs": {
    "utcShortOutput": {
      "type": "string",
      "value": "[parameters('utcShort')]"
    }
  }
}

Következő lépések