Particularizarea sau formatarea valorile de tip dată și oră dintr-un flux

Acest articol oferă pași pentru personalizarea sau formatarea valorilor de dată și oră într-un flux Power Automate .

Când lucrați cu valori de dată și oră într-un flux, este posibil să constatați că formatul datei și orei nu este cel așteptat sau este posibil să doriți să personalizați formatul rezultatului. Power Automate Puteți face acest lucru prin transmiterea de șiruri de format către funcția formatDateTime .

Formatați data și ora

Funcția formatDateTime() în Power Automate vă permite să manipulați și să formatați valorile datei și orei în diverse formate de afișare. De asemenea, oferă o modalitate ușoară de a gestiona datele și timpul în diferite fusuri orare.

Funcția formatDateTime() acceptă doi parametri:

  • Timestamp: Timestamp-ul este valoarea datei și orei care trebuie formatată.

    Poate fi un șir manual sau conținut dinamic. Când este introdusă manual, se așteaptă ca marca temporală să respecte formatul ISO 8601 („aaaa-LL-zzTHH:mm:ssZ”).

  • Șir de format: Șirul de format specifică formatul de ieșire pentru dată și oră.

    Parametrul de format string al funcției formatDateTime() poate fi fie un șir de format standard, fie un șir de format personalizat.

Șiruri de caractere în format standard

Un șir de caractere de format standard folosește un singur caracter (de exemplu, d, g sau G) ca specificator de format.

Exemple

  • Șirul de format g corespunde modelului general de dată/oră (timp scurt):

    formatDateTime('2009-06-15T13:45:30', 'g') // Returnează formatul 6/15/2009 1:45 PM

  • Șirul de format D corespunde modelului Dată lungă:

    formatDateTime('2009-06-15T13:45:30', 'D') // Returnează formatul luni, 15 iunie 2009

Pentru mai multe informații și exemple de utilizare a șirurilor de format standard pentru dată și oră, accesați Șiruri de format standard pentru dată și oră.

Șiruri de format personalizate

Un șir de caractere cu format personalizat este orice șir de caractere cu mai multe caractere (de exemplu, M/dd/yyyy h:mm tt) care poate controla vizibilitatea, poziționarea și precizia valorii datei și orei pentru lună, zi, an, oră, oră etc.

Exemple

  • Șirul de format M/dd/yyyy h:mm tt reprezintă același model ca și șirul de format standard g așa cum este descris în Șiruri de format standard:

    formatDateTime('2009-06-15T13:45:30', 'M/dd/yyyy h:mm tt') // Returnează formatul 6/15/2009 1:45 PM

  • Șirul de format HH:mm:ss tt returnează formatul de 24 de ore:

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

  • Șirul de format hh:mm:ss tt returnează formatul de 12 ore:

    formatDateTime('2009-06-15T13:45:30', 'yyyy/MM/dd hh:mm:ss tt') // Returnează formatul 2009/06/15 1:45:30 PM

  • utcNow() funcția utilizată ca marcaj temporal pentru a prelua automat data și ora curente în UTC și șirul de format dd-MM-yyyy pentru a afișa data și ora:

    formatDateTime(utcNow(), 'MMMM dd, yyyy, HH:mm') //Returnează data și ora curente în formatul 15 iunie 2009, 16:50

  • utcNow() funcția utilizată ca marcaj temporal pentru a prelua automat data și ora curente în UTC și șirul de format dd-MM-yyyy pentru a afișa data, dar nu și ora:

    formatDateTime(utcNow(), 'dd-MM-yyyy') //Returnează data curentă în formatul 15-06-2009

Pentru mai multe informații și exemple de utilizare a șirurilor de format personalizate pentru dată și oră, accesați Șiruri de format personalizate pentru dată și oră.

Utilizați într-un flux

Pentru a utiliza o valoare de dată și oră într-un flux, urmați acești pași.

  1. În flux, selectați câmpul de introducere în care doriți să introduceți valoarea formatată a datei și orei.

  2. Accesați Adăugați conținut dinamic și selectați fila Expresie pentru a deschide editorul de expresii.

  3. Tip formatDateTime().

    Alternativ, căutați-l la secțiunea *Funcții de dată și oră*.

  4. Furnizați valoarea care va fi formatată, înconjurată de ghilimele simple.

    Conținutul dinamic poate fi folosit, dar nu ar trebui să fie înconjurat de ghilimele simple.

  5. Furnizați șirul de format, înconjurat de ghilimele simple.

  6. Expresia completă ar trebui să arate ca în următoarele exemple:

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

    Captură de ecran a linkului Adăugare conținut dinamic și a filei Expresie.

  7. Selectați OK.

Exemplu cu conținut dinamic

Conținutul dinamic este o variabilă produsă de declanșatoare și acțiuni dintr-o diagramă de flux. Acestea permit utilizatorilor să selecteze referințe de câmp din pașii anteriori și să scrie expresii.

Acest exemplu prezintă un flux simplu care demonstrează utilizarea funcției formatDateTime() cu conținut dinamic. Declanșatorul utilizat în acest exemplu este un flux declanșat manual care necesită intervenția utilizatorului.

  1. autentificați-vă Power Automate.

  2. Configurați declanșatorul pentru flux. Acest exemplu folosește Data ca intrare.

    1. În panoul de navigare din stânga, selectați Creați>Instant cloud flow.

    2. În câmpul Nume flux , introduceți un nume pentru fluxul dvs.

    3. În lista Alegeți cum se declanșează acest flux , selectați Declanșați manual un flux.

    4. Selectați Creați.

    5. Selectați cardul Declanșare manuală a unui flux .

    6. În fila Parametri , selectați + Adăugați o intrare>Dată.

    7. În câmpul din dreapta, introduceți 2023-10-22.

      Captură de ecran a formatului de dată din fila Parametri.

  3. Adăugați acțiunea Trimiteți un e-mail (v2) .

    1. Sub cardul Declanșare manuală a fluxului , selectați semnul plus (+) >Adăugați o acțiune.

    2. În câmpul Căutare , începeți să tastați Trimiteți un e-mail (v2) și selectați-l din listă când îl vedeți.

    3. Selectați câmpul Corp din e-mail, apoi selectați fx (Inserare expresie).

    4. Selectați Conținut dinamic.

      Conținutul dinamic afișat aici este legat de declanșator. Leagă declanșatorul și acțiunile care trebuie întreprinse.

    5. În câmpul de deasupra Conținut dinamic, începeți să tastați formatDateTime și selectați-l din meniul derulant când apare.

    6. Derulați în jos lista Conținut dinamic și selectați Data declanșatorului. Dacă nu apare, selectați Vezi mai multe.

      Conținutul dinamic al acestei variabile provine din câmpul de dată din declanșator.

    7. Furnizați șirul de format (înconjurat de ghilimele simple) în funcție de formatul de ieșire dorit pentru dată. În acest exemplu, se utilizează formatul zz/ll/aaaa.

      Expresia completă arată astfel:

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

      Captură de ecran a funcției formatDatTime care utilizează conținut dinamic.

    8. Selectați Adăugare.

  4. În fila Parametri , introduceți un e-mail în câmpul Către și un subiect în câmpul Subiect .

  5. Selectați Salvați.

  6. După rularea fluxului, e-mailul primit afișează data în formatul LL/zz/aaaa specificat.

Exemplu cu conversia fusului orar

Power Automate utilizează în mod implicit Timpul Universal Coordonat (UTC). Pentru a gestiona valorile datei și orei în alte fusuri orare, puteți utiliza formatDateTime împreună cu funcția convertTimeZone .

De exemplu, pentru a afișa ora curentă în ora standard a Estului, puteți utiliza următoarea sintaxă:

formatDateTime(convertTimeZone(utcNow(), 'UTC', 'Eastern Standard Time'), 'yyyy-MM-dd HH:mm:ss') // Returnează data și ora ajustate pentru ora standard estică

Pentru mai multe informații despre funcția dată și oră, selectați următoarele articole.