---
sourceDocument: Workflows de version Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/build-workflows

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Workflows de version Xanadu

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

# Fonctions de transformation de date et d'heure

# Fonctions de transformation de date et d'heure {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 minutes de lecture

Utilisez les fonctions de transformation de date et d'heure pour recalculer ou reformater les pastilles de données pour les valeurs date/heure.
Les fonctions de transformation de date et d'heure nécessitent une pastille de données d'entrée date/heure ou chaîne. Certaines fonctions prennent également en charge les pastilles de données de durée. Assurez-vous d'utiliser le [type de pastille de données](https://servicenow-prod.fluidtopics.net/q2AhkYwDpHzhPWvMpLsi~g "Les actions et les flux secondaires utilisent des variables pour stocker les données d’entrée et de sortie. Le type de données variable détermine le type de données qu’elle stocke et ses options de configuration avancées.") d'entrée correct lors de l'application des fonctions de transformation de date et d'heure. Si une fonction de transformation de date et d'heure est appliquée à un type de pastille de données inapproprié, les données ne sont pas transformées pendant l'exécution et la valeur d'entrée est renvoyée à la place. Pour plus d'informations sur la confirmation des valeurs d'exécution de votre flux, consultez [Tester un flux](https://servicenow-prod.fluidtopics.net/jYXAr_qJ00o0LsmFoUH8VA "Avant d’activer un flux pour que d’autres utilisateurs puissent y accéder, testez-le pour vous assurer qu’il fonctionne comme prévu.").  
Remarque :  
Les valeurs Date/heure d'exécution ne sont pas localisées et s'affichent dans le fuseau horaire UTC (Temps universel coordonné). Pour plus d'informations, voir Fuseaux horaires et [représentation des fuseaux horaires](https://support.servicenow.com/kb_view.do?sysparm_article=KB0594661).

## Ajouter une heure {#date-time-transform-functions__add-time}

Ajoute des jours, des heures, des minutes ou des secondes à une entrée Date/heure, Date, Date d'échéance ou Durée.  
{#date-time-transform-functions__table_elj_cdf_mkb__entry__3}

| Pilule de données d'entrée | Paramètres | Pilule de données de sortie |
|-|-|-|
| Date/Heure, Date, Date d'échéance ou Durée Remarque : Si l'entrée est une date ou une date d'échéance, la transformation crée une valeur Date/Heure complète à l'aide de valeurs horaires correspondant à heure 0, minute 0 et seconde 0. | Duration - Durée à ajouter en jours, heures, minutes et secondes | Date/Heure : valeur Date/Heure transformée après addition de la valeur spécifiée Duration |
[ ]

{#date-time-transform-functions__table_elj_cdf_mkb}  
Figure 1. Exemple

* Entrée : `2019-09-12 11:00:00`
* Durée : `3 heures`
* Sortie : `2019-09-12 14:00:00 `
{#date-time-transform-functions__ul_g5q_d5y_2jb}

## Soustraire l'heure {#date-time-transform-functions__subtract-time}

Soustrait les jours, heures, minutes et/ou secondes de Date/heure, Date, Date d'échéance ou Durée de l'entrée.  
{#date-time-transform-functions__table_lvd_jff_mkb__entry__3}

| Pilule de données d'entrée | Paramètres | Pilule de données de sortie |
|-|-|-|
| Date/Heure, Date, Date d'échéance ou Durée Remarque : Si l'entrée est une date ou une date d'échéance, la transformation crée une valeur Date/Heure complète à l'aide de valeurs horaires correspondant à heure 0, minute 0 et seconde 0. | Duration - Entrez un temps à soustraire en jours, heures, minutes et secondes | Date/Heure : valeur Date/Heure transformée après soustraction de la valeur spécifiée Duration |
[ ]

{#date-time-transform-functions__table_lvd_jff_mkb}  
Figure 2. Exemple

* Entrée : `2019-09-12 11:00:00`
* Durée : `2 jours, 1 heure, 5 minutes, 10 secondes`
* Sortie : `2019-09-10 09:54:50`
{#date-time-transform-functions__ul_mlj_4pz_2jb}

Dans cet exemple, le flux récupère un enregistrement d'élément de configuration CMDB à partir d'une instance distante. La fonction de transformation Soustraire le temps localise ensuite la valeur du champ Créé en soustrayant trois heures de la date/heure entrée.  
Figure 3. Localiser le fuseau horaire d'une valeur de champ

## Chaîne à date {#date-time-transform-functions__string-to-date}

Convertit la chaîne d'entrée en Date/heure.  
{#date-time-transform-functions__table_crn_5ff_mkb__entry__3}

| Pilule de données d'entrée | Paramètres | Pilule de données de sortie |
|-|-|-|
| Chaîne mise en forme comme spécifié dans le fichier Input Date Format | * Input Date Format : format date/heure ou date de la chaîne d'entrée * Custom Format - Date/heure valide ou format de date représenté sous forme de chaîne. Nécessaire uniquement si l'option Format personnalisé est sélectionnée comme .Input Date Format {#date-time-transform-functions__ul_e3c_grz_2jb} | Date/Heure |
[ ]

{#date-time-transform-functions__table_crn_5ff_mkb}  
Remarque :  
* Si la valeur Date/Heure de l'entrée Format personnalisé n'est pas complète, la transformation crée une valeur Date/Heure complète à l'aide des dates et valeurs par défaut. Dans ce cas, la transformation utilise par défaut l'année en cours, le mois en cours, le jour 1 du mois, heure 0, minute 0 et seconde 0. Par exemple, une valeur de pastille de données d'entrée Oct 2019 et un format de date personnalisé de MMM aaaa produisent une sortie de `2019-10-01 00:00:00`.
* Si vous utilisez un type de pastille de données incorrect ou un format personnalisé non valide, le flux s'annule pendant l'exécution.
{#date-time-transform-functions__ul_nfr_dnj_lkb}  
Figure 4. Exemple

* Entrée : `'1995-11-20'`
* Format de la date d'entrée : `Date ISO (2004-06-28)`
* Sortie : `1995-11-20 00:00:00`
{#date-time-transform-functions__ul_g3c_grz_2jb}

## Date à chaîne {#date-time-transform-functions__date-to-string}

Convertit l'entrée Date/heure, Date ou Date d'échéance en une chaîne. Sélectionnez un format de date pour l'entrée Date/Heure. Vous pouvez également saisir un format personnalisé pour l'entrée Date/Heure.  
{#date-time-transform-functions__table_pxn_5gf_mkb__entry__3}

| Pilule de données d'entrée | Paramètres | Pilule de données de sortie |
|-|-|-|
| Date/Heure, Date ou Date d'échéance | * Output Date Format - Date/heure ou format de date de la chaîne de sortie * Custom Format - Date/heure valide ou format de date représenté sous forme de chaîne. Obligatoire uniquement si vous sélectionnez Format personnalisé comme format de date. {#date-time-transform-functions__ul_sv5_3sz_2jb} | Chaîne mise en forme comme spécifié dans le fichier Output Date Format |
[ ]

{#date-time-transform-functions__table_pxn_5gf_mkb}  
Remarque :  
Si vous utilisez un type de pastille de données d'entrée incorrect ou un format personnalisé non valide, le flux s'annule pendant l'exécution.  
Figure 5. Exemple

* Entrée : `1969-12-31 14:23:57`
* Format de date de sortie : `Personnalisé (entrer ci-dessous)`
* Format personnalisé : `'On' MMM dd, yyyy 'at' hh :mm a`
* Sortie : `'Le 31 décembre 1969 à 14:23'`

{#date-time-transform-functions__ul_uv5_3sz_2jb}

Dans cet exemple, le flux récupère l'enregistrement d'un utilisateur \[sys_user\] à partir d'une base de données tierce. La fonction de transformation Date en chaîne convertit le format du champ Créé , puis consigne la date, l'heure et le nom associés à l'enregistrement.  
Figure 5. Concaténer une valeur date/heure avec une valeur de chaîne

## Formats de date personnalisés {#date-time-transform-functions__section_x2t_fzx_gjb}

Vous pouvez spécifier un format de date personnalisé avec une séquence de chaînes de modèle de date et d'heure spécifiques. Une chaîne de modèle se compose d'une ou plusieurs lettres majuscules et minuscules de A à Z. Tout texte entre guillemets est ignoré et copié dans la sortie date.  
{#date-time-transform-functions__tbl_custom-date-formats__entry__4}

| Chaîne | Description | Format de sortie | Exemple |
|-|-|-|-|
| G | Désignateur d'ère | Texte | ANNONCE |
| o | Année | Année | 2019; 19 |
| Y | Semaine de l'année | Année | 2019; 19 |
| M | Mois de l'année (dans la date) | Mois | Juillet; Juil; 07 |
| L | Mois de l'année (valeur autonome) | Mois | Juillet; Juil; 07 |
| w | Semaine de l'année | Numéro | 52 |
| W | Semaine du mois | Numéro | 1 |
| D | Jour de l'année | Numéro | 365 |
| j | Jour du mois | Numéro | 2 |
| F | Jour de la semaine du mois | Numéro | 3 |
| E | Nom du jour dans la semaine | Texte | Mercredi; Marier |
| u | Nombre de jours de la semaine | Numéro | 3 |
| a | matin ou après-midi | Texte | après-midi |
| H | Heure dans la journée de 0 à 23 | Numéro | 0 |
| k | Heure dans la journée de 1 à 24 | Numéro | 24 |
| K | Heure du matin ou de l'après-midi de 0h à 11h | Numéro | 0 |
| h | Heure du matin ou de l'après-midi de 13h à 12h | Numéro | 12 |
| m | Minute dans heure | Numéro | 59 |
| s | Seconde dans minute | Numéro | 1 |
| S | Milliseconde | Numéro | 500 |
| z | Fuseau horaire au format par défaut | Fuseau horaire au format par défaut | Heure normale du Pacifique ; PST |
| Z | Fuseau horaire au format RFC 822 | Fuseau horaire au format RFC 822 | -0800 |
| X | Fuseau horaire au format ISO 8601 | Fuseau horaire au format ISO 8601 | -08; -0800; -08:00 |
[ ]

{#date-time-transform-functions__tbl_custom-date-formats}

## Jour {#date-time-transform-functions__section_nsj_4s3_grb}

Récupère le composant jour à partir de la date/heure spécifiée.
{#date-time-transform-functions__table_cqp_vt3_grb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Date/Heure | Nombre entier : jour à partir de la date spécifiée. |
[ ]

{#date-time-transform-functions__table_cqp_vt3_grb}  
Figure 7. Exemple

* Entrée : `20/11/2021 13:06:12`
* Format de la date d'entrée : `Date ISO (2004-06-28) `
* Sortie : `20`
{#date-time-transform-functions__ul_wzn_dx3_grb}

## Heure {#date-time-transform-functions__section_zkc_by3_grb}

Récupère le composant de l'heure à partir de la date/l'heure spécifiée.
{#date-time-transform-functions__table_tw2_2y3_grb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Date/Heure | Nombre entier : heure à partir de la date spécifiée. |
[ ]

{#date-time-transform-functions__table_tw2_2y3_grb}  
Figure 8. Exemple

* Entrée : `20/11/2021 13:06:12`
* Format de la date d'entrée : `Date ISO (2004-06-28) `
* Sortie :`13`
{#date-time-transform-functions__ul_mb1_ly3_grb}

## Minute {#date-time-transform-functions__section_ybw_yy3_grb}

Récupère le composant de la minute à partir de la date/l'heure spécifiée.
{#date-time-transform-functions__table_bqh_kz3_grb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Date/Heure | Nombre entier : composant de la minute à partir de la date spécifiée. |
[ ]

{#date-time-transform-functions__table_bqh_kz3_grb}  
Figure 9. Exemple

* Entrée : `20/11/2021 13:06:12`
* Format de la date d'entrée : `Date ISO (2004-06-28) `
* Sortie : `06`
{#date-time-transform-functions__ul_rqq_dz3_grb}

## Deuxième {#date-time-transform-functions__section_bnn_pz3_grb}

Récupère le deuxième composant à partir de la date/heure spécifiée.
{#date-time-transform-functions__table_zbl_sz3_grb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Date/Heure | Nombre entier : deuxième composant à partir de la date spécifiée. |
[ ]

{#date-time-transform-functions__table_zbl_sz3_grb}  
Figure 10. Exemple

* Entrée : `20/11/2021 13:06:12`
* Format de la date d'entrée : `Date ISO (2004-06-28) `
* Sortie : `12`
{#date-time-transform-functions__ul_rgl_wbj_grb}

## Mois {#date-time-transform-functions__section_swr_jcj_grb}

Récupère le composant mois à partir de la date/heure spécifiée.
{#date-time-transform-functions__table_lh2_cdj_grb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Date/Heure | Nombre entier : composant du mois à partir de la date spécifiée. |
[ ]

{#date-time-transform-functions__table_lh2_cdj_grb}  
Figure 11. Exemple

* Entrée : `20/11/2021 13:06:12`
* Format de la date d'entrée : `Date ISO (2004-06-28) `
* Sortie : `11`
{#date-time-transform-functions__ul_csm_hdj_grb}

## Semaine {#date-time-transform-functions__section_ezm_ldj_grb}

Évalue le numéro de la semaine pour la date/l'heure spécifiée.
{#date-time-transform-functions__table_p3g_xdj_grb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Date/Heure | Nombre entier : numéro de semaine pour la date spécifiée. |
[ ]

{#date-time-transform-functions__table_p3g_xdj_grb} Figure 12. Exemple

* Entrée : `07/04/2021 12:01:12`
* Format de la date d'entrée : `Date ISO (2004-06-28) `
* Sortie : `15 `
{#date-time-transform-functions__ul_q4n_b2j_grb}

## Année {#date-time-transform-functions__section_ryv_32j_grb}

Récupère le composant année à partir de la date/heure spécifiée.{#date-time-transform-functions__table_uhb_l2j_grb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Date/Heure | Nombre entier : composant de l'année à partir de la date spécifiée. |
[ ]

{#date-time-transform-functions__table_uhb_l2j_grb}
Figure 13. Exemple

* Entrée : `07/04/2021 12:01:12`
* Format de la date d'entrée : `Date ISO (2004-06-28) `
* Sortie : `2021`
{#date-time-transform-functions__ul_i2t_42j_grb}

## Différence de date {#date-time-transform-functions__section_ahv_hfj_grb}

Évalue la différence de durée entre la date d'entrée spécifiée et la date du paramètre, puis ajoute la différence de durée à l'heure d'epoch (1970-01-01 00:00:00).
{#date-time-transform-functions__table_o3p_kfj_grb__entry__3}

| Pilule de données d'entrée | Paramètres | Pilule de données de sortie |
|-|-|-|
| Date/Heure, Date ou Date d'échéance | Date/Heure, Date ou Date d'échéance | Durée : différence de durée ajoutée à l'heure d'Epoch (1970-01-01 00:00:00). |
[ ]

{#date-time-transform-functions__table_o3p_kfj_grb} Figure 14. Exemple

* Entrée : `02/05/2021 09:10:12`
* Format de la date d'entrée : `Date ISO (2004-06-28) `
* Paramètres : `2021-04-07 06:02:23`
* Sortie : `1970-01-26 03:07:49`
{#date-time-transform-functions__ul_ppk_dgj_grb}

## Fin du mois {#date-time-transform-functions__section_ps1_kgj_grb}

Évalue le dernier jour du mois après avoir ajouté le nombre spécifié de mois à la date spécifiée.
{#date-time-transform-functions__table_rvl_rgj_grb__entry__3}

| Pilule de données d'entrée | Paramètres | Pilule de données de sortie |
|-|-|-|
| Date | Nombre de mois : mois à ajouter à la date spécifiée. | Nombre entier : dernier jour du mois après l'ajout du nombre de mois à la date d'entrée spécifiée. |
[ ]

{#date-time-transform-functions__table_rvl_rgj_grb} Figure 15. Exemple

* Entrée : `2021-11-20`
* Format de la date d'entrée : `Date ISO (2004-06-28) `
* Nombre de mois : `3`
* Sortie : `2022-02-28`
{#date-time-transform-functions__ul_i4t_3hj_grb}