$dateformat

Gebruik: $dateformat(datum,[notatie],[datumnotatie])
Categorie: informatie
Geïmplementeerd: Picard 2.7

Beschrijving:

Retourneert de ingevoerde datum in de opgegeven notatie, gebaseerd op de gestandaardiseerde strftime-notatiecodes van Python. Als er geen notatie wordt opgegeven, wordt de datum geretourneerd als jaar-maand-dag (bijv. 2020-02-15).

Het ‘jaar’, de ‘maand’ en de ‘dag’ moeten als cijfer worden ingevoerd, maar kunnen worden gescheiden met een willekeurig teken dat geen cijfer is. De standaardnotatie voor de datum is jaar-maand-dag. Je kan dit veranderen door de datumnotatie op te geven.

Geldige opties voor datumnotatie zijn:

  • ymd: jaar, maand, dag (de standaardnotatie)

  • dmy: dag, maand, jaar

  • mdy: maand, dag, jaar

Als de datum of de notatie ongeldig is, wordt er een lege waarde geretourneerd. Als de datumnotatie niet geldig is, wordt de standaardnotatie (ymd) gebruikt.

Notitie

Speciale tekens, zoals ‘%’, ‘&’, ‘(’, ‘)’ en ‘\’ moeten worden uitgesloten, zoals in de voorbeelden hieronder is te zien.

Waarschuwing

Platformspecifieke notatiecodes kunnen het beste worden vermeden, zodat scripts op verschillende platformen kunnen worden gebruikt. Voorbeelden van platformspecifieke codes zijn het weghalen van toegevoegde nullen (zoals %-d en %-m op Linux of macOS en de equivalenten %#d en %#m op Windows); manieren op de lengte van elementen aan te geven (zoals %3Y) en een hangende ‘%’ aan het einde van de opgegeven notatie.

Voorbeelden:

De volgende instructies retourneren de aangegeven waarden:

$set(foo,07.21.2021)
$set(bar,mdy)
$set(format,\%Y.\%m.\%d)
$dateformat(%foo%,%format%,%bar%)     ==>  "2021.07.21"

$dateformat(2021 07 21)               ==>  "2021-07-21"
$dateformat(2021.07.21)               ==>  "2021-07-21"
$dateformat(2021-07-21)               ==>  "2021-07-21"
$dateformat(2021-7-21)                ==>  "2021-07-21"
$dateformat(2021-7-21,\%B \%d\, \%Y)  ==>  "July 21, 2021"

$dateformat(2021-07-21,,ymd)          ==>  "2021-07-21"
$dateformat(2021-07-21,,dmy)          ==>  ""
$dateformat(2021-07-21,,mdy)          ==>  ""
$dateformat(2021-July-21)             ==>  ""
$dateformat(2021)                     ==>  ""
$dateformat(2021-07)                  ==>  ""
$dateformat(,)                        ==>  ""