M365Con 2027 – gratis online conferentie · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Power Automate formatDateTime: syntaxis, opmaakreeksen en voorbeelden

By · · Updated

Power Automate formatDateTime uitgelegd: syntaxis, de opmaakreeksen die ertoe doen, tijdzones met convertTimeZone en de fouten achter verkeerde datums en tijden.

Automatically translated with AI from the original post. Read the English original

Power Automate formatDateTime zet een datum en tijd om in de tekst die je wilt. De syntaxis is formatDateTime(timestamp, format, locale), waarbij het format en de locale optioneel zijn en het resultaat een string is. Bijvoorbeeld: formatDateTime(utcNow(), 'dd-MM-yyyy') retourneert de huidige UTC-datum als dag, maand en jaar. Dit artikel is bedoeld voor wie flows bouwt en steeds weer datums tegenkomt zoals 2023-10-22T00:00:00Z in e-mails, bestandsnamen of SharePoint-kolommen. Het behandelt de syntaxis, de opmaakreeksen die je het vaakst gebruikt, de valkuil met tijdzones, een overzicht van veelgebruikte patronen en de fouten achter onjuiste resultaten.

Belangrijkste punten

  • De syntaxis is formatDateTime(timestamp, format, locale). Het format en de locale zijn optioneel, en het resultaat is altijd een string.
  • Zonder format retourneert de functie het ISO 8601 round-trip-patroon, bijvoorbeeld 2018-03-15T00:00:00.0000000.
  • Hoofdletters doen ertoe in opmaakreeksen: MM is de maand en mm is de minuut, en HH is een uur in de 24-uursklok terwijl hh een uur in de 12-uursklok is.
  • Power Automate werkt standaard in UTC. Converteer de tijdzone dus eerst met convertTimeZone of convertFromUtc en formatteer daarna het resultaat.
  • Zet getypte waarden en opmaakreeksen tussen enkele aanhalingstekens, maar zet dynamische inhoud nooit tussen enkele aanhalingstekens.

Hoe formatDateTime werkt

De functie neemt een timestamp en schrijft die om. Microsofts artikel over het opmaken van datum- en tijdwaarden in een flow beschrijft het eerste argument als de datum en tijd die je wilt opmaken. Je kunt die handmatig invoeren of uit dynamische inhoud halen. Getypte waarden horen in ISO 8601-vorm te staan, zoals 2009-06-15T13:45:30. Het tweede argument is de opmaakreeks. Eén teken is een standaard opmaakreeks. Meer dan één teken is een aangepaste opmaakreeks, die bepaalt waar en in welke precisie de maand, dag, jaar, uur, seconde enzovoort worden weergegeven.

Drie details uit Microsofts naslagwerk over workflow-expressies zijn het onthouden waard:

  • Het format is optioneel. Als je het weglaat, is het standaardpatroon o. Microsoft beschrijft dat als ISO 8601 met behoud van tijdzone-informatie. formatDateTime('03/15/2018') retourneert '2018-03-15T00:00:00.0000000'.
  • Een ongeldig format geeft een fout. De flowrun mislukt, dus een typefout in het patroon zie je terug in je runhistorie.
  • De locale is optioneel. Als je die weglaat, is het en-us. Een ongeldige locale geeft een fout. Zo krijg je maand- en dagnamen in een andere taal: formatDateTime('01/31/2016', 'dddd MMMM d', 'fr-fr') retourneert 'dimanche janvier 31', terwijl dezelfde aanroep zonder locale 'Sunday January 31' retourneert.

De retourwaarde is een string. Dat is in de praktijk belangrijk. Zodra je een datum opmaakt, heb je tekst, en dan gebruik je het resultaat niet meer voor datumberekeningen. Doe de berekening eerst met functies zoals addDays of addToTime, en maak de opmaak pas aan het eind. In Power Automate is de opgemaakte waarde meestal wat je in een e-mailhoofdtekst, een bestandsnaam of een tekstkolom zet.

Stap voor stap formatDateTime gebruiken in Power Automate

Het artikel van Microsoft beschrijft een duidelijke manier om de expressie in een flow in te voegen.

  1. Selecteer het invoerveld van je actie waar de opgemaakte waarde moet komen, bijvoorbeeld de Hoofdtekst van een actie Een e-mail verzenden (V2).
  2. Selecteer Dynamische inhoud toevoegen en open vervolgens het tabblad Expressie. In de flowontwerper zie je hiervoor de knop fx.
  3. Typ formatDateTime(, of zoek de functie op in de lijst met functies onder Datum en tijd.
  4. Voeg de waarde toe. Typ een vaste waarde tussen enkele aanhalingstekens, of kies dynamische inhoud. Zet geen enkele aanhalingstekens om dynamische inhoud.
  5. Voeg de opmaaktekenreeks toe tussen enkele aanhalingstekens, bijvoorbeeld 'MM/dd/yyyy'.
  6. Selecteer OK om de expressie in te voegen.

Het patroon op de pagina van Microsoft ziet er zo uit: formatDateTime('2023-10-22', 'dd/MM/yyyy hh:mm tt') voor een vaste waarde tussen aanhalingstekens, en dezelfde aanroep met een item uit de dynamische inhoud in plaats van de waarde tussen aanhalingstekens, zonder aanhalingstekens.

Het uitgewerkte voorbeeld in het artikel gebruikt een handmatig geactiveerde flow met een invoer Datum. De expressie is formatDateTime(triggerBody()?['date'], 'MM/dd/yyyy'). Met een datum van 2023-10-22 toont de e-mail de datum in de vorm MM/dd/yyyy.

Controleer een expressie liever eerst voordat je er een flow omheen bouwt. Gebruik daarvoor een actie Samenstellen met een vast tijdstempel tussen enkele aanhalingstekens, voer de flow uit en lees de uitvoer in de uitvoeringsgeschiedenis. Dat kost een minuut en voorkomt dat je een kapotte opmaak moet repareren in een flow die al echte e-mails verstuurt.

Opmaaktekenreeksen die je echt gaat gebruiken

Standaard-opmaaktekenreeksen bestaan uit één letter. Dit zijn de voorbeelden van Microsoft voor het tijdstempel 2009-06-15T13:45:30:

  • 'g' geeft 6/15/2009 1:45 PM, het algemene datum- en tijdpatroon met een korte tijd.
  • 'D' geeft Monday, June 15, 2009, het lange datumpatroon.

De .NET-documentatie noemt meer standaardletters. Voorbeelden met hetzelfde tijdstempel: 'd' geeft 6/15/2009, 't' geeft 1:45 PM, 'T' geeft 1:45:30 PM, 's' geeft de sorteerbare notatie 2009-06-15T13:45:30, en 'Y' geeft June 2009. De meeste van deze volgen de cultuurregels, dus dezelfde letter kan er bij een andere locale anders uitzien. De letters die overal hetzelfde blijven zijn o, r, s en u.

Eigen opmaaktekenreeksen geven je controle. Dit zijn de specificaties die voor flows belangrijk zijn:

  • yyyy is het jaartal met vier cijfers, en yy het jaartal met twee cijfers.
  • MM is de maand met voorloopnul, MMM de korte maandnaam en MMMM de volledige maandnaam. M is de maand zonder voorloopnul.
  • dd is de dag met voorloopnul, ddd de korte dagnaam en dddd de volledige dagnaam.
  • HH is het uur op een 24-uursklok, met voorloopnul. hh is het uur op een 12-uursklok, met voorloopnul.
  • mm is de minuut, ss de seconde en fff de milliseconden.
  • tt is AM of PM.

Volgens die tabel geeft formatDateTime('2009-06-15T13:45:30', 'yyyy-MM-dd') het resultaat 2009-06-15, en geeft 'hh:mm tt' het resultaat 01:45 PM. Het flowartikel van Microsoft toont ook formatDateTime(utcNow(), 'MMMM dd, yyyy, HH:mm'). Die geeft de huidige datum en tijd in UTC in het patroon June 15, 2009, 16:50, met een vaste voorbeelddatum.

Twee eigenaardigheden komen voort uit de .NET-regels. Ten eerste wordt een enkele letter altijd als standaardnotatie gelezen. Wil je één aangepaste notatiespecifier gebruiken, zet dan een procentteken ervoor, bijvoorbeeld '%d'. Ten tweede: om vaste tekst in een patroon in te voegen, escape je het teken met een backslash of zet je de tekst tussen aanhalingstekens. Andere tekens die geen specifiers zijn, worden ongewijzigd naar de uitvoer gekopieerd. De schuine streep en de dubbele punt worden vervangen door de scheidingstekens van de locale, wat je kan verrassen als je een andere locale doorgeeft.

Tijdzones: formatteer na het converteren

Power Automate gebruikt standaard UTC, en utcNow() geeft de huidige datum en tijd in UTC terug. Als je gebruikers in Berlijn of New York zitten, klopt de kloktijd in je e-mail niet, tenzij je die eerst converteert.

Het artikel van Microsoft combineert beide functies: formatDateTime(convertTimeZone(utcNow(), 'UTC', 'Eastern Standard Time'), 'yyyy-MM-dd HH:mm:ss'). De binnenste functie wijzigt de tijdzone, de buitenste formatteert het resultaat. De namen van tijdzones zijn de Windows-namen, zoals UTC, Pacific Standard Time en Eastern Standard Time. Voor andere regio's gebruik je de bijpassende Windows-tijdzonenaam uit de lijst van Microsoft.

De referentie van de workflow beschrijft ook convertFromUtc. Die functie neemt een UTC-tijdstempel en een doeltijdzone en geeft de geconverteerde tijd terug zonder de UTC-offset. Het voorbeeld: convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time') geeft "2018-01-01T00:00:00.0000000" terug. Er is ook convertToUtc, die de andere kant op werkt. En Power Automate heeft een actie Tijdzone converteren met de invoer Basistijd, Brontijdzone, Doeltijdzone en een optionele Indelingsreeks, als je een actie verkiest boven een expressie.

Als de invoer geen geldige ISO 8601 is, verwacht je een foutmelding zoals "The date time string must match ISO8601 format." Een datum die je als 15/03/2018 invoert, is een typische oorzaak. Voor datums die in een lokaal formaat binnenkomen, beschrijft de referentie parseDateTime met een locale en een indeling, bijvoorbeeld parseDateTime('21052019', 'fr-fr', 'ddMMyyyy'), wat '2019-05-21T00:00:00.0000000' oplevert. Parseer eerst, formatteer daarna.

Veelgemaakte fouten

  • Gebruik van mm voor de maand. Kleine letters mm zijn de minuten en MM is de maand. Een datum die als dd/mm/yyyy is geformatteerd, toont de minuten waar de maand moet staan.
  • HH combineren met tt. Het eigen voorbeeld van Microsoft 'M/dd/yyyy HH:mm:ss tt' levert 6/15/2009 13:45:30 PM op, en dat is tegenstrijdig. Gebruik hh met tt, of HH zonder tt.
  • Dynamische inhoud tussen aanhalingstekens zetten. Dynamische inhoud mag geen enkele aanhalingstekens bevatten, anders behandelt de flow de naam als gewone tekst.
  • De tijdzone vergeten. De standaard is UTC. Converteer voordat je formatteert.
  • Rekenen met het resultaat. De uitvoer is een tekenreeks. Bereken eerst, formatteer als laatste.
  • De voorbeelduitvoer van utcNow() voor waar aannemen. De datums in de documentatie zijn vaste voorbeelden. Jouw resultaat weerspiegelt de huidige tijd.
  • Een niet-ISO-datum doorgeven. Parseer deze eerst met een locale en een indeling.

Gerelateerde onderwerpen om verder te verkennen

  • Tijdzones converteren: het artikel van Microsoft over het converteren van tijdzones behandelt zowel de actie als de expressie.
  • Tijd optellen of aftrekken: addDays en addToTime accepteren dezelfde optionele indeling, zodat je in één aanroep kunt verschuiven en formatteren.
  • Lokale datumnotaties parseren: parseDateTime accepteert een locale en een indeling voor datums die niet als ISO 8601 binnenkomen.
  • De volledige functielijst: de referentie voor workflow-expressies documenteert elke datum- en tijdfunctie.
  • Alle aangepaste specificaties: op de pagina custom date and time format strings staat elke letter beschreven.

Volgende stap

Voor betrouwbare resultaten van formatDateTime in Power Automate begin je met een ISO 8601-datum, zet je de tijdzone om voordat je opmaakt, en test je het patroon in een actie Compose. Lees daarna het artikel van Microsoft over hoe je datum- en tijdwaarden in een flow aanpast of opmaakt, en houd een korte lijst bij van de patronen die je team het meest gebruikt.

Bronnen

Entities in this article

Power Automate

Related articles

RSS