Personalitzar o formatar valors de data i hora en un flux

Aquest article proporciona els passos per personalitzar o formatar els valors de data i hora en un flux. Power Automate

Quan treballeu amb valors de data i hora en un flux, és possible que el format de data i hora no sigui l'esperat o que vulgueu personalitzar el format de la sortida. Power Automate Podeu fer això passant cadenes de format a la funció formatDateTime .

Formatar data i hora

La formatDateTime() funció in Power Automate us permet manipular i formatar els valors de data i hora en diversos formats de visualització. També ofereix una manera fàcil de gestionar dades i temps en diferents fusos horaris.

La funció formatDateTime() accepta dos paràmetres:

  • Marca de temps: La marca de temps és el valor de data i hora que cal formatar.

    Pot ser una cadena manual o contingut dinàmic. Quan s'introdueix manualment, s'espera que la marca de temps segueixi el format ISO 8601 ("aaaa-MM-ddTHH:mm:ssZ").

  • Cadena de format: La cadena de format especifica el format de sortida per a la data i l'hora.

    El paràmetre de cadena de format de la funció formatDateTime() pot ser una cadena de format estàndard o una cadena de format personalitzada.

Cadenes de format estàndard

Una cadena de format estàndard utilitza un únic caràcter (per exemple, d, g o G) com a especificador de format.

Exemples

  • La cadena g de format correspon al patró de data/hora general (temps breu):

    formatDateTime('2009-06-15T13:45:30', 'g') // Retorna el format 6/15/2009 1:45 PM

  • La cadena de format D correspon al patró de data llarga:

    formatDateTime('2009-06-15T13:45:30', 'D') // Retorna el format dilluns, 15 de juny de 2009

Per obtenir més informació i exemples de l'ús de cadenes de format de data i hora estàndard, aneu a Cadenes de format de data i hora estàndard.

Cadenes de format personalitzades

Una cadena de format personalitzat és qualsevol cadena amb més d'un caràcter (per exemple, M/dd/yyyy h:mm tt) que pot controlar la visibilitat, la posició i la precisió del mes, dia, any, hora, segon, etc., del valor de data i hora.

Exemples

  • La cadena de format M/dd/yyyy h:mm tt representa el mateix patró que la cadena de format estàndard g tal com es descriu a Cadenes de format estàndard:

    formatDateTime('2009-06-15T13:45:30', 'M/dd/yyyy h:mm tt') // Retorna el format 6/15/2009 1:45 PM

  • La cadena de format HH:mm:ss tt retorna el format de 24 hores:

    formatDateTime('2009-06-15T13:45:30', 'M/dd/yyyy HH:mm:ss tt') // Retorna el format 6/15/2009 13:45:30 PM

  • La cadena de format hh:mm:ss tt retorna el format de 12 hores:

    formatDateTime('2009-06-15T13:45:30', 'yyyy/MM/dd hh:mm:ss tt') // Retorna el format 2009/06/15 1:45:30 PM

  • utcNow() funció utilitzada com a marca de temps per obtenir automàticament la data i hora actuals en UTC, i la cadena de format dd-MM-yyyy per mostrar la data i l'hora:

    formatDateTime(utcNow(), 'MMMM dd, yyyy, HH:mm') //Retorna la data i hora actuals en el format 15 de juny de 2009, 16:50

  • utcNow() funció utilitzada com a marca de temps per obtenir automàticament la data i hora actuals en UTC, i la cadena de format dd-MM-yyyy per mostrar la data però no l'hora:

    formatDateTime(utcNow(), 'dd-MM-yyyy') //Retorna la data actual en el format 15-06-2009

Per obtenir més informació i exemples de l'ús de cadenes de format de data i hora personalitzades, aneu a Cadenes de format de data i hora personalitzades.

Utilitza en un flux

Per utilitzar un valor de data i hora en un flux, seguiu aquests passos.

  1. Al flux, seleccioneu el camp d'entrada on voleu introduir el valor de data i hora amb format.

  2. Aneu a Afegeix contingut dinàmic i seleccioneu la pestanya Expressió per obrir l'editor d'expressions.

  3. Tipus formatDateTime().

    Alternativament, busqueu-ho a les funcions de *data i hora*.

  4. Proporcioneu el valor que s'ha de formatar, entre cometes simples.

    Es pot utilitzar contingut dinàmic, però no s'ha de posar entre cometes simples.

  5. Proporcioneu la cadena de format, envoltada de cometes simples.

  6. L'expressió completa hauria de ser semblant als exemples següents:

    • formatDateTime('<your-value>', 'dd/MM/yyyy hh:mm tt')
    • formatDateTime('<dynamic-value>', 'dd/MM/yyyy hh:mm tt')

    Captura de pantalla de l'enllaç Afegeix contingut dinàmic i la pestanya Expressió.

  7. Seleccioneu D'acord.

Exemple amb contingut dinàmic

Els continguts dinàmics són variables produïdes per desencadenants i accions dins d'un diagrama de flux. Permeten als usuaris seleccionar referències de camp de passos anteriors i escriure expressions.

Aquest exemple guia un flux senzill que demostra l'ús de la funció formatDateTime() amb contingut dinàmic. El disparador utilitzat en aquest exemple és un flux activat manualment que requereix l'entrada de l'usuari.

  1. Inicieu sessió a Power Automate.

  2. Configura el disparador per al flux. Aquest exemple utilitza Data com a entrada.

    1. Al panell de navegació esquerre, seleccioneu Crea>Flux de núvol instantani.

    2. Al camp Nom del flux , introduïu un nom per al flux.

    3. A la llista Trieu com activar aquest flux , seleccioneu Activa un flux manualment.

    4. Seleccioneu Crea.

    5. Seleccioneu la targeta Activa manualment una targeta de flux .

    6. A la pestanya Paramaters , seleccioneu + Afegeix una data d'entrada>.

    7. Al camp de la dreta, introduïu 2023-10-22.

      Captura de pantalla del format de data a la pestanya Paràmetres.

  3. Afegiu l'acció Envia un correu electrònic (v2).

    1. A sota de la targeta Activa manualment un flux , seleccioneu el signe més (+)Afegeix > una acció.

    2. Al camp Cerca , comenceu a escriure Envia un correu electrònic (v2) i seleccioneu-lo de la llista quan el vegeu.

    3. Seleccioneu el camp Cos del correu electrònic i, a continuació, seleccioneu fx (Insereix expressió).

    4. Seleccioneu Contingut dinàmic.

      El contingut dinàmic que es mostra aquí està relacionat amb l'activador. Vincula el desencadenant i les accions que s'han de prendre.

    5. Al camp que hi ha a sobre de Contingut dinàmic, comenceu a escriure formatDateTime i seleccioneu-lo al menú desplegable quan aparegui.

    6. Desplaceu-vos cap avall a la llista Contingut dinàmic i seleccioneu Data d'activació. Si no es mostra, selecciona "Veure'n més".

      El contingut dinàmic d'aquesta variable prové del camp de data del trigger.

    7. Proporcioneu la cadena de format (envoltada de cometes simples) en funció del format de sortida desitjat per a la data. En aquest exemple, s'utilitza el format MM/dd/aaaa.

      L'expressió completa té aquest aspecte:

      formatDateTime(triggerBody()?['date'], 'MM/dd/yyyy')

      Captura de pantalla de la funció formatDatTime utilitzant contingut dinàmic.

    8. Seleccioneu Afegeix.

  4. A la pestanya Paràmetres , inseriu un correu electrònic al camp Per a i un assumpte al camp Assumpte .

  5. Seleccioneu Desa.

  6. Després d'executar el flux, el correu electrònic rebut mostra la data en el format MM/dd/aaaa especificat.

Exemple amb Converteix fus horari

Power Automate utilitza el temps universal coordinat (UTC) per defecte. Per gestionar els valors de data i hora en altres zones horàries, podeu utilitzar-lo formatDateTime juntament amb la convertTimeZone funció.

Per exemple, per visualitzar l'hora actual en hora estàndard de l'est, podeu utilitzar la sintaxi següent:

formatDateTime(convertTimeZone(utcNow(), 'UTC', 'Eastern Standard Time'), 'yyyy-MM-dd HH:mm:ss') Retorna la data i hora ajustada per a l'hora estàndard de l'est

Per obtenir més informació sobre la funció de data i hora, seleccioneu els articles següents.